Skip to content

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étodoEndpointDescriçã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
GET/v1/forms/

List forms (flat array, no pagination)

Chave de APICLI somente leituradefault

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

NomeTipoObrigatórioDescrição
includestringOpcionalSet to "questions" to expand full question tree.

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - 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.

GET/v1/forms/{uuid}/

Retrieve a form

Chave de APICLI somente leituradefault

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not 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.

GET/v1/forms/{uuid}/responses/

List form responses (caller-scoped)

Chave de APICLI somente leituradefaultPaginação por número de página

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - 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.

POST/v1/forms/{uuid}/responses/

Submit a form response

Chave de APICLI escritaform_responses

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not 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.

GET/v1/forms/{uuid}/responses/{response_uuid}/

Retrieve a form response

Chave de APICLI somente leituradefault

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório
response_uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not 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.

PATCH/v1/forms/{uuid}/responses/{response_uuid}/

Update a form response

Chave de APICLI escritaform_responses

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório
response_uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not 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/v1/forms/{uuid}/responses/{response_uuid}/

Delete a form response

Chave de APICLI escritadefault

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório
response_uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not 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.

POST/v1/forms/{uuid}/responses/{response_uuid}/transition/

Transition a form response state

Chave de APICLI escritadefault

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

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório
response_uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not found or not visible
409State-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.