Skip to main content
PATCH
Update a credit limit policy
The organization bot token must have the following scopes:
  • credit-limit-policy:write

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 Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

policy_id
string<uuid>
required

The current policy version ID. A successful update returns a new policy ID.

space_id
string<uuid>
required

Body

application/json
amount
integer
required

Replacement monthly premium AI credit limit.

Required range: 0 <= x <= 10000000
expires_at
integer

Response

object
string
required

Always credit_limit_policy

Allowed value: "credit_limit_policy"
amount
integer
required
created_at
integer
required
created_by
object
required
credit_type_unit
enum<string>
required

One of: basic_ai_credits, exempt_ai_credits, premium_ai_credits, preview_ai_credits

Available options:
basic_ai_credits,
exempt_ai_credits,
premium_ai_credits,
preview_ai_credits
id
string<uuid>
required
selector
object
required

All workspace members or one workspace member affected by the policy.

space_id
string<uuid>
required
expires_at
integer