---
title: "Delete a group by its ID"
method: DELETE
path: "/scim/v2/Groups/{id}"
tags: ["Group API"]
---

# Delete a group by its ID

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

Remove a group from a team with this endpoint. Removing a group does not remove its members from the Celonis Platform team.

## Path parameters

- `id` string, required

## Response `204`

OK, but no content to return.

## Other responses

- `400` — Bad Request. Please check the response contents for an explanation of the cause. Causes include exceeding the team license, non-existing group members or exceeding the maximum of 50 groups per User.
- `401` — Unauthorized. Please check whether your API key or application key has sufficient permissions. In case you are unsure, please refer the documentation on [application keys](https://help.celonis.cloud/help/display/CIBC/Application+Keys) and [permissions](https://help.celonis.cloud/help/display/CIBC/Permissions).
- `403` — Forbidden
- `500` — An internal error happened. Please forward the associated error ID along with any helpful information to [our support](https://help.celonis.cloud/help/display/CIBC/Support)

---

[API](https://skmtc.dev/celonis/apis/celonis-scim-api.md) · [All operations](https://skmtc.dev/celonis/apis/celonis-scim-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celonis/celonis-scim-api/revisions/979f1f5a7080/schema)