list_flight_versions

Preview

This feature is in preview and is subject to change.

List every immutable version of a Flight, newest first. Each update to source_code, requirements_txt, config, md_token_name, or md_secret_names produces a fresh version. Updates to name or schedule_cron are metadata-only and do not appear here.

Description

Use list_flight_versions to browse what changed between versions, or to find the version a specific run executed. The corresponding SQL function is MD_LIST_FLIGHT_VERSIONS.

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,
  "versions": [
    {
      "version": number,
      "source_code": string,
      "requirements_txt": string,
      "md_token_name": string,
      "md_secret_names": string[],
      "config": { "<key>": "<value>" },
      "created_at": string
    }
  ],
  "count": number,
  "error": string
}

Example usage

{ "id": "80000000-0000-0000-0000-000000000001" }

Related

• get_flight — Fetch one version's full content.
• list_flight_runs — Runs reference the version they used.
• MD_LIST_FLIGHT_VERSIONS — SQL equivalent.