Forms

Manage forms — create, update, publish, and delete forms in your workspace.

Endpoints

GET/api/v1/forms

List forms — Returns all forms in the workspace, sorted by most recently updated.

Required scope:read:forms

POST/api/v1/forms

Create a form — Creates a new form in draft status.

Required scope:write:forms

GET/api/v1/forms/{id}

Get a form — Returns the form with all sections and questions.

Required scope:read:forms

PUT/api/v1/forms/{id}

Update a form — Update title, description, or status.

Required scope:write:forms

DELETE/api/v1/forms/{id}

Delete a form — Soft-deletes by default. Add ?permanent=true to permanently delete.

Required scope:delete:forms

This page is auto-generated from the OpenAPI spec. Run npm run docs:generate to update.