Ligações
Excluir uma ligação
Tira a ligação do histórico. A exclusão é lógica: o consumo e o custo dela continuam contando na fatura — apagar histórico não reduz a conta. A transcrição fica com a conversa, que se exclui em /conversations/{id}; depois da exclusão, /calls/{id}/transcript deixa de responder. Ligação em curso responde 409: para soltar a linha, DELETE /agents/{agent_id}/call-lock.
Autorização
bearer calls:deleteAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: calls:delete
Parâmetros de caminho
call_id*string
Id da ligação
Corpo da resposta
application/json
curl -X DELETE "https://example.com/calls/string"Vazio