List Groups

GEThttps://api.confident-ai.com/v2/organization/governance-control-groups

Lists your organization's governance control groups, newest created first, with each group's controls counted rather than named. A group is a label for organizing controls and does not itself govern anything — what a control gates comes from the governance policies holding it, never from its group.

GET/v2/organization/governance-control-groups

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

200

{
  "success": true,
  "data": {
    "governanceControlGroups": [
      {
        "id": "<GOVERNANCE-CONTROL-GROUP-ID>",
        "name": "SOC 2 readiness",
        "description": "The controls our SOC 2 auditor asks about each quarter.",
        "controlsCount": 4,
        "createdAt": "2025-01-14T09:30:00.000Z",
        "updatedAt": "2025-01-18T16:45:00.000Z"
      }
    ],
    "totalGovernanceControlGroups": 3,
    "page": 1,
    "pageSize": 25
  },
  "link": "https://app.confident-ai.com/organization/<ORGANIZATION-ID>/governance/control-groups",
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Query parameters

pageintegerdefault: 1
The page to return. Defaults to 1.
pageSizeintegerdefault: 25
The number of control groups per page, at most 100. Defaults to 25.

Response

List Groups succeeded.

successboolean
Indicates if the request was successful.
dataobject
One page of governance control groups, with the total across all pages.
Show 4 propertiesHide 4 properties
- governanceControlGroupslist of objects
  The organization's control groups for the current page, newest created first.
  Show 6 propertiesHide 6 properties
  - idstring
    The id of the control group, generated by Confident AI.
  - namestring
    The name of the control group, unique within your organization.
  - descriptionstring | null
    What the group collects, or null when it has none.
  - controlsCountinteger
    How many controls are in the group.
  - createdAtstring
    When the control group was created.
  - updatedAtstring
    When the control group's own name or description last changed. Moving a control in or out of the group does not touch it, since membership is stored on the control.
- totalGovernanceControlGroupsinteger
  The number of control groups in the organization, across every page.
- pageinteger
  The page this response covers.
- pageSizeinteger
  The number of control groups per page.
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI