Launch ADE
DocumentationADE GuideSelf-HostingLetta CloudAPI ReferenceExamplesLeaderboard
DocumentationADE GuideSelf-HostingLetta CloudAPI ReferenceExamplesLeaderboard
    • Chat on Discord
    • Developer Forum
    • DeepLearning.AI Course
  • API Reference
    • API and SDK Overview
    • Changelog
  • agents
    • GETList Agents
    • GETRetrieve Agent
    • POSTCreate Agent
    • PATCHModify Agent
    • DELDelete Agent
    • GETCount Agents
    • POSTImport Agent
    • GETExport Agent
    • POSTSearch Agents
  • models
    • GETList LLM Models
    • GETList Embedding Models
  • blocks
    • GETList Blocks
    • GETRetrieve Block
    • POSTCreate Block
    • PATCHModify Block
    • DELDelete Block
    • GETCount Blocks
  • identities
    • GETList Identities
    • GETRetrieve Identity
    • POSTCreate Identity
    • PUTUpsert Identity
    • PATCHModify Identity
    • DELDelete Identity
    • GETCount Identities
  • tools
    • GETRetrieve Tool
    • DELDelete Tool
    • PATCHModify Tool
    • GETCount Tools
    • GETList Tools
    • POSTCreate Tool
    • PUTUpsert Tool
    • POSTUpsert Base Tools
    • POSTRun Tool From Source
    • GETList Composio Apps
    • GETList Composio Actions By App
    • POSTAdd Composio Tool
    • GETList MCP Servers
    • PUTAdd MCP Server To Config
    • GETList MCP Tools By Server
    • POSTAdd MCP Tool
    • DELDelete MCP Server From Config
    • PATCHUpdate MCP Server
    • POSTTest MCP Server
    • STREAMConnect MCP Server
  • folders
    • GETList Folders
    • GETRetrieve Folder
    • POSTCreate Folder
    • PATCHModify Folder
    • DELDelete Folder
    • GETCount Folders
    • GETGet Folder By Name
    • GETRetrieve Metadata
  • jobs
    • GETList Jobs
    • GETList Active Jobs
    • GETRetrieve Job
    • DELDelete Job
    • PATCHCancel Job
  • runs
    • GETList Runs
    • GETList Active Runs
    • GETRetrieve Run
    • DELDelete Run
    • STREAMRetrieve Stream
  • steps
    • GETList Steps
    • GETRetrieve Step
  • groups
    • GETList Groups
    • GETRetrieve Group
    • POSTCreate Group
    • PATCHModify Group
    • DELDelete Group
    • GETCount Groups
  • providers
    • GETList Providers
    • GETRetrieve Provider
    • POSTCreate Provider
    • PATCHModify Provider
    • DELDelete Provider
    • POSTCheck Provider
  • Tags
    • GETList Tags
  • Batches
    • GETList Batches
    • GETRetrieve Batch
    • POSTCreate Batch
    • PATCHCancel Batch
  • voice
    • POSTCreate Voice Chat Completions
  • health
    • GETCheck Health
  • projects
    • GETList Projects (Cloud-only)
  • templates
    • POSTCreate agents from a template (Cloud-only)
    • GETList templates (Cloud-only)
    • POSTSave template version (Cloud-only)
    • DELDelete template (Cloud-only)
    • GETGet template snapshot (Cloud-only)
    • PUTSet current template from snapshot (Cloud-only)
    • POSTFork template (Cloud-only)
    • POSTCreate template (Cloud-only)
    • PATCHRename template (Cloud-only)
    • PATCHUpdate template description (Cloud-only)
    • GETList template versions (Cloud-only)
    • POSTMigrate deployment to template version (Cloud-only)
    • PUTUpdate current template from agent file (Cloud-only)
  • Client Side Access Tokens
    • GETList tokens (Cloud-only)
    • POSTCreate token (Cloud-only)
    • DELDelete token (Cloud-only)
  • telemetry
    • GETRetrieve Provider Trace
  • sources
    • GETList Sources
    • GETRetrieve Source
    • POSTCreate Source
    • PATCHModify Source
    • DELDelete Source
    • GETCount Sources
    • GETGet Source Id By Name
    • GETGet Sources Metadata
    • GETGet Agents For Source
    • GETGet File Metadata
    • POSTUpload File To Source
    • GETList Source Files
    • DELDelete File From Source
    • GETList Source Passages
  • archives
    • GETList Archives
    • POSTCreate Archive
    • PATCHModify Archive
Launch ADE
LogoLogo
BatchesMessages

GET
/v1/messages/batches/:batch_id/messages
GET
/v1/messages/batches/:batch_id/messages
1curl https://api.letta.com/v1/messages/batches/batch_id/messages \
2 -H "Authorization: Bearer <token>"
Try it
200Retrieved
1{
2 "messages": [
3 {
4 "role": "assistant",
5 "created_by_id": "string",
6 "last_updated_by_id": "string",
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": "string",
11 "model": "string",
12 "content": [
13 {
14 "type": "omitted_reasoning"
15 }
16 ],
17 "name": "string",
18 "tool_calls": [
19 {
20 "id": "string",
21 "function": {
22 "arguments": "string",
23 "name": "string"
24 },
25 "type": "string"
26 }
27 ],
28 "tool_call_id": "string",
29 "step_id": "string",
30 "run_id": "string",
31 "otid": "string",
32 "tool_returns": [
33 {
34 "status": "success",
35 "stdout": [
36 "string"
37 ],
38 "stderr": [
39 "string"
40 ]
41 }
42 ],
43 "group_id": "string",
44 "sender_id": "string",
45 "batch_item_id": "string",
46 "is_err": true,
47 "approval_request_id": "string",
48 "approve": true,
49 "denial_reason": "string"
50 }
51 ]
52}
Was this page helpful?
Previous

Create Voice Chat Completions

Next
Built with
Get response messages for a specific batch job.
List Messages For Batch

Path parameters

batch_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

beforestring or nullOptional
Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
afterstring or nullOptional
Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
limitinteger or nullOptionalDefaults to 100
Maximum number of messages to return
orderenumOptionalDefaults to desc
Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
Allowed values:
order_by"created_at"OptionalDefaults to created_at
Field to sort by
agent_idstring or nullOptional
Filter messages by agent ID

Response

Successful Response
messageslist of objects

Errors

Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
Maximum number of messages to return
Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
Field to sort by
Filter messages by agent ID
Successful Response