Error

A valid request URL is required to generate request examples

{
  "data": {
    "survey_id": "<string>",
    "revision": 123,
    "platform": "questra",
    "source": "<string>",
    "user_id": "60000000-0000-4000-8000-000000000001",
    "message": "Reprogrammed after questionnaire clarifications",
    "change_source": "manual",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

Content

Create a new content revision

When the survey is linked to an upstream platform survey, pushes source there first; tip is written only after a successful push (or when there is no link). After a successful push, re-GETs upstream and persists that document (pull-after-push) so reformatting does not look like drift. Without force, returns 409 save_blocked listing every current warning (stale tip and/or live simulation crawl). force: true skips those guards. When message is omitted, the server drafts a revision note from the previous tip.

PUT

/

surveys

/

{surveyId}

/

content

Error

A valid request URL is required to generate request examples

{
  "data": {
    "survey_id": "<string>",
    "revision": 123,
    "platform": "questra",
    "source": "<string>",
    "user_id": "60000000-0000-4000-8000-000000000001",
    "message": "Reprogrammed after questionnaire clarifications",
    "change_source": "manual",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "slug": "<string>",
  "file_id": "<string>",
  "endpoint_id": "<string>",
  "event_id": "<string>",
  "delivery_id": "<string>",
  "api_key_id": "<string>",
  "integration_id": "<string>",
  "audit_id": "<string>",
  "status": "<string>",
  "details": "<unknown>",
  "question_ids": [
    "<string>"
  ],
  "survey_ids": [
    "<string>"
  ],
  "revisions": [
    123
  ]
}

Path Parameters

surveyId

string<uuid>

required

Body

application/json

source

string

required

Minimum string length: 1

platform

enum<string>

Available options:

questra,

decipher,

confirmit,

qualtrics,

alchemer

message

string | null

Optional reason or commit note. Stored as null when omitted.

change_source

enum<string>

Client provenance for this write. Defaults to manual. Use agent when Review agent / content-edit saves.

Available options:

manual,

agent

base_revision

integer

Client pin of the tip revision this save is based on. When set and the tip has moved, PUT returns 409 save_blocked unless force is true.

force

boolean

When true, proceed despite a stale tip and/or a live simulation crawl. Set only after the user confirms Save anyway on a 409 save_blocked dialog.

Response

Revision created

data

object

required

Show child attributes