v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1434249272.1 KB

Creates or updates the policy schema in the specified policy store. The schema is used to validate any Cedar policies and policy templates submitted to the policy store. Any changes to the schema validate only policies and templates submitted after the schema change. Existing policies and templates are not re-evaluated against the changed schema. If you later update a policy, then it is evaluated against the new schema at that time.

Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.

post/#X-Amz-Target=VerifiedPermissions.PutSchema

Headers

X-Amz-Target'VerifiedPermissions.PutSchema' required

Request body

policyStoreIdstring required
<p>Specifies the ID of the policy store in which to place the schema.</p> <p>To specify a policy store, use its ID or alias name. When using an alias name, prefix it with <code>policy-store-alias/</code>. For example:</p> <ul> <li> <p>ID: <code>PSEXAMPLEabcdefg111111</code> </p> </li> <li> <p>Alias name: <code>policy-store-alias/example-policy-store</code> </p> </li> </ul> <p>To view aliases, use <a href="https://docs.aws.amazon.com/verifiedpermissions/latest/apireference/API_ListPolicyStoreAliases.html">ListPolicyStoreAliases</a>.</p>

Response

Success

policyStoreIdstring required

The unique ID of the policy store that contains the schema.

namespacesNamespace[] required

Identifies the namespaces of the entities referenced by this schema.

createdDatestring date-time required

The date and time that the schema was originally created.

lastUpdatedDatestring date-time required

The date and time that the schema was last updated.