---
title: "Excluir Grupo"
method: DELETE
path: "/groups/{id}/"
tags: ["Grupo"]
---

# Excluir Grupo

`DELETE /groups/{id}/`

Exclui um grupo cadastrado na Gupy. 
A exclusão é permanente e irreversível.Atenção: se a deleção do grupo implicar na remoção de colaboradores, a request inicial falhará com o código 406 Not Acceptable. Para prosseguir reenvie a solicitação de exclusão com o cabeçalho (header) HTTP Confirmation-Code recebido. O frontend deve alertar o usuário com a pergunta recebida no detail dessa falha.

## Path parameters

- `id` integer, required

## Query parameters

- `secret` string, required

## Headers

- `confirmation_code` string

## Response `204`

Grupo deletado com sucesso

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `406` — Usuário vinculados ao grupo

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/revisions/3f26defa2a42/schema)