---
title: "Update agent status"
method: PATCH
path: "/v1/agents/{agent_id}/status"
tags: ["Agents"]
---

# Update agent status

`PATCH /v1/agents/{agent_id}/status`

## Path parameters

- `agent_id` union, required — The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.
  - string
  - 'notion_ai' | '33333333-3333-3333-3333-333333333333' — One of: `notion_ai`, `33333333-3333-3333-3333-333333333333`

## Headers

- `Notion-Version` '2026-03-11', required

## Request body

- object
  - `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 `200`

- object
  - `agent_id` string, 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' | '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', nullable, required — One of: `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.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)