list_flight_runs

Preview

This feature is in preview and is subject to change.

List the runs of a Flight, newest first. Each run has a sequential run_number, a status (PENDING, RUNNING, SUCCEEDED, FAILED, or CANCELLED), timing metadata, and the effective config it ran with: the Flight version's stored config merged with any per-run overrides.

The SQL equivalent is MD_LIST_FLIGHT_RUNS.

Input parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	The Flight UUID.
limit	integer	No	Max results to return (default: 100, max: 500).

Output schema

{
  "success": boolean,
  "flight_id": string,
  "runs": [
    {
      "run_id": string,
      "flight_id": string,
      "flight_name": string,
      "flight_version": number,
      "config": object,         // effective config for the run, including per-run overrides
      "run_number": number,
      "is_scheduled": boolean,
      "status": string,
      "created_at": string,
      "started_at": string,
      "ended_at": string,
      "scheduled_at": string,
      "cancelled_at": string,   // null unless the run was cancelled
      "exit_code": number
    }
  ],
  "count": number,
  "totalCount": number,
  "error": string
}

Example usage

{ "id": "80000000-0000-0000-0000-000000000001", "limit": 10 }

Related

• run_flight — Trigger an on-demand run.
• get_flight_run_logs — Read a run's output.
• cancel_flight_run — Cancel an in-progress run.
• MD_LIST_FLIGHT_RUNS — SQL equivalent.