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 strings or null

manager_agent_idstring or null

termination_tokenstring or null

max_turnsinteger or null

sleeptime_agent_frequencyinteger or null

turns_counterinteger or null

last_processed_message_idstring or null

max_message_buffer_lengthinteger or null

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 or null

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	from letta_client import Letta
2
3	client = Letta(
4	token="YOUR_TOKEN",
5	)
6	client.groups.list()

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	]

Headers

Query parameters

Response