Skip to main content
PATCH
Update who can create agents in a space
The organization bot token must have the following scopes:
  • workflows: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

space_id
string<uuid>
required

Body

application/json
policy
enum<string>
required
Available options:
all_workspace_members,
disabled,
workspace_owners_only
disable_existing_agents
boolean

When true, also disable all existing custom agents in the workspace. Only takes effect when 'policy' is "disabled".

Response

agent_counts
object
required
current_policy
required

The policy now in effect, or 'null' when no explicit policy has ever been set for the workspace (which behaves as the "all_workspace_members" default).

Allowed value: "all_workspace_members"
current_policy_description
string
required
space_id
string<uuid>
required
space_name
string
required