List Permissions

GEThttps://api.confident-ai.com/v2/organization/permissions

Lists every organization permission an organization policy can grant. Each is named resource:action — billing:read, user:manage, modelCredential:manage — and its id is what you send in a policy's permissionIds.

The list is Confident AI's whole organization catalog, not only the permissions your organization already uses, and it is returned in no particular order. Project permissions are a separate catalog with its own endpoint; an organization policy that references a project permission id is stored but never matches an organization permission check.

GET/v2/organization/permissions

curl -X GET "https://api.confident-ai.com/v2/organization/permissions" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

200

{
  "success": true,
  "data": {
    "permissions": [
      {
        "id": "<PERMISSION-ID>",
        "name": "user:read",
        "description": null
      }
    ]
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Response

List Permissions succeeded.

successboolean
Indicates if the request was successful.
dataobject
The complete set of permissions a policy in this scope can grant, taken from Confident AI's own catalog rather than from what your organization happens to use already.
Show 1 propertyHide 1 property
- permissionslist of objects
  Every permission in the catalog for this scope, in no particular order.
  Show 3 propertiesHide 3 properties
  - idstring
    The id of the permission, generated by Confident AI. This is what a policy references in its permissionIds.
  - namestring
    The permission, written as resource:action — the resource it applies to, then what it allows on it. read grants viewing, manage grants creating and updating, and create, update and delete appear where a resource distinguishes them.
  - descriptionstring | null
    What the permission allows, in prose, or null when it has none. Confident AI creates these permissions from its own catalog and does not describe them, so this is null unless someone has filled it in.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI