transitionFormRecord
POST
/api/v1/data-sources/{id}/records/{recordId}/transitions
Moves a record to a new workflow state, enforcing the configured transition, per-form capability and record ownership, optimistic concurrency (version), and required-field completeness (including required images, satisfied only by a bound attachment) before any submit transition or any transition into an output-eligible state. A note is recorded as a comment; a transition that requires a note (the default changes_requested path, derived from the workflow) is rejected with 422 when the note is empty. A 409 means the record changed; reload, preserving any unsent note.
Responses
Section titled “ Responses ”Record after the transition
Version conflict
Illegal transition or incomplete required fields