Execuções

Cada chamada a POST /v1/chat/completions cria uma execução. O id da resposta é o id da execução.

GET /v1/requests/:id

Consulta o estado e o custo de uma execução da sua integração. Serve para conferir o que aconteceu com uma chamada que deu timeout e para ler os créditos usados.

curl https://api.cavori.com.br/v1/requests/cm9x0execucao0001 \
  -H "Authorization: Bearer $CAVORI_API_KEY"

Exemplo de resposta:

{
  "id": "cm9x0execucao0001",
  "conversation_id": "cm9x0conversa0001",
  "message_id": "cm9x0mensagem0002",
  "status": "COMPLETED",
  "output": "Abrimos sim, das 9h às 13h.",
  "finish_reason": "stop",
  "reserved_credits": "0.01200000",
  "charged_credits": "0.00310000",
  "cost_usd": "0.00150000",
  "completed_at": "2026-10-28T15:01:03.000Z"
}

Campo	Descrição
id	Id da execução.
conversation_id	Conversa a que ela pertence.
message_id	Mensagem do agente gerada, ou null se não houve.
status	Veja a tabela abaixo.
output	Texto da resposta, ou null.
finish_reason	stop, content_filter ou error, ou null.
reserved_credits	Créditos reservados ao longo da execução (string decimal).
charged_credits	Créditos cobrados (string decimal).
cost_usd	Custo em dólares (string decimal).
completed_at	Quando terminou (ISO 8601), ou null se ainda não terminou.

Status

Status	Significado
RUNNING	O agente está gerando a resposta.
COMPLETED	A resposta foi gerada e gravada.
PARTIAL	A geração falhou depois de parte do texto sair. Esse trecho está em output e na conversa, com finish_reason: "error".
FAILED	A geração falhou sem produzir texto.
WAITING_HUMAN	Uma pessoa já atendia a conversa, e a mensagem ficou à espera dela.

Uma execução que não existe, ou de outra integração, responde 404 not_found. Os valores de créditos e a diferença entre reservado e cobrado estão em Cobrança.