---
title: "Unassign Projects from Governance Policy"
method: POST
path: "/v1/organization/governance-policies/{policyId}/unassign"
tags: ["Organization Governance Policies"]
---

# Unassign Projects from Governance Policy

`POST /v1/organization/governance-policies/{policyId}/unassign`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/organization/governance-policies/{policyId}/unassign`
- Auth: none declared

Removes one or more projects from a governance policy. This is a partial-success operation. Projects currently on this policy are removed and returned in `unassignedProjectIds`, while ids that are not on this policy (unknown, foreign, or on another policy) are reported in `skippedProjectIds` instead of failing the request. `count` is the number removed.

## Path parameters

- `policyId` string, required

## Request body

- AssignGovernancePolicyProjects
  - `projectIds` string[], required: The ids of the projects to assign or unassign.

## Response `200`

- GovernancePolicyUnassignmentResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object, required
    - `governancePolicy` object, required: The governance policy that was modified.
      - `id` string, required: The unique identifier of the governance policy.
      - `name` string, required: The name of the governance policy.
    - `unassignedProjectIds` string[], required: Ids of the projects removed from this policy.
    - `skippedProjectIds` string[], required: Ids that were not on this policy (unknown, foreign, or on another policy). They are skipped and reported here rather than failing the request.
    - `count` integer, required: The number of projects removed (the length of unassignedProjectIds).

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-06-29** `77c4156f18d2`: 2 info
  - added the required property `data/skippedProjectIds` to the response with the `200` status
  - added the required property `data/unassignedProjectIds` to the response with the `200` status
- **2026-06-29** `c77c54067665`: 2 breaking
  - removed the required property `data/skippedProjectIds` from the response with the `200` status
  - removed the required property `data/unassignedProjectIds` from the response with the `200` status
- **2026-06-28** `0d196a3b614e`: 2 info
  - added the required property `data/skippedProjectIds` to the response with the `200` status
  - added the required property `data/unassignedProjectIds` to the response with the `200` status
- **2026-06-26** `23289125b456`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/organization/governance-policies/:policyId/unassign/post.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)
