agents

List Agent Groups

Changed on

Lists the groups for an agent

get/v1/agents/{agent_id}/groups

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/agents/{agent_id}/groups
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Query parameters

manager_typestring nullable

Manager type to filter groups by

beforestring nullable

Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order

afterstring nullable

Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order

limitinteger nullable

Maximum number of groups to return

order'asc' | 'desc'

Sort order for groups by creation time. 'asc' for oldest first, 'desc' for newest first

order_by'created_at'

Field to sort by

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

  • 033b3ae64bd8Revision changes
    • info

      added the new optional query request parameter after

    • info

      added the new optional query request parameter before

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter order

    • info

      added the new optional query request parameter order_by