Delete a Group

Removes an empty group permanently. A group that still has members, or that other groups are nested under, is NOT deleted: the request is refused and nothing changes. Remove the members with the group’s member routes first — each of them then stops holding whatever the group granted, which for someone whose only access came through this group means losing it entirely.

On success the response has no body (204).

Failures:

• 404 — no such group in your organization.
• 409 IDE-1058 — the group still has members; remove them, then delete the group.
• 409 IDE-1059 — other groups are nested under this one; delete or move them first.
• 503 IDE-0066 — the identity provider is unavailable (unreachable, too slow to answer, or failing). Nothing about the request was wrong; retry it later.

DELETE /v1/groups/{id}

Delete a Group

cURL

curl --request DELETE \
  --url https://identity.sandbox.lerian.net/v1/groups/{id} \
  --header 'Authorization: Bearer <token>'

400

{
  "code": "<string>",
  "entityType": "<string>",
  "err": "<unknown>",
  "message": "<string>",
  "title": "<string>"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Group ID.

Example:

"midaz-viewer-group"

Response

204

No Content