---
title: "Delete a group by foreign id"
method: DELETE
path: "/v1/groups"
tags: ["groups"]
---

# Delete a group by foreign id

`DELETE /v1/groups`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

## Query parameters

- `groupId` string, required

## Response `200`

The group has been successfully deleted.

## Other responses

- `404`: The group was not found.

---

[API](https://skmtc.dev/frigadehq/apis/frigade-api.md) - [All operations](https://skmtc.dev/frigadehq/apis/frigade-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frigadehq/apis/frigade-api/revisions/92c033821b45?raw)