# Commentary Forms API

**Canonical:** https://apis.io/apis/commentary-dev/commentary-dev-forms-api/  
**Provider:** Commentary — https://apis.io/providers/commentary-dev/  
**Base URL:** https://commentary.dev  
**Documentation:** https://commentary.dev/docs/reference

Commentary Forms API is one of 27 APIs that [Commentary](https://apis.io/providers/commentary-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Forms. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 6 JSON Schemas.

The Forms API from Commentary — 15 operation(s) for forms.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/forms` | List owned forms and visible result collections for the account-scoped token… |
| POST | `/api/v1/forms` | Reject standalone Forms API creation |
| POST | `/api/v1/forms/validate` | Validate a literal Form Contract v1 payload without persisting it |
| GET | `/api/v1/forms/embedded-answers` | List embedded review form answers for an authorized result context |
| GET | `/api/v1/forms/fillout-links` | List response links owned by the account-scoped token principal |
| POST | `/api/v1/forms/fillout-links` | Create a response link from an accessible source-backed form |
| POST | `/api/v1/forms/fillout-links/submit` | Submit answers through a response link |
| DELETE | `/api/v1/forms/fillout-links/{linkId}` | Revoke a response link owned by the account-scoped token principal |
| GET | `/api/v1/forms/fillout-links/{linkId}/results` | List result submissions owned by a response link |
| GET | `/api/v1/forms/{formId}` | Get a form contract and metadata |
| PATCH | `/api/v1/forms/{formId}` | Reject standalone Forms API editing |
| GET | `/api/v1/forms/{formId}/destinations` | List form destinations and read-only write-back status |
| GET | `/api/v1/forms/{formId}/destinations/writeback` | Inspect optional GitHub writeback availability for a form target |
| POST | `/api/v1/forms/{formId}/destinations/writeback` | Explicitly write a form definition or final submission batch to GitHub through… |
| GET | `/api/v1/forms/{formId}/git-results` | List canonical git-hosted result files for a source-backed form |
| POST | `/api/v1/forms/{formId}/git-results` | Preview result writeback or explicitly import canonical git-hosted result files |
| GET | `/api/v1/forms/{formId}/submissions` | List submissions for a permitted result collection |
| POST | `/api/v1/forms/{formId}/submissions` | Submit final form answers |
| GET | `/api/v1/forms/{formId}/submissions/events` | Stream final form submission events using Server-Sent Events |
| POST | `/api/v1/forms/{formId}/submissions/validate` | Validate form answers against the current form contract without storing a… |
| GET | `/api/v1/forms/{formId}/submissions/{submissionId}` | Read or export one form submission including raw values for an authorized… |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/commentary-dev/openapi/commentary-dev-forms-api-openapi.yml
- **Documentation** — https://commentary.dev/docs/build
- **APIReference** — https://commentary.dev/docs/reference
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-submission-schema.json
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-git-results-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-record-schema.json
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-contract-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-submission-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-form-contract-schema.json

## Other Commentary APIs (12)

- [Commentary Agents API](https://apis.io/apis/commentary-dev/commentary-dev-agents-api/)
- [Commentary Authentication API](https://apis.io/apis/commentary-dev/commentary-dev-authentication-api/)
- [Commentary Draft reviews API](https://apis.io/apis/commentary-dev/commentary-dev-draft-reviews-api/)
- [Commentary GitHub API](https://apis.io/apis/commentary-dev/commentary-dev-github-api/)
- [Commentary Health API](https://apis.io/apis/commentary-dev/commentary-dev-health-api/)
- [Commentary Inbox API](https://apis.io/apis/commentary-dev/commentary-dev-inbox-api/)
- [Commentary Interactions API](https://apis.io/apis/commentary-dev/commentary-dev-interactions-api/)
- [Commentary Knowledge Brain API](https://apis.io/apis/commentary-dev/commentary-dev-knowledge-brain-api/)
- [Commentary MCP API](https://apis.io/apis/commentary-dev/commentary-dev-mcp-api/)
- [Commentary Package uploads API](https://apis.io/apis/commentary-dev/commentary-dev-package-uploads-api/)
- [Commentary Project evidence API](https://apis.io/apis/commentary-dev/commentary-dev-project-evidence-api/)
- [Commentary Projects API](https://apis.io/apis/commentary-dev/commentary-dev-projects-api/)

## Tags

Forms

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/commentary-dev/commentary-dev-forms-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/commentary-dev/.