Form endpoints operate on forms owned by the authenticated API key's account.
List forms
GET /api/developer/forms?published=true&search=intake&page=1&page_size=25Query parameters are optional. page defaults to 1,page_size defaults to 25 and can be at most 100,published accepts true or false, andsearch is capped at 200 characters.
Create a form
POST /api/developer/forms
Content-Type: application/json
{
"title": "Client intake",
"description": "New project request",
"published": false,
"tags": ["intake"],
"questions": [],
"settings": {}
}Read and update
| Method | Path | Behavior |
|---|---|---|
GET | /api/developer/forms/:formId | Returns a form. { form } |
PATCH | /api/developer/forms/:formId | Updates at least one form field. { form } |
DELETE | /api/developer/forms/:formId | Moves a form to recoverable trash for 30 days. 204 |
Publish actions
| Method | Path | Behavior |
|---|---|---|
POST | /api/developer/forms/:formId/duplicate | Creates an unpublished copy. 201 { form } |
POST | /api/developer/forms/:formId/publish | Publishes a form. { form } |
POST | /api/developer/forms/:formId/unpublish | Unpublishes a form. { form } |