API EndpointsHuman APIAgents

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

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error