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

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.

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.

Response

Successful Response

messageslist of objects

The messages returned by the agent.

usageobject

The usage statistics of the agent.