Create Governance Policy

(v2)

POST

Creates a governance policy and returns its id. It starts with no controls attached and no projects enrolled, so use their own endpoints afterwards. A basePolicyIds entry that itself extends another policy is rejected, and that check and the write run in one serializable transaction, so concurrent creates cannot slip past the rule.

POST/v2/organization/governance-policies

curl -X POST "https://api.confident-ai.com/v2/organization/governance-policies" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "EU AI Act readiness",
  "description": "The checks every customer-facing agent must pass before release.",
  "basePolicyIds": [
    "<GOVERNANCE-POLICY-ID>"
  ]
}'

200

{
  "success": true,
  "data": {
    "id": "<GOVERNANCE-POLICY-ID>"
  },
  "link": "https://app.confident-ai.com/organization/<ORGANIZATION-ID>/governance/policies/<GOVERNANCE-POLICY-ID>",
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Request body

namestringRequired
The name of the governance policy, unique within your organization.
descriptionstring | null
What the policy covers. Omit it, or send null, to leave it unset.
basePolicyIdslist of strings
The policies this policy extends, whose controls then also apply to its projects. Omit for a standalone policy. Inheritance is exactly two levels deep, so every id here must name a policy that extends nothing itself.

Response

Create Governance Policy succeeded.

successboolean
Indicates if the request was successful.
dataobject
A governance policy, identified by its id.
Show 1 propertyHide 1 property
- idstring
  The id of the governance policy.
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI