jobs

List Jobs

Changed on

List all jobs.

get/v1/jobs/

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/jobs/
  • Auth
    HTTP bearer

Query parameters

source_idstring nullable

Only list jobs associated with the source.

beforestring nullable

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

afterstring nullable

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

limitinteger nullable

Maximum number of jobs to return

order'asc' | 'desc'

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

order_by'created_at'

Field to sort by

activeboolean

Filter for active jobs.

ascendingboolean

Whether to sort jobs oldest to newest (True, default) or newest to oldest (False). Deprecated in favor of order field.

Response

Successful Response

created_by_idstring nullable

The id of the user that made this object.

last_updated_by_idstring nullable

The id of the user that made this object.

created_atstring date-time

The unix timestamp of when the job was created.

updated_atstring date-time nullable

The timestamp when the object was last updated.

status'created' | 'running' | 'completed' | 'failed' | 'pending' | 'cancelled' | 'expired'

Status of the job.

completed_atstring date-time nullable

The unix timestamp of when the job was completed.

stop_reason'end_turn' | 'error' | 'llm_api_error' | 'invalid_llm_response' | 'invalid_tool_call' | 'max_steps' | 'no_tool_call' | 'tool_rule' | 'cancelled' | 'requires_approval'
metadataobject nullable

The metadata of the job.

job_type'job' | 'run' | 'batch'
backgroundboolean nullable

Whether the job was created in background mode.

agent_idstring nullable

The agent associated with this job/run.

callback_urlstring nullable

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

callback_sent_atstring date-time nullable

Timestamp when the callback was last attempted.

callback_status_codeinteger nullable

HTTP status code returned by the callback endpoint.

callback_errorstring nullable

Optional error message from attempting to POST the callback endpoint.

ttft_nsinteger nullable

Time to first token for a run in nanoseconds

total_duration_nsinteger nullable

Total run duration in nanoseconds

idstring

The human-friendly ID of the Job

Example response

[
  {
    "id": "job-123e4567-e89b-12d3-a456-426614174000"
  }
]

Changes

  • fc99babce774Revision changes
    • breaking

      for the query request parameter limit, default value was changed from 50 to 100

    • info

      added the new optional query request parameter order

    • info

      added the new optional query request parameter order_by

    • info

      query request parameter ascending was deprecated

  • 3a2d48137c08Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status