Skip to main content
DELETE
Delete a role mapping
Deletes a group-to-role mapping. Affected members re-resolve among their remaining mapped groups, or keep their current role when none is left. Nobody is removed from the organization. Related guide: User provisioning: groups and roles. The group’s members re-resolve among their remaining mapped groups, or keep their current role when none remains.
Availability: Cloud · Enterprise (self-hosted). Not available on the Community edition: a self-hosted deployment needs ENTERPRISE_ENABLED=true, otherwise the endpoint answers 403 with error.type: "enterprise_license_required".

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

id
string
required

Response

Deleted