Skip to main content
PUT
/
open
/
forms
/
{id}
/
submissions
/
{submission_id}
Update Submission
curl --request PUT \
  --url https://api.opnform.com/open/forms/{id}/submissions/{submission_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "id": 123,
  "form_id": 123,
  "completion_time": 123,
  "data": {}
}

​
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

PUT /open/forms/{id}/submissions/{submission_id} HTTP/1.1
Host: api.opnform.com
Content-Type: application/json
Authorization: Bearer <token>

​
Path Parameters

ParameterTypeDescription
idnumberID of the parent form.
submission_idnumberID of the submission you want to update.

​
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:
FieldTypeDescription
completion_timeintegerOptional; total time in seconds.
Example (updating two answers): 
{
  "field_name": "Alice",
  "field_email": "[email protected]",
  "completion_time": 125
}

​
Response

200 OK – Returns the updated Submission object plus a success message. 
{
  "message": "Record successfully updated.",
  "data": {
    "submission_id": 17,
    "form_id": 99,
    "submitted_at": "2024-06-12T10:11:12Z",
    "data": {
      "field_name": "Alice",
      "field_email": "[email protected]"
    }
  }
}
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

Unique submission ID

​
form_id
number

ID of the parent form

​
completion_time
number | null

Time taken to complete the form in seconds

​
data
object

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