DELETE /v1/calls/:callId
Encerra uma chamada ativa. Somente chamadas nos status QUEUED, RINGING ou IN_PROGRESS podem ser encerradas. O status da chamada é definido como FAILED e ended_at é registrado.
Requisição
Cabeçalhos
| Cabeçalho | Valor |
|---|
Authorization | Bearer <token> |
Parâmetros de caminho
| Parâmetro | Tipo | Descrição |
|---|
callId | string | O ID da chamada a ser encerrada |
Resposta 204
Sem conteúdo. A chamada foi encerrada.
Erros
| Código | Descrição |
|---|
401 | Token ausente ou inválido |
404 | Chamada não encontrada, já encerrada (COMPLETED ou FAILED) ou não pertence ao usuário |
Exemplo
curl -X DELETE https://cawme.com/api/v1/calls/call_xyz789 \
-H "Authorization: Bearer <token>"
Encerrar uma chamada define seu status como FAILED. Não existe um status separado CANCELLED.
