Skip to main content

update_flight

Update a Flight. Any subset of name, source_code, requirements_txt, schedule_cron, config, access_token_name, flight_secret_names, max_runtime_sec, instance_type, or metadata may be provided.

Updates to source_code, requirements_txt, config, flight_secret_names, access_token_name, max_runtime_sec, instance_type, or the chart in metadata produce a new FlightVersion. Updates to name or schedule_cron are metadata-only. Sending the chart the Flight already has does not create a version.

You are responsible for the code you run and the packages it installs. Flights does not scan customer code or dependencies. Avoid untrusted packages, pin dependency versions, and treat dependency installs as a supply-chain risk.

Description​

update_flight is a PATCH operation: omitted fields are left unchanged. To clear the schedule, pass schedule_cron as an empty string; omitting it leaves the schedule unchanged.

config and flight_secret_names are full replacements — to change one entry, send the full map or list with the change applied.

The SQL equivalent is MD_UPDATE_FLIGHT.

Input parameters​

ParameterTypeRequiredDescription
idstring (UUID)YesThe Flight UUID.
namestringNoUpdated Flight name. Metadata-only.
schedule_cronstringNoUpdated 5-field cron expression (UTC). Pass "" to clear the schedule. Metadata-only.
source_codestringNoUpdated Python entrypoint source. Bumps the version.
requirements_txtstringNoUpdated requirements.txt contents. Bumps the version.
configobjectNoReplacement config map (full replace). Bumps the version.
access_token_namestringNoUpdated MotherDuck access token label. Bumps the version.
flight_secret_namesstring[]NoReplacement list of secret names (full replace). Bumps the version.
metadataobjectNoFlight control metadata. The only supported key is chart: the run chart for the Flight Explainer, as raw Mermaid. Limited to 64 KiB as UTF-8. Pass "" to clear the chart. Bumps the version when the chart changes.
max_runtime_secintegerNoPer-run timeout in seconds. 0 means no timeout. A value above your plan's cap is rejected. Bumps the version.
instance_typestringNoInstance size: F4, F16, or F32. A size above your plan's cap is rejected. Bumps the version.

Output schema​

{
"success": boolean,
"flight": {
"id": string,
"name": string,
"schedule_cron": string|null,
"current_version": number
},
"error": string
}

Example usage​

Rename only:

{ "id": "80000000-...", "name": "analytics_hourly_sync" }

Update source (bumps version):

{
"id": "80000000-...",
"source_code": "def main():\n print('v2')\n\nif __name__ == \"__main__\":\n main()\n"
}

Clear the schedule:

{ "id": "80000000-...", "schedule_cron": "" }