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

# Modify Group

`PATCH /v1/groups/{group_id}`

Create a new multi-agent group with the specified configuration.

## Path parameters

- `group_id` string, required

## Headers

- `X-Project` string, nullable — The project slug to associate with the group (cloud only).

## Request body

- GroupUpdate
  - `agent_ids` string[], nullable
  - `description` string, nullable
  - `manager_config` union
    - RoundRobinManagerUpdate
      - `manager_type` 'round_robin'
      - `max_turns` integer, nullable
    - SupervisorManagerUpdate
      - `manager_type` 'supervisor'
      - `manager_agent_id` string, nullable, required
    - DynamicManagerUpdate
      - `manager_type` 'dynamic'
      - `manager_agent_id` string, nullable
      - `termination_token` string, nullable
      - `max_turns` integer, nullable
    - SleeptimeManagerUpdate
      - `manager_type` 'sleeptime'
      - `manager_agent_id` string, nullable
      - `sleeptime_agent_frequency` integer, nullable
    - VoiceSleeptimeManagerUpdate
      - `manager_type` 'voice_sleeptime'
      - `manager_agent_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.
  - `project_id` string, nullable — The associated project id.
  - `shared_block_ids` string[], nullable

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