Agentes
Excluir um agente
Exclui um agente (exclusão definitiva), com o histórico de execuções de um agente de texto; a base de conhecimento dele é apagada em seguida, salvo a coleção que outro agente do cliente ainda usa. Não é excluído (409): o agente de tarefa que hooks de outros agentes nomeiam (details.agents diz quais), o agente de voz em ligação e o agente ainda usado por outro registro (uma campanha, por exemplo).
Autorização
bearer agents: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: agents:delete
Parâmetros de caminho
agent_id*string
Id do agente
Corpo da resposta
application/json
curl -X DELETE "https://example.com/agents/string"Vazio