---
title: "Retrieve Group"
method: GET
path: "/v1/groups/{group_id}"
tags: ["groups"]
---

# Retrieve Group

`GET /v1/groups/{group_id}`

Retrieve the group by id.

## Path parameters

- `group_id` string, required

## 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)