BRbrumby
flights

Farm Flights

Every flight of every dock ever installed at this farm, newest first.

THE FARM IS THE INSTALLATION, NOT THE DIRECTORY. There is no 404 for an unknown farm here: installations carry the farm key in two spellings and some of them name a GrazeMate farm FleetOps' own directory has never seen (services/farm_keys), so "no rows" is the honest answer to both an empty farm and a farm id nobody recognises.

Paging is keyset: pass the cursor from the previous page's last flight. The token is base64url("<started_at>|<flight_id>") and both halves are in every row, so a client that dropped it can rebuild it.

get/api/v1/farms/{farm_id}/flights

Request

  • Base URL
    https://api.brumby.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.brumby.com/api/v1/farms/{farm_id}/flights
  • Auth
    HTTP bearer

Path parameters

farm_idstring required

Query parameters

limitinteger
cursorstring nullable

Response

Successful Response

flight_idstring uuid required
device_idstring required
boot_idstring uuid required
aircraft_idstring nullable required
farm_idstring nullable
installation_idstring uuid nullable
mission_request_idstring uuid nullable
mission_idstring nullable
requested_bystring nullable
launched_bystring nullable
mission_config_sha256string nullable
attribution_sourcestring nullable
customer_schedule_idinteger nullable
requested_by_account_idinteger nullable
started_atstring date-time required
ended_atstring date-time nullable required
outcome'in_progress' | 'completed' | 'recalled' | 'interrupted' | 'unknown' | 'sim_ended' required

How a materialized flight ended.

unknown is honest, not lazy: operations went stale mid-flight, so the dock-side truth was never observed. interrupted is a dock reboot while the flight row was open. sim_ended is a SIMULATED flight whose simulation was ended -- by the operator, a failure, or a runner that stopped reporting -- while the flight was open: the aircraft did not land, it stopped existing, and saying "completed" or "unknown" would each be a lie of a different kind. Only services/sim_runs.close_out writes it. No migration: enum_type is a plain String(20).

end_reasonstring nullable required
record_idstring nullable
run_idsstring[]
media_countinteger

Changes

No recorded changes to this operation across all 1 revision of this API.