Create Messages Batch

1 from letta_client import Letta, LettaBatchRequest, MessageCreate, TextContent 2 3 client = Letta( 4 token="YOUR_TOKEN", 5 ) 6 client.batches.create( 7 requests=[ 8 LettaBatchRequest( 9 messages=[ 10 MessageCreate( 11 role="user", 12 content=[ 13 TextContent( 14 text="text", 15 ) 16 ], 17 ) 18 ], 19 agent_id="agent_id", 20 ) 21 ], 22 )

1 { 2 "created_by_id": "foo", 3 "last_updated_by_id": "foo", 4 "created_at": "foo", 5 "updated_at": "foo", 6 "status": "not_started", 7 "completed_at": "foo", 8 "metadata": {}, 9 "job_type": "job", 10 "callback_url": "foo", 11 "callback_sent_at": "foo", 12 "callback_status_code": 42, 13 "callback_error": "foo", 14 "id": "job-123e4567-e89b-12d3-a456-426614174000" 15 }

Submit a batch of agent messages for asynchronous processing. Creates a job that will fan out messages to all listed agents and process them in parallel.

Request

This endpoint expects an object.

requestslist of objectsRequired

List of requests to be processed in batch.

callback_urlstringOptionalformat: "uri">=1 character<=2083 characters

Optional URL to call via POST when the batch completes. The callback payload will be a JSON object with the following fields: {‘job_id’: string, ‘status’: string, ‘completed_at’: string}. Where ‘job_id’ is the unique batch job identifier, ‘status’ is the final batch status (e.g., ‘completed’, ‘failed’), and ‘completed_at’ is an ISO 8601 timestamp indicating when the batch job completed.

Response

Successful Response

created_by_idstring or null

The id of the user that made this object.

last_updated_by_idstring or null

The id of the user that made this object.

created_atstring or nullformat: "date-time"

The timestamp when the object was created.

updated_atstring or nullformat: "date-time"

The timestamp when the object was last updated.

statusenum or null

The status of the job.

completed_atstring or nullformat: "date-time"

The unix timestamp of when the job was completed.

metadataobject or null

The metadata of the job.

job_typeenum or null

Allowed values:

callback_urlstring or null

If set, POST to this URL when the job completes.

callback_sent_atstring or nullformat: "date-time"

Timestamp when the callback was last attempted.

callback_status_codeinteger or null

HTTP status code returned by the callback endpoint.

callback_errorstring or null

Optional error message from attempting to POST the callback endpoint.

idstring or nullformat: "^(job|run)-[a-fA-F0-9]{8}"

The human-friendly ID of the Job

Headers

Request

Response