List Batch Messages

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

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

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

Path parameters

Headers

Query parameters

Response

Errors