Skip to main content
PATCH
TypeScript SDK
Only a personal access token can change a credit limit, and its user needs full access to the Custom Agent. A connection token gets a 403 restricted_resource, even with the Edit selected agents capability. Workspace admins can also use the Admin API. The personal agent (notion_ai) has no per-agent credit limit. Passing it returns a 400 validation_error.

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 ID of the custom agent (a UUID). The personal agent (Notion AI) is not supported by this endpoint.

Body

application/json
credit_limit
integer | null
required

The per-agent credit limit as a non-negative integer, or null to clear the limit.

Response

agent_id
string<uuid>
required
credit_limit
integer | null
required

The agent's editor-set per-agent credit limit; null when no limit applies.

last_edited_time
string
required

ISO 8601 timestamp of when the agent was last edited.