Formulários · API Reference · Developers
Liste formulários, envie respostas e transite estados na máquina de fluxo. Os UUIDs dos atores em `state_history` nunca são expostos — apenas um booleano `is_self`.
Liste formulários, envie respostas e transite estados na máquina de fluxo. Os UUIDs dos atores em `state_history` nunca são expostos — apenas um booleano `is_self`.
| Método | Endpoint | Descrição |
|---|---|---|
| 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.
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| include | string | Opcional | Set to "questions" to expand full question tree. |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/forms/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Retrieve a form
Retrieve a form
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
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.
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Submit a form response
Submit a form response
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 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 |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/forms/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Retrieve a form response
Retrieve a form response
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
| response_uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Update a form response
Update a form response
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
| response_uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 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 |
Exemplos de código
curl -sS -X PATCH 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Delete a form response
Delete a form response
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
| response_uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Exemplos de código
curl -sS -X DELETE 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Transition a form response state
Runs the state machine transition. Body: to_state, optional note.
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
| response_uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 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 |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/forms/{uuid}/responses/{response_uuid}/transition/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.