Execução
Excluir uma conversa
Tira a conversa do Histórico. A exclusão é lógica: as mensagens continuam no banco porque é delas que sai a fatura do mês — apagá-las deixaria o cliente reduzir a própria conta apagando histórico. Excluir de novo o que já saiu responde 404, como uma conversa que não existe: ela saiu do Histórico.
Autorização
bearer conversations: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: conversations:delete
Parâmetros de caminho
conversation_id*string
Id da conversa
Corpo da resposta
application/json
curl -X DELETE "https://example.com/conversations/string"Vazio