Skip to main content
PATCH
TypeScript SDK

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. Endpoint-specific restrictions still apply.

Body

application/json
status
enum<string>
required

Set to "active" to re-enable an agent that was disabled through this API, or "disabled" to turn off a running agent.

Available options:
active,
disabled

Response

agent_id
string<uuid>
required
status
enum<string>
required

"active" when the agent can run; "disabled" when it is paused (see pause_reason); "deleted" when it has been removed.

Available options:
active,
disabled,
deleted
pause_reason
enum<string> | null
required

Why the agent is paused when status is "disabled" (e.g. "disabled_from_api", "credit_limit"); null when active or deleted.

Available options:
run_limit,
credit_limit,
runaway_credit_usage,
workspace_credit_limit,
failure_limit,
mark_session_failed_autopause,
disabled_from_workspace_settings,
disabled_from_api,
disabled_from_agent_settings,
disabled_due_to_no_members_with_access,
disabled_due_to_lack_of_editors,
disabled_by_notion,
internal_error,
needs_user_review,
tool_unavailable
last_edited_time
string
required

ISO 8601 timestamp of when the agent was last edited.