Sign in
forms

Update Values for the specified Form

Atomically sets or clears a partial batch of standard Form Values. Omitted Fields remain unchanged. Formatted-text input is canonicalized. By default, unresolved tracked changes reject the batch; callers can explicitly discard them with tracked_changes_policy DISCARD.

patch/v1/forms/{uuid}/values

Path parameters

uuidstring uuid required

The UUID of the attached Form whose Values to update

Request body

tracked_changes_policy'FAIL' | 'DISCARD'

Controls unresolved tracked changes on targeted Values. Defaults to FAIL when omitted. FAIL rejects the entire batch. DISCARD rejects unresolved suggestions atomically before replacing the Values.

Example request

{
  "values": [
    {
      "field_uuid": "82de76c4-964b-4519-94cf-7ce6b6d409f7",
      "value": "Client acceptance response"
    }
  ]
}

Response

The canonical committed Values in request order

Example response

{
  "data": [
    {
      "value": "Client acceptance response",
      "file_uuid": "7d50d252-be0c-4d69-b77a-5bbdfef83f55",
      "created_at": "2026-02-01T12:30:00.000Z",
      "updated_at": "2026-03-10T12:30:00.000Z",
      "field_uuid": "82de76c4-964b-4519-94cf-7ce6b6d409f7"
    }
  ]
}

Changes