Update agent status
Enable or disable a Custom Agent.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Path Parameters
The agent ID (a UUID), or notion_ai for the personal agent. Endpoint-specific restrictions still apply.
Body
Set to "active" to re-enable an agent that was disabled through this API, or "disabled" to turn off a running agent.
active, disabled Response
"active" when the agent can run; "disabled" when it is paused (see pause_reason); "deleted" when it has been removed.
active, disabled, deleted Why the agent is paused when status is "disabled" (e.g. "disabled_from_api", "credit_limit"); null when active or deleted.
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 ISO 8601 timestamp of when the agent was last edited.