TrieOH
InformdAPISteps

Bulk-edit a form's steps

Replaces the full step list of the form in one call — each entry carries its `id` (existing steps are updated) plus title, description, and position hint. The actor must be an admin or owner of the form.

PUT/forms/{form_id}/steps

Replaces the full step list of the form in one call — each entry carries its id (existing steps are updated) plus title, description, and position hint. The actor must be an admin or owner of the form.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT issued by IdentityX, signed with Ed25519

In: header

Path Parameters

form_id*string

Form ID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[index: integer]?

Entry for bulk step editing. Mirrors models.UpdateStepRequest.

Response Body

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PUT "https://example.com/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08/steps" \  -H "Content-Type: application/json" \  -d '[    {      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",      "title": "Personal Info",      "description": "Tell us about yourself.",      "position_hint": 1    },    {      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa7",      "title": "Preferences",      "description": "Tell us what you like.",      "position_hint": 2    }  ]'
Empty
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 400,
  "title": "Validation Failed"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 401,
  "title": "Unauthenticated"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 403,
  "title": "Insufficient Role"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 404,
  "title": "Not Found"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 500,
  "title": "Internal Server Error"
}