Create a new AI governance policy

Validates settings against the vendor JSON Schema, creates a policy with draftsettings, and returns the policy ID. The policy starts with hasDraft=true. CallPOST /policies/{policyId}/publish to create the first published version.

Required Permissions: ai-policies:create

Preview: This endpoint is currently in a preview state and is subject to breaking changes without warning.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body for creating a new AI governance policy with initial draft settings.

string
required
length between 1 and 200
string | null
string
required
length ≥ 1

Must match a known tool. Returns 422 if not found.

string
required
length ≥ 1

Vendor schema version the settings were authored against. Must be a known
version for the tool. Returns 422 if not found.

settings
object
required

Vendor tool settings payload. Shape is tool-specific and defined by the vendor's
JSON Schema, which is served by GET /v1/tools/{toolId}/schemas/{schemaVersion}
(see the ToolSchemaResponse schema). Only keys the admin explicitly set are
present. Validated at write time against the vendor schema for the request's
schemaVersion.

Headers
uuid
required
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The environment UUID identifier.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json