runs

List Active Runs

Changed on

List all active runs.

get/v1/runs/active

Request

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

Query parameters

agent_idstring nullable

The unique identifier of the agent associated with the run.

backgroundboolean nullable

If True, filters for runs that were created in background mode.

Response

Successful Response

idstring

The human-friendly ID of the Run

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

Status of the run.

created_atstring date-time

The timestamp when the run was created.

completed_atstring date-time nullable

The timestamp when the run was completed.

agent_idstring required

The unique identifier of the agent associated with the run.

backgroundboolean nullable

Whether the run was created in background mode.

metadataobject nullable

Additional metadata for the run.

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

If set, POST to this URL when the run 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

Example response

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

Changes

  • ac8e1eb68404Revision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      the response property / became required for the status

    • info

      removed the expired enum value from the / response property for the response status

    • info

      removed the pending enum value from the / response property for the response status

    • info

      response property items/agent_id list-of-types was narrowed by removing types null from media type application/json of response 200

  • 3a2d48137c08Revision changes
    • warning

      deleted the query request parameter agent_ids

    • info

      added the new optional query request parameter agent_id

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status