Agents

Delete agent

Changed on
delete/v1/agents/{agent_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/agents/{agent_id}
  • Auth
    HTTP bearer

Path parameters

string required
OR
'notion_ai' | '33333333-3333-3333-3333-333333333333' required

One of: notion_ai, 33333333-3333-3333-3333-333333333333

Headers

Notion-Version'2026-03-11' required

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

Response

agent_idstring uuid required
status'deleted' required

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

deleted_atstring required

ISO 8601 timestamp of when the agent was deleted.

Changes