API Reference

Preview - Create a new AI governance policy

post
https://{region}.api.jamfcloud.com/ai/governance/policies/v1/policies

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

Preview endpoint. Expected to reach general availability by 2027-03-03,
pending feedback on request and response shape.

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

Required Permissions: ai-policies:create

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

Updated 23 days ago

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

Updated 23 days ago

Did this page help you?