Position and phase update
Sent by the desktop client at the pilot’s chosen position-update interval (currently 15, 30, or 60 seconds) while a flight is active. Each call appends a FLIGHT_PATH point to the PIREP and updates the PIREP’s status based on the reported phase.
The server maps Stratos flight phases to phpVMS PIREP statuses:
| Stratos phase | phpVMS status |
|---|---|
boarding | BOARDING |
push_back | PUSHBACK_TOW |
taxi | TAXI |
take_off | TAKEOFF |
rejected_take_off | TAXI |
climb / cruise | ENROUTE |
descent | APPROACH |
approach | APPROACH_ICAO |
final | LANDING |
landed / taxi_in | LANDED |
go_around | APPROACH |
arrived / deboarding | ARRIVED |
The first update that transitions into a takeoff/climb/cruise status sets block_off_time. The first update transitioning into LANDED/ARRIVED sets block_on_time. The server’s running flight time is recomputed from the first ACARS row’s created_at each update.
Either uuid or tracking_id may carry the PIREP ID (the client uses them interchangeably).
Authorizations
The pilot's API key, obtained via POST /pilot/login or your OAuth flow. Send as Authorization: Bearer <api_key> on every authenticated request.
Body
Current flight phase. Unknown values are treated as cruise (PirepStatus::ENROUTE) by the reference implementation.
boarding, push_back, taxi, take_off, rejected_take_off, climb, cruise, descent, approach, final, landed, go_around, taxi_in, arrived, deboarding -90 <= x <= 90-180 <= x <= 180Indicated altitude in feet.
True heading in degrees.
0 <= x <= 360PIREP ID returned by /flights/start. Use either this or tracking_id.
Synonym for uuid — supplied for backwards compatibility.
Ground speed in knots. Defaults to 0 if omitted.
Nautical miles remaining to destination. Used to compute the cumulative distance written to the FLIGHT_PATH row.
Response
Update accepted. The reference implementation returns an empty body.
The response is of type object.