Forms

Submit final form answers.

All writes validate server-side. Invalid answers are stored as draft validation failures and return diagnostics without finalizing.

post/api/v1/forms/{formId}/submissions

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/forms/{formId}/submissions
  • Auth: HTTP bearer

Path parameters

formIdstring required

Form id or reference id.

Headers

X-Commentary-Workspace-Idstring

Must match the credential workspace. This header cannot widen grant authority.

X-Correlation-Idstring

Request body

valuesobject
sourceContextFormSourceContext

Embedded review context such as repository owner/repo plus prNumber or branchRef, draftReviewSessionId, filePath, documentVersionId, formInstanceId, and route.

submissionIdstring
submissionOrigin'api' | 'mcp' | 'cli' | 'agent_api'
agentAliasstring
clientNamestring

Response

Successful response.

okunknown

Changes

No recorded changes to this operation across all 1 revision of this API.