Send Group Message

1 curl -X POST https://api.letta.com/v1/groups/ \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "messages": [ 6 { 7 "role": "user", 8 "content": [ 9 {} 10 ] 11 } 12 ] 13 }'

1 { 2 "messages": [ 3 { 4 "id": "foo", 5 "date": "foo", 6 "name": "foo", 7 "message_type": "system_message", 8 "otid": "foo", 9 "sender_id": "foo", 10 "step_id": "foo", 11 "content": "foo" 12 } 13 ], 14 "stop_reason": { 15 "stop_reason": "end_turn", 16 "message_type": "stop_reason" 17 }, 18 "usage": { 19 "message_type": "usage_statistics", 20 "completion_tokens": 0, 21 "prompt_tokens": 0, 22 "total_tokens": 0, 23 "step_count": 0, 24 "steps_messages": [ 25 [ 26 { 27 "role": "assistant", 28 "created_by_id": "foo", 29 "last_updated_by_id": "foo", 30 "created_at": "foo", 31 "updated_at": "foo", 32 "id": "message-123e4567-e89b-12d3-a456-426614174000", 33 "agent_id": "foo", 34 "model": "foo", 35 "content": [ 36 { 37 "type": "omitted_reasoning" 38 } 39 ], 40 "name": "foo", 41 "tool_calls": [ 42 { 43 "id": "foo", 44 "function": { 45 "arguments": "foo", 46 "name": "foo" 47 }, 48 "type": "foo" 49 } 50 ], 51 "tool_call_id": "foo", 52 "step_id": "foo", 53 "otid": "foo", 54 "tool_returns": [ 55 { 56 "status": "success", 57 "stdout": [ 58 "foo" 59 ], 60 "stderr": [ 61 "foo" 62 ] 63 } 64 ], 65 "group_id": "foo", 66 "sender_id": "foo", 67 "batch_item_id": "foo" 68 } 69 ] 70 ], 71 "run_ids": [ 72 "foo" 73 ] 74 } 75 }

Process a user message and return the group's response. This endpoint accepts a message from a user and processes it through through agents in the group based on the specified pattern

Path parameters

group_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Request

This endpoint expects an object.

messageslist of objectsRequired

The messages to be sent to the agent.

max_stepsintegerOptionalDefaults to 50

Maximum number of steps the agent should take to process the request.

use_assistant_messagebooleanOptionalDefaults to true

Whether the server should parse specific tool call arguments (default send_message) as AssistantMessage objects.

assistant_message_tool_namestringOptionalDefaults to send_message

The name of the designated message tool.

assistant_message_tool_kwargstringOptionalDefaults to message

The name of the message argument in the designated message tool.

include_return_message_typeslist of enumsOptional

Only return specified message types in the response. If None (default) returns all messages.

Response

Successful Response

messageslist of objects

The messages returned by the agent.

stop_reasonobject

The stop reason from Letta indicating why agent loop stopped execution.

usageobject

The usage statistics of the agent.