Delete Organization Role

(v2)

DELETE

Permanently deletes a custom organization role. A role still assigned to at least one member cannot be deleted — move those members onto another role first — so deleting a role never silently strips anyone of their access. The policies attached to it are not deleted and stay available to other roles. A global, system-defined role responds 404. This cannot be undone.

DELETE/v2/organization/roles/{roleId}

curl -X DELETE "https://api.confident-ai.com/v2/organization/roles/{roleId}" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

200

{
  "success": true,
  "data": {
    "id": "<ROLE-ID>"
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Path parameters

roleIdstringRequired
The id of the role. It must be a role the organization or project owns; a global, system-defined role is not addressable here.

Response

Delete Organization Role succeeded.

successboolean
Indicates if the request was successful.
dataobject
Confirmation that the role no longer exists.
Show 1 propertyHide 1 property
- idstring
  The id of the role that was deleted.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI