Skip to main content
DELETE
Delete credit access policy
The organization bot token must have the following scopes:
  • credit-limit-policy:write
Deletes a credit access policy. Its assignments stop applying, and covered members fall back to any other policy that matches them. Pass the policy’s current version as the expected_version query parameter. If the policy changed after you read it, the request returns a 409 error. You can’t delete the policy assigned to all_space_members, which is the workspace default. First move that assignment to another policy, then delete this one. Otherwise the request returns a 409 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 Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

policy_id
string<uuid>
required

ID of the credit access policy.

space_id
string<uuid>
required

Query Parameters

expected_version
string
required

The policy's current version. The request fails with a conflict error if the policy changed after you read it.

Required string length: 1 - 256

Response

object
string
required

Always credit_access_policy

Allowed value: "credit_access_policy"
id
string<uuid>
required
deleted
boolean
required

Always true