Agents

Update agent status

Changed on
patch/v1/agents/{agent_id}/status

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/agents/{agent_id}/status
  • 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.

Request body

status'active' | 'disabled' required

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

Response

agent_idstring uuid required
status'active' | 'disabled' | 'deleted' required

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

pause_reason'run_limit' | 'credit_limit' | 'runaway_credit_usage' | 'workspace_credit_limit' | 'owner_allowance_limit' | 'failure_limit' | 'mark_session_failed_autopause' | 'disabled_from_workspace_settings' | 'disabled_from_workspace_settings_but_resumable' | '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' nullable required

One of: run_limit, credit_limit, runaway_credit_usage, workspace_credit_limit, owner_allowance_limit, failure_limit, mark_session_failed_autopause, disabled_from_workspace_settings, disabled_from_workspace_settings_but_resumable, 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_timestring required

ISO 8601 timestamp of when the agent was last edited.

Changes

  • 789bd1e5766bRevision changes
    • warning

      added the new owner_allowance_limit enum value to the / response property for the response status

  • 39fd52dfa388Revision changes
    • warning

      added the new disabled_from_workspace_settings_but_resumable enum value to the / response property for the response status