Skip to main content
DELETE
Delete a group
Deletes a directory group. The people in it stay in the organization. Check its role mappings and workspace shares first, so you know what access the group was carrying.
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

groupId
string
required

Response

Deleted