List Batch Messages

1 curl https://api.letta.com/v1/messages/batches/ \ 2 -H "Authorization: Bearer <token>"

1 { 2 "messages": [ 3 { 4 "role": "assistant", 5 "created_by_id": "foo", 6 "last_updated_by_id": "foo", 7 "created_at": "foo", 8 "updated_at": "foo", 9 "id": "message-123e4567-e89b-12d3-a456-426614174000", 10 "agent_id": "foo", 11 "model": "foo", 12 "content": [ 13 { 14 "type": "omitted_reasoning" 15 } 16 ], 17 "name": "foo", 18 "tool_calls": [ 19 { 20 "id": "foo", 21 "function": { 22 "arguments": "foo", 23 "name": "foo" 24 }, 25 "type": "foo" 26 } 27 ], 28 "tool_call_id": "foo", 29 "step_id": "foo", 30 "otid": "foo", 31 "tool_returns": [ 32 { 33 "status": "success", 34 "stdout": [ 35 "foo" 36 ], 37 "stderr": [ 38 "foo" 39 ] 40 } 41 ], 42 "group_id": "foo", 43 "sender_id": "foo", 44 "batch_item_id": "foo" 45 } 46 ] 47 }

Get messages for a specific batch job.

Returns messages associated with the batch in chronological order.

Pagination:

For the first page, omit the cursor parameter
For subsequent pages, use the ID of the last message from the previous response as the cursor
Results will include messages before/after the cursor based on sort_descending

Path parameters

batch_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

limitintegerOptionalDefaults to 100

Maximum number of messages to return

cursorstringOptional

Message ID to use as pagination cursor (get messages before/after this ID) depending on sort_descending.

agent_idstringOptional

Filter messages by agent ID

sort_descendingbooleanOptionalDefaults to true

Sort messages by creation time (true=newest first)

Response

Successful Response

messageslist of objects