For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Trust CenterStatusSupportGet a demoPlatform
DocumentationEvals API ReferenceIntegrations & OTELPlatform SettingsSelf-HostingGuidesChangelog
DocumentationEvals API ReferenceIntegrations & OTELPlatform SettingsSelf-HostingGuidesChangelog
  • Get Started
    • Introduction
    • Quickstart
    • Authentication
    • Data Models
    • API Conventions
  • Data Models
      • GETRetrieve Organization
      • PUTUpdate Organization
        • GETList Organization Policies
        • POSTCreate Organization Policy
        • PUTUpdate Organization Policy
        • DELDelete Organization Policy
  • Evals
  • Legacy
LogoLogo
Trust CenterStatusSupportGet a demoPlatform
Data ModelsOrganizationPolicies

Create Organization Policy

POST
https://api.confident-ai.com/v1/organization/policies
POST
/v1/organization/policies
$curl -X POST https://api.confident-ai.com/v1/organization/policies \
> -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>" \
> -H "Content-Type: application/json" \
> -d '{
> "name": "Manage billing",
> "permissionIds": [
> "perm-uuid-1",
> "perm-uuid-2"
> ],
> "description": "Grants access to billing settings"
>}'
200Successful
1{
2 "success": true,
3 "data": {
4 "policy": {
5 "id": "policy-uuid-2",
6 "name": "Manage billing",
7 "description": "Grants access to billing settings",
8 "permissions": [
9 {
10 "id": "perm-uuid-1",
11 "name": "billing:read"
12 },
13 {
14 "id": "perm-uuid-2",
15 "name": "billing:write"
16 }
17 ]
18 }
19 }
20}

Creates a custom organization policy from a set of permissions. Use GET /v1/organization/permissions to discover assignable permission ids.

Was this page helpful?
Previous

Update Organization Policy

Next
Built with

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Request

This endpoint expects an object.
namestringRequired
Name of the policy
permissionIdslist of stringsRequired
The ids of the permissions granted by this policy
descriptionstring or nullOptional
Optional description of the policy

Response

successboolean
Indicates if the request was successful
dataobject