Delete Agent
DELETE/v1/agents/:agent_id
Soft-delete an agent by marking it as deleted.
The agent is not permanently removed but marked as deleted (is_deleted=True). This preserves:
- Historical conversation data
- Agent configuration for audit purposes
- References in existing conversations
The agent will no longer appear in active agent lists and cannot be used for new conversations. Existing conversations with this agent remain accessible.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 500
Agent deleted successfully (soft delete)
Authentication failed - Invalid or missing credentials
Permission denied - Insufficient privileges
Resource not found
Validation error - Invalid request data
Internal server error