Skip to main content

get_flight

Preview
This feature is in preview and is subject to change.

Fetch a single Flight. Returns Flight metadata plus the content of a specific version (source code, requirements, config, secret names, token name). Omit version for the current version; pass a 1-indexed version to inspect history.

Description​

The get_flight tool combines metadata and version content into one response, so the assistant does not need separate calls for "find the Flight" and "read its source." Use it to inspect a Flight before editing, or to read the source that ran for a specific past run.

The SQL equivalent is MD_GET_FLIGHT plus MD_GET_FLIGHT_VERSION.

Input parameters​

ParameterTypeRequiredDescription
idstring (UUID)YesThe Flight UUID.
versionintegerNo1-indexed version number. Omit for the current version.

Output schema​

{
  "success": boolean,
  "flight": {
    "id": string,
    "name": string,
    "schedule_cron": string|null,
    "status": string,
    "current_version": number,
    "version": {
      "version": number,
      "source_code": string,
      "requirements_txt": string,
      "config": { "<key>": "<value>" },
      "md_token_name": string,
      "md_secret_names": string[]
    },
    "created_at": string,
    "updated_at": string
  },
  "error": string
}

Example usage​

Inspect the current Flight:

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

Inspect version 2:

{ "id": "80000000-0000-0000-0000-000000000001", "version": 2 }