List Groups | Letta

Fetch all multi-agent groups matching query.

Query parameters

manager_typeenumOptional

Search groups by manager type

beforestringOptional

Cursor for pagination

afterstringOptional

Cursor for pagination

limitintegerOptional

Limit for pagination

project_idstringOptional

Search groups by project id

Response

Successful Response

idstring

The id of the group. Assigned by the database.

manager_typeenum

agent_idslist of strings

descriptionstring

shared_block_idslist of stringsOptional

manager_agent_idstringOptional

termination_tokenstringOptional

max_turnsintegerOptional

sleeptime_agent_frequencyintegerOptional

turns_counterintegerOptional

last_processed_message_idstringOptional

max_message_buffer_lengthintegerOptional

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_lengthintegerOptional

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.

1	[
2	{
3	"id": "foo",
4	"manager_type": "round_robin",
5	"agent_ids": [
6	"foo"
7	],
8	"description": "foo",
9	"shared_block_ids": [
10	"foo"
11	],
12	"manager_agent_id": "foo",
13	"termination_token": "foo",
14	"max_turns": 42,
15	"sleeptime_agent_frequency": 42,
16	"turns_counter": 42,
17	"last_processed_message_id": "foo",
18	"max_message_buffer_length": 42,
19	"min_message_buffer_length": 42
20	}
21	]

1	curl https://api.letta.com/v1/groups/ \
2	-H "Authorization: Bearer <token>"

Headers

Query parameters

Response