---
title: "Delete a Group"
method: DELETE
path: "/scim/v2/Groups/{group_id}"
tags: ["SCIM"]
---

# Delete a Group

`DELETE /scim/v2/Groups/{group_id}`

## Request

- Base URL: `https://api.byndid.com`
- URL: `https://api.byndid.com/scim/v2/Groups/{group_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/docs/scim/v2/Groups/:group_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

To delete a group, send a DELETE request to `/Groups/$GROUP_ID`.
As specified in [RFC-7644 §3.6](https://datatracker.ietf.org/doc/html/rfc7644#section-3.6),
a successful delete operation returns HTTP status 204 (No Content).
If the resource does not exist, HTTP status 404 is returned.

Note that this method cannot be used to delete any groups which were not
created by SCIM, e.g. RBAC permission groups or other groups created through
the Admin Console.

## Path parameters

- `group_id` string, required

## Response `204`

The group was successfully deleted. As per [RFC-7644 §3.6](https://datatracker.ietf.org/doc/html/rfc7644#section-3.6),
no response body is returned.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `404`: Returns 404 if: * The group was not found * The group exists but was created through the Admin Console * The group is one of the RBAC permission groups Note: Groups not created via SCIM APIs cannot be deleted using SCIM APIs.
- `429`: Rate limit exceeded.
- `500`: Server error.

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/revisions/562e14b2e4ba?raw)