Skip to main content
PUT
Update Submission

Update Submission

Modify an existing submission’s answers. This endpoint is useful when you want to correct values or enrich a submission after it was created.

Authentication & Scope

Requires forms-write ability.

Request

Path Parameters

Body Parameters

The payload should be an object whose keys correspond to the field IDs in the form definition. You only need to send the fields you intend to change. Other special meta-fields: Example (updating two answers):

Response

200 OK – Returns the updated Submission object plus a success message.
403 Forbidden – Token lacks forms-write or you do not have permission.

Authorizations

Authorization
string
header
required

Personal Access Token

Path Parameters

id
number
required
submission_id
number
required

Body

application/json

The body is of type object.

Response

Updated

id
number
read-only

Unique submission ID

form_id
number
read-only

ID of the parent form

completion_time
number | null
read-only

Time taken to complete the form in seconds

data
object
read-only

Contains form field responses plus metadata (status, created_at, id)