---
title: "List Groups"
method: GET
path: "/v1/groups/"
tags: ["groups"]
---

# List Groups

`GET /v1/groups/`

Fetch all multi-agent groups matching query.

## Query parameters

- `manager_type` 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm'
- `before` string, nullable — Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order
- `after` string, nullable — Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order
- `limit` integer, nullable — Maximum number of groups to return
- `order` 'asc' | 'desc' — Sort order for groups by creation time. 'asc' for oldest first, 'desc' for newest first
- `order_by` 'created_at' — Field to sort by
- `project_id` string, nullable — Search groups by project id

## Response `200`

Successful Response

- Group[]
  - `id` string, required — The id of the group. Assigned by the database.
  - `manager_type` 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm', required
  - `agent_ids` string[], required
  - `description` string, required
  - `project_id` string, nullable — The associated project id.
  - `template_id` string, nullable — The id of the template.
  - `base_template_id` string, nullable — The base template id.
  - `deployment_id` string, nullable — The id of the deployment.
  - `shared_block_ids` string[]
  - `manager_agent_id` string, nullable
  - `termination_token` string, nullable
  - `max_turns` integer, nullable
  - `sleeptime_agent_frequency` integer, nullable
  - `turns_counter` integer, nullable
  - `last_processed_message_id` string, nullable
  - `max_message_buffer_length` integer, nullable — The desired maximum length of messages in the context window of the convo agent. This is a best effort, and may be off slightly due to user/assistant interleaving.
  - `min_message_buffer_length` integer, nullable — The desired minimum length of messages in the context window of the convo agent. This is a best effort, and may be off-by-one due to user/assistant interleaving.
  - `hidden` boolean, nullable — If set to True, the group will be hidden.

## Other responses

- `422` — Validation Error

---

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