Skip to content
My Docs My Docs letta-sdk
  • Auto
  • Light
  • Dark
DiscordForumGitHubSign up
API Reference
View as Markdown
Copy Markdown
Open in Claude
Open in ChatGPT

Groups

List Groups
groups.list(GroupListParams**kwargs) -> SyncArrayPage[Group]
get/v1/groups/
Create Group
groups.create(GroupCreateParams**kwargs) -> Group
post/v1/groups/
Retrieve Group
groups.retrieve(strgroup_id) -> Group
get/v1/groups/{group_id}
Update Group
groups.update(strgroup_id, GroupUpdateParams**kwargs) -> Group
patch/v1/groups/{group_id}
Delete Group
groups.delete(strgroup_id) -> object
delete/v1/groups/{group_id}
ModelsExpand Collapse
class DynamicManager: …
manager_agent_id: str
manager_type: Optional[Literal["dynamic"]]
Accepts one of the following:
"dynamic"
max_turns: Optional[int]
termination_token: Optional[str]
class Group: …
id: str

The id of the group. Assigned by the database.

agent_ids: List[str]
description: str
manager_type: ManagerType
Accepts one of the following:
"round_robin"
"supervisor"
"dynamic"
"sleeptime"
"voice_sleeptime"
"swarm"
base_template_id: Optional[str]

The base template id.

deployment_id: Optional[str]

The id of the deployment.

hidden: Optional[bool]

If set to True, the group will be hidden.

last_processed_message_id: Optional[str]
manager_agent_id: Optional[str]
max_message_buffer_length: Optional[int]

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.

max_turns: Optional[int]
min_message_buffer_length: Optional[int]

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: Optional[str]

The associated project id.

Deprecatedshared_block_ids: Optional[List[str]]
sleeptime_agent_frequency: Optional[int]
template_id: Optional[str]

The id of the template.

termination_token: Optional[str]
turns_counter: Optional[int]
ManagerType = Literal["round_robin", "supervisor", "dynamic", 3 more]
Accepts one of the following:
"round_robin"
"supervisor"
"dynamic"
"sleeptime"
"voice_sleeptime"
"swarm"
class RoundRobinManager: …
manager_type: Optional[Literal["round_robin"]]
Accepts one of the following:
"round_robin"
max_turns: Optional[int]
class SleeptimeManager: …
manager_agent_id: str
manager_type: Optional[Literal["sleeptime"]]
Accepts one of the following:
"sleeptime"
sleeptime_agent_frequency: Optional[int]
class SupervisorManager: …
manager_agent_id: str
manager_type: Optional[Literal["supervisor"]]
Accepts one of the following:
"supervisor"
class VoiceSleeptimeManager: …
manager_agent_id: str
manager_type: Optional[Literal["voice_sleeptime"]]
Accepts one of the following:
"voice_sleeptime"
max_message_buffer_length: Optional[int]

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: Optional[int]

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.

GroupsMessages

Create Group Message
groups.messages.create(strgroup_id, MessageCreateParams**kwargs) -> LettaResponse
post/v1/groups/{group_id}/messages
List Group Messages
groups.messages.list(strgroup_id, MessageListParams**kwargs) -> SyncArrayPage[Message]
get/v1/groups/{group_id}/messages
Create Group Message Streaming
groups.messages.stream(strgroup_id, MessageStreamParams**kwargs) -> object
post/v1/groups/{group_id}/messages/stream
Update Group Message
groups.messages.update(strmessage_id, MessageUpdateParams**kwargs) -> MessageUpdateResponse
patch/v1/groups/{group_id}/messages/{message_id}
Reset Group Messages
groups.messages.reset(strgroup_id) -> object
patch/v1/groups/{group_id}/reset-messages