Skip to main content
DELETE
TypeScript SDK
Only a personal access token can delete a Custom Agent, and its user needs edit access to the agent. A connection token gets a 403 restricted_resource, even with the Edit selected agents capability. Workspace admins can also use the Admin API. You can’t delete the personal agent (notion_ai). Passing it returns a 400 validation_error.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

agent_id
required

The agent ID (a UUID), or notion_ai for the personal agent. The personal agent cannot be deleted.

Response

agent_id
string<uuid>
required
status
string
required

Always "deleted": the agent has been soft-deleted (recoverable).

Allowed value: "deleted"
deleted_at
string
required

ISO 8601 timestamp of when the agent was deleted.