Excluir agente de IA
DELETE/ai-agents/:id
Removes the agent, its triggers and their schedules. Its past runs stay in the assistant as conversations. Requires scope finance/ai_agents with access level delete. Calling DELETE twice returns 200 then 404.
Requisição
Respostas
- 200
- 401
- 403
- 404
- 429
- 500
AI agent deleted.
Missing / invalid / expired / revoked token.
Token lacks the finance/ai_agents scope or the delete access level, or the person lacks ai-agents.delete.
AI agent not found among the token person's agents in the workspace.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.