# FormSubmission

Fields, types, and constraints for FormSubmission.

Canonical: https://commentary.dev/docs/reference/schemas/form-submission

Released API schema for `FormSubmission`.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No |  |
| `formId` | string | No |  |
| `formVersionId` | string | No |  |
| `status` | `"draft"` · `"final"` · `"replaced"` · `"voided"` | No |  |
| `validationResult` | object | No |  |
| `values` | object | No | Raw submitted values. Requires commentary.forms.read. |
| `sourceContext` | [FormSourceContext](/docs/reference/schemas/form-source-context) | No |  |
| `sourceContextSummary` | object | No |  |
| `submissionOrigin` | `"web"` · `"api"` · `"mcp"` · `"cli"` · `"agent_api"` | No |  |
| `submitterViewerId` | string or null | No |  |
| `submitterLogin` | string or null | No |  |
| `agentAlias` | string or null | No |  |
| `clientName` | string or null | No |  |
| `createdAt` | string | No | Format: date-time. |
| `updatedAt` | string | No | Format: date-time. |
| `submittedAt` | string or null | No | Format: date-time. |

## Full schema

[Download this schema](/docs/reference/schemas/form-submission.json) or use the [complete OpenAPI document](/docs/reference/openapi.json) to resolve all references.

## Related reference

[Browse API endpoints](/docs/reference/api-operations).