Skip to content
API Reference

Set the default policy schema for a zone

zones.policy_schemas.set_default(strversion, PolicySchemaSetDefaultParams**kwargs) -> SchemaVersionWithZoneInfo
PATCH/zones/{zone_id}/policy-schemas/{version}

Set the default policy schema for a zone

ParametersExpand Collapse
zone_id: str
version: str
body: Optional[object]
x_api_version: Optional[str]
x_client_request_id: Optional[str]
formatuuid
ReturnsExpand Collapse
class SchemaVersionWithZoneInfo:

A versioned Cedar schema that defines the entity model, actions, and context shape used for policy evaluation. The schema contains the valid entity types (User, Application, Resource), their attributes, and the allowed attribute values. See the Credentials API spec for a full reference of entity attributes and valid values.

is_default: bool

Whether this is the zone's default schema. Clients use this to pre-select which schema to write policies against. Has no effect on evaluation.

Set the default policy schema for a zone

from keycardai_api import KeycardAPI

client = KeycardAPI()
schema_version_with_zone_info = client.zones.policy_schemas.set_default(
    version="version",
    zone_id="zone_id",
)
print(schema_version_with_zone_info)
{
  "created_at": "2019-12-27T18:11:19.117Z",
  "status": "active",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "version": "version",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "cedar_schema": "cedar_schema",
  "cedar_schema_json": {},
  "deprecated_at": "2019-12-27T18:11:19.117Z",
  "is_default": true
}
Returns Examples
{
  "created_at": "2019-12-27T18:11:19.117Z",
  "status": "active",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "version": "version",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "cedar_schema": "cedar_schema",
  "cedar_schema_json": {},
  "deprecated_at": "2019-12-27T18:11:19.117Z",
  "is_default": true
}