Skip to main content

list_flights

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

List all Flights owned by the caller. Each Flight in the response includes its UUID, name, schedule, status, and current version. Optionally filter by keywords matching the Flight name.

Description​

The list_flights tool returns Flight summary metadata, not version-specific content. Use get_flight with the returned id to fetch source code, requirements, and config.

The corresponding SQL function is MD_LIST_FLIGHTS.

Input parameters​

ParameterTypeRequiredDescription
keywordsstringNoKeywords to filter Flights by name (case-insensitive, all words must match).
limitintegerNoMax results to return (default: 100, max: 500).

Output schema​

{
  "success": boolean,
  "flights": [
    {
      "id": string,                 // Flight UUID
      "name": string,
      "schedule_cron": string|null, // Cron expression or null for on-demand
      "status": string,             // Schedule status (e.g. JOB_STATUS_ACTIVE)
      "current_version": number,
      "created_at": string,         // ISO 8601
      "updated_at": string          // ISO 8601
    }
  ],
  "count": number,
  "error": string                   // On failure
}

Example usage​

What Flights do I have?

The assistant calls the tool with no arguments. To filter:

{ "keywords": "metrics" }