groups

Create Group

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

post/v1/groups/

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/groups/
  • Auth
    HTTP bearer

Headers

X-Projectstring nullable

The project slug to associate with the group (cloud only).

Request body

agent_idsstring[] required
descriptionstring required
project_idstring nullable

The associated project id.

shared_block_idsstring[]
hiddenboolean nullable

If set to True, the group will be hidden.

Response

Successful Response

idstring required

The id of the group. Assigned by the database.

manager_type'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm' required
agent_idsstring[] required
descriptionstring required
project_idstring nullable

The associated project id.

template_idstring nullable

The id of the template.

base_template_idstring nullable

The base template id.

deployment_idstring nullable

The id of the deployment.

shared_block_idsstring[]
manager_agent_idstring nullable
termination_tokenstring nullable
max_turnsinteger nullable
sleeptime_agent_frequencyinteger nullable
turns_counterinteger nullable
last_processed_message_idstring nullable
max_message_buffer_lengthinteger 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_lengthinteger 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.

hiddenboolean nullable

If set to True, the group will be hidden.

Changes

No recorded changes to this operation across all 36 revisions of this API.