{"openapi":"3.1.0","info":{"title":"AgentForms API","version":"2026-08-21","description":"The versioned API used by AgentForms web and official CLI. Agent credentials cannot publish forms or submit responses."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"guestToken":{"type":"apiKey","in":"header","name":"x-agentforms-guest"}}},"paths":{"/public/forms/{formId}":{"get":{"summary":"Read a published form manifest"}},"/public/forms/{formId}/response-drafts":{"post":{"summary":"Create an unsubmitted response draft"}},"/response-drafts/{responseId}":{"get":{"summary":"Read a private response draft","security":[{"bearerAuth":[]}]},"patch":{"summary":"Prepare response answers","security":[{"bearerAuth":[]}]}},"/forms":{"get":{"summary":"List creator forms","security":[{"bearerAuth":[]}]},"post":{"summary":"Create a private form draft"}},"/forms/{formId}":{"get":{"summary":"Read a creator form"},"patch":{"summary":"Update a creator form with optimistic revision control"}},"/forms/{formId}/preview":{"post":{"summary":"Preview an exact draft revision"}},"/forms/{formId}/publish":{"post":{"summary":"Human/account-authorized publish after preview","security":[{"bearerAuth":[]}]}}}}