Skip to main content
PUT
Python SDK

Access

This operation needs a Parable token. An MCP token cannot call it. See Authentication for the kinds of token. Your roles must grant tenant.providerpolicies.manage.

Errors

  • WA-PP-009: Someone changed the Workspace’s source permissions settings after the revision the save names. Load the settings again and make the change on top of them.

Authorizations

Authorization
string
header
required

A personal access token, which starts with pat_. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.

Headers

X-Tenant
string

Workspace slug. Overrides subdomain-based workspace resolution when provided.

Example:

"acme"

X-Request-ID
string<uuid>

Optional request correlation ID echoed back in the response.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

Replaces a Workspace's source permissions settings. Both settings are required: a save that leaves one out is refused rather than turning it off.

enforced
boolean
required
expectedRevision
integer<int64>
required

The revision the change starts from: 0 for a Workspace that never saved the settings. Another save in between refuses this one.

Required range: 0 <= x <= 9007199254740991

Response

Successful response

data
object
required

A Workspace's source permissions settings, on the Provider Policies page. A Workspace that never saved them reads both as false at revision 0.

meta
object
required