---
title: "Listar grupos da conexão"
method: GET
path: "/v1/groups"
tags: ["Groups"]
---

# Listar grupos da conexão

`GET /v1/groups`

Retorna todos os grupos da conexão: id, nome, título, imagem e descrição. Não inclui participantes.

## Query parameters

- `connection` string, required

## Response `200`

Lista de grupos

- GroupListResponseDto
  - `groups` GroupSummaryDto[], required
    - `id` string, uuid, required — UUID do chat de grupo (`Chat.id`). Nas rotas use como `:group`.
    - `name` string, nullable — Nome do grupo
    - `title` string, nullable — Descrição do grupo.
    - `image` string, nullable — URL da foto do grupo
    - `description` string, nullable — Descrição / sobre o grupo

## Other responses

- `401` — Não autorizado

---

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