Forms · API Reference · Developers
List forms, submit and transition responses through the workflow state machine. Response actor UUIDs in `state_history` are never exposed — only an `is_self` boolean.
List forms, submit and transition responses through the workflow state machine. Response actor UUIDs in `state_history` are never exposed — only an `is_self` boolean.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/forms/ | List forms (flat array, no pagination) |
| GET | /v1/forms/{uuid}/ | Retrieve a form |
| GET | /v1/forms/{uuid}/responses/ | List form responses (caller-scoped) |
| POST | /v1/forms/{uuid}/responses/ | Submit a form response |
| GET | /v1/forms/{uuid}/responses/{response_uuid}/ | Retrieve a form response |
| PATCH | /v1/forms/{uuid}/responses/{response_uuid}/ | Update a form response |
| DELETE | /v1/forms/{uuid}/responses/{response_uuid}/ | Delete a form response |
| POST | /v1/forms/{uuid}/responses/{response_uuid}/transition/ | Transition a form response state |
List forms (flat array, no pagination)
Returns a flat array of forms the caller can access. Not paginated.
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| include | string | Optional | Set to "questions" to expand full question tree. |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/forms/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Retrieve a form
Retrieve a form
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
List form responses (caller-scoped)
Paginated list of the caller’s form responses. Actor UUIDs in state_history are never exposed - only is_self boolean.
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Submit a form response
Submit a form response
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/forms/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Retrieve a form response
Retrieve a form response
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| response_uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Update a form response
Update a form response
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| response_uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
Code samples
curl -sS -X PATCH 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Delete a form response
Delete a form response
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| response_uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Code samples
curl -sS -X DELETE 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Transition a form response state
Runs the state machine transition. Body: to_state, optional note.
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| response_uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
| 409 | State-machine conflict |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/transition/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.