Get Group

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

Retrieves a single governance control group with the controls inside it, which the list endpoint reports only as a count. Each control is named rather than resolved — retrieve a control by id for its health, its policy membership and its definition.

GET/v2/organization/governance-control-groups/{controlGroupId}

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

200

{
  "success": true,
  "data": {
    "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",
    "controls": [
      {
        "id": "<GOVERNANCE-CONTROL-ID>",
        "name": "Production error rate under 2%",
        "description": "Traces must error on fewer than 2% of production requests over the last day.",
        "type": "RUNTIME"
      }
    ]
  },
  "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.

Path parameters

controlGroupIdstringRequired
The id of the governance control group.

Response

Get Group succeeded.

successboolean
Indicates if the request was successful.
dataobject
A label for organizing an organization's governance controls, and nothing more. A group does not scope evaluation: which projects a control gates, and therefore when it is assessed, comes from the governance policies holding that control, so moving a control between groups changes nothing about what it checks or where. A control belongs to at most one group, and membership is set on the control rather than here.
Show 7 propertiesHide 7 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.
- controlslist of objects
  The controls in the group, ordered by name.
  Show 4 propertiesHide 4 properties
  - idstring
    The id of the control, generated by Confident AI.
  - namestring
    The name of the control.
  - descriptionstring | null
    What the control checks and why, or null when it has none.
  - typeenum
    What a governance control checks: RUNTIME watches production behaviour, PRE_DEPLOYMENT_EVALS and PRE_DEPLOYMENT_RED_TEAMING gate a release, and OPERATIONAL covers process rather than the system itself.
    Show 4 enum valuesHide 4 enum values
    RUNTIME
    PRE_DEPLOYMENT_EVALS
    PRE_DEPLOYMENT_RED_TEAMING
    OPERATIONAL
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI