Skip to main content
POST
Create a new policy with an initial version. The initial version is automatically set as the current version.

Query Parameters

Request Body

Content Object

The content field accepts a JSON object with the following optional sections:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

organization_id
string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Body

application/json

Serializer for creating a new policy with initial version

name
string
required
Required string length: 1 - 255
content
any
required
write-only

Content for the initial policy version

description
string
version_name
string
default:version 1
write-only

Name for the initial version (defaults to 'version 1')

Required string length: 1 - 255

Response

Policy created successfully.

Serializer for creating a new policy with initial version

id
string<uuid>
required
read-only
name
string
required
Maximum string length: 255
organization_id
string<uuid>
required
read-only
current_version_id
string<uuid> | null
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
description
string