List Batches

batches.list() -> SyncArrayPage[BatchJob]

get/v1/messages/batches

List all batch runs.

ParametersExpand Collapse

after: Optional[str]

Job ID cursor for pagination. Returns jobs that come after this job ID in the specified sort order

before: Optional[str]

Job ID cursor for pagination. Returns jobs that come before this job ID in the specified sort order

limit: Optional[int]

Maximum number of jobs to return

order: Optional[Literal["asc", "desc"]]

Sort order for jobs by creation time. 'asc' for oldest first, 'desc' for newest first

Accepts one of the following:

"asc"

"desc"

order_by: Optional[Literal["created_at"]]

Field to sort by

Accepts one of the following:

"created_at"

ReturnsExpand Collapse

class BatchJob: …

id: str

The human-friendly ID of the Job

agent_id: Optional[str]

The agent associated with this job/run.

background: Optional[bool]

Whether the job was created in background mode.

callback_error: Optional[str]

Optional error message from attempting to POST the callback endpoint.

callback_sent_at: Optional[datetime]

Timestamp when the callback was last attempted.

formatdate-time

callback_status_code: Optional[int]

HTTP status code returned by the callback endpoint.

callback_url: Optional[str]

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

completed_at: Optional[datetime]

The unix timestamp of when the job was completed.

formatdate-time

created_at: Optional[datetime]

The unix timestamp of when the job was created.

formatdate-time

created_by_id: Optional[str]

The id of the user that made this object.

job_type: Optional[JobType]

Accepts one of the following:

"job"

"run"

"batch"

last_updated_by_id: Optional[str]

The id of the user that made this object.

metadata: Optional[Dict[str, object]]

The metadata of the job.

status: Optional[JobStatus]

The status of the job.

Accepts one of the following:

"created"

"running"

"completed"

"failed"

"pending"

"cancelled"

"expired"

stop_reason: Optional[StopReasonType]

The reason why the job was stopped.

Accepts one of the following:

"end_turn"

"error"

"llm_api_error"

"invalid_llm_response"

"invalid_tool_call"

"max_steps"

"no_tool_call"

"tool_rule"

"cancelled"

"requires_approval"

total_duration_ns: Optional[int]

Total run duration in nanoseconds

ttft_ns: Optional[int]

Time to first token for a run in nanoseconds

updated_at: Optional[datetime]

The timestamp when the object was last updated.

formatdate-time

List Batches

from letta_client import Letta

client = Letta(
    api_key="My API Key",
)
page = client.batches.list()
page = page.items[0]
print(page.id)

[
  {
    "id": "job-123e4567-e89b-12d3-a456-426614174000",
    "agent_id": "agent_id",
    "background": true,
    "callback_error": "callback_error",
    "callback_sent_at": "2019-12-27T18:11:19.117Z",
    "callback_status_code": 0,
    "callback_url": "callback_url",
    "completed_at": "2019-12-27T18:11:19.117Z",
    "created_at": "2019-12-27T18:11:19.117Z",
    "created_by_id": "created_by_id",
    "job_type": "job",
    "last_updated_by_id": "last_updated_by_id",
    "metadata": {
      "foo": "bar"
    },
    "status": "created",
    "stop_reason": "end_turn",
    "total_duration_ns": 0,
    "ttft_ns": 0,
    "updated_at": "2019-12-27T18:11:19.117Z"
  }
]

Returns Examples

[
  {
    "id": "job-123e4567-e89b-12d3-a456-426614174000",
    "agent_id": "agent_id",
    "background": true,
    "callback_error": "callback_error",
    "callback_sent_at": "2019-12-27T18:11:19.117Z",
    "callback_status_code": 0,
    "callback_url": "callback_url",
    "completed_at": "2019-12-27T18:11:19.117Z",
    "created_at": "2019-12-27T18:11:19.117Z",
    "created_by_id": "created_by_id",
    "job_type": "job",
    "last_updated_by_id": "last_updated_by_id",
    "metadata": {
      "foo": "bar"
    },
    "status": "created",
    "stop_reason": "end_turn",
    "total_duration_ns": 0,
    "ttft_ns": 0,
    "updated_at": "2019-12-27T18:11:19.117Z"
  }
]