Assess Policy

POSThttps://api.confident-ai.com/v2/organization/governance-policies/{policyId}/assess

Runs every control the governance policy applies against every project enrolled in it, right now, and appends a fresh verdict for each (control, project) pair. Inherited controls are run too, since they apply to the policy's projects just as its own do. This is the write that changes what the policy and its projects report: statuses, check counts and streaks all move as a result. It consumes evaluation resources in proportion to the number of controls multiplied by the number of projects, and the request does not return until the run finishes, so expect it to be slow on a large policy. A policy with no projects enrolled runs nothing and returns a projectsAssessed of 0. The verdicts themselves are not in this response — read them back from the policy, or from each project's governance view.

POST/v2/organization/governance-policies/{policyId}/assess

curl -X POST "https://api.confident-ai.com/v2/organization/governance-policies/{policyId}/assess" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

200

{
  "success": true,
  "data": {
    "governancePolicy": {
      "id": "<GOVERNANCE-POLICY-ID>",
      "name": "EU AI Act readiness"
    },
    "projectsAssessed": 4
  },
  "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.

Path parameters

policyIdstringRequired
The id of the governance policy.

Response

Assess Policy succeeded.

successboolean
Indicates if the request was successful.
dataobject
What an assessment run covered. The verdicts themselves are read back from the policy or from each project, since a run appends one assessment per (control, project) pair.
Show 2 propertiesHide 2 properties
- governancePolicyobject
  A governance policy, named by id.
  Show 2 propertiesHide 2 properties
  - idstring
    The id of the governance policy.
  - namestring
    The name of the governance policy.
- projectsAssessedinteger
  How many enrolled projects were assessed, which is 0 when the policy has no projects enrolled and nothing was run.
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI