API ReferenceHuman API

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

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Path parameters

idstringRequiredformat: "uuid"
Agent ID

Query parameters

forcebooleanOptionalDefaults to false
Force deletion including all execution history

Response

Agent Deleted
dataobject

Errors