Alerts

Term Definitions

Alert: An event that occurred during a mission. Examples include failure to takeoff and subject detection.

Mission Result: Outcome of Mission that generated Alert, if alert_type is MISSION_INCOMPLETE. See Mission Results for a detailed list of possible values.

Webhook: Real-time data sent when an event occurs.

Webhook Url: The url which the webhook data is sent to.

Alert: A notification that triggers upon certain events.

Org-wide Alert: A notification that triggers when certain events occur on any device in the organization.

Alert Target: A device that will cause the alert to trigger when certain events occur on that specific device.

Alert Types

Alert TypeDescription
HUMAN_DETECTEDA human was detected
MISSION_INCOMPLETEMission was interrupted and did not successfully complete all actions
DOCK_ERRORError occurred
SCHEDULED_MISSION_FAILED_TAKEOFFScheduled mission failed to launch
FLIGHT_STATUSFlight started or ended
WAYPOINT_PROGRESSVehicle progressed through a mission waypoint
ONLINE_STATUSDevice became online or offline
MEDIA_FILE_AVAILABLEFlight media file successfully uploaded
MEDIA_AVAILABLE_FOR_SCANAll media files for a scan successfully uploaded
TELEMETRY_AVAILABLEFlight telemetry log is available
LIVE_STREAM_STATUS_CHANGEDLive Stream started or ended
MEDIA_AVAILABLE_FOR_FLIGHTAll media files for a flight successfully uploaded

Example code

These samples use our example Python client

View any alerts fired by a vehicle

alert_resp = client.get("/v0/alerts_history", params={"vehicle_serial": "Skydio2-1234"})