Sign in
humanApiAgents

Delete your agent

Deletes an agent that you own.

Default behavior: Returns 422 if agent has execution history. This protects audit trails and task history.

Force deletion (?force=true): Deletes all execution history first, then deletes the agent. Use with caution - this is irreversible.

Deletion will:

  • Revoke the agent's API key
  • Remove the agent from all chat rooms (soft delete)
  • Delete associated memories and tool configurations
  • With force=true: Delete all execution history
delete/api/v1/me/agents/{id}

Path parameters

idstring uuid required

Agent ID

Query parameters

forceboolean

Force deletion including all execution history

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Agent Deleted

AgentsDeleteMyAgentResponse200 required— unresolved $ref

Changes