Flights
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Flightflight
A flight the user or someone they know is taking or took.
flights_queryFlightsDashboardFindthrough vritto_findList all non-archived flights (newest serviceDate first) with route, date, and status. Rows are compact summaries plus headline counts; pass detail 'full' only when the user needs UTC times, terminals/gates, confirmation codes, distanceKm, or costs. Use for any flight question. Do not call this just to fetch an ID for a write.
| Field | Type | Description |
|---|---|---|
| detail | one of summary, full | Response shape: "summary" (default, headline counts + compact flight rows) or "full" (every field incl. UTC times, airport objects, terminals/gates, confirmation codes, distanceKm, costs). |
flights_upsertFlightCreate or Updatethrough vritto_create or vritto_updateCreate or update one flight. Omit record.id to create (airlineIata + flightNumber + serviceDate required); include a real record.id to update, sent fields merge. Pass local times; the server converts via airport zones.
| Field | Type | Description |
|---|---|---|
| record* | object | Flight fields; airlineIata + flightNumber + serviceDate required when creating. |
| record.id | string | Existing flight ID to update. Omit to create. |
| record.source | one of manual, gmail, sahai, import, bank | Where this came from. Leave unset for a manual entry. |
| record.airlineIata | string | Airline code, e.g. 'UA'. Required when creating. |
| record.airlineName | string | e.g. 'United Airlines'. |
| record.flightNumber | string | 1–4 digits plus an optional trailing letter, e.g. '838' or '1234A'. Required when creating. |
| record.serviceDate | string | Departure date, origin-local. Required when creating. |
| record.origin | object | |
| record.destination | object | |
| record.depLocalTime | string | Departure time in the ORIGIN airport's local clock: the server converts to UTC using the airport zone. |
| record.arrLocalTime | string | Arrival time, DESTINATION-local. |
| record.arrLocalDate | string | Arrival date when it differs (red-eyes, date line). |
| record.isMine | boolean | false = tracking someone else's flight (excluded from lifetime stats). |
| record.travelerPersonIds | list of string | |
| record.tripId | string | Trip link (resolve via trips_queryTripsDashboard). |
| record.confirmationCode | string | |
| record.seat | string | |
| record.cabin | one of economy, premium, business, first | |
| record.costAmount | number | |
| record.costCurrency | string | |
| record.status | one of scheduled, delayed, canceled, landed | Only set on explicit user statement; live tracking owns the rest. |
| record.estimatedDepUtc | string | Estimated departure as an ISO instant (offset allowed; stored as UTC), for user-reported delays, e.g. 'now leaving at 9:20' converted via the origin airport's zone. |
| record.estimatedArrUtc | string | Estimated arrival as an ISO instant; convert stated local times via the destination's zone. |
| record.actualDepUtc | string | Actual departure ISO instant, only for flights that really left. |
| record.actualArrUtc | string | Actual arrival ISO instant, e.g. 'we landed at 11:40' converted via the destination's zone. |
| record.aircraftType | string | e.g. 'Boeing 787-9', only when the user states it. |
| record.notes | string |
Example input
{
"record": {
"airlineIata": "UA",
"flightNumber": "1542",
"serviceDate": "2026-10-09",
"confirmationCode": "K7Q2PX",
"seat": "14C"
}
}flights_setTrackingUpdatethrough vritto_updateTurn live status tracking on ('watching') or off for one flight. Resolve the ID first.
| Field | Type | Description |
|---|---|---|
| flightId* | string | Flight ID from a prior flights_queryFlightsDashboard result, never invented. |
| trackingState* | one of off, watching |
flights_deleteFlightDeletethrough vritto_deleteDelete (archive) one flight. Only for explicit removals, a canceled flight should be upserted with status:'canceled' instead. Resolve the ID first.
Note: A canceled flight should be updated with status 'canceled' instead.
| Field | Type | Description |
|---|---|---|
| flightId* | string | Flight ID from a prior flights_queryFlightsDashboard result, never invented. |
Airport Catalogairport_catalog
Airport reference data by name, city, or code.
flights_searchAirportsLook Upthrough vritto_lookupResolve an airport by name, city, or IATA fragment (returns up to 8 with codes and timezones). Use when the user names a city instead of a code.
| Field | Type | Description |
|---|---|---|
| query* | string |