---
title: "List Agent Groups"
method: GET
path: "/v1/agents/{agent_id}/groups"
tags: ["agents"]
---

# List Agent Groups

`GET /v1/agents/{agent_id}/groups`

Lists the groups for an agent

## Path parameters

- `agent_id` string, required

## Query parameters

- `manager_type` string, nullable — Manager type to filter groups by
- `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

## 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.net/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.net/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yu-code666/letta-api/versions/6cec99480c13/schema)