How the integration works

AirGuard's platform detects drones and their pilots across RF, Remote ID, and radar sensors. The AirGuard-Skydio DFR integration relays those detections straight into the Skydio Drone First Responder (DFR) Command Center, so your DFR operators see a breach the moment it happens.

The integration is a one-way, push-based link from AirGuard to Skydio Cloud, authenticated with a Skydio API token. When a non-whitelisted drone breaches an AirGuard alert zone with Skydio push enabled, AirGuard creates incident markers in Skydio for the drone and, where available, its pilot or remote controller. Marker positions update as the drone moves and are removed automatically once the flight ends or the drone leaves all Skydio-enabled zones.

Administrators keep control at two levels: a master switch that turns the integration on for the account, and a per-zone toggle that decides which individual alert zones are allowed to trigger a Skydio response.

Requirements

Before you start, confirm you have the following in place.

Part one: create an API token in Skydio Cloud

Done once, by an Organization Admin, in Skydio Cloud.

  1. Log in to cloud.skydio.com as an Organization Admin and navigate to Settings.
  2. Under the Developer heading, select API Tokens, then select Generate Token. Name the token (for example, "AirGuard Integration").
  3. Select the appropriate Groups, then set the permission scopes. The token must include the Markers resource with read and write permission.
  4. Select Generate, then copy the token immediately. Once you leave or refresh the page, the token cannot be viewed again.
Skydio Cloud Generate Token screen with Markers permission set to read and write

Skydio Cloud — generating an API token with Markers read/write access.

Note: Store the token somewhere secure until you have entered it in AirGuard. If it is lost, generate a new token and repeat the AirGuard setup with the new value.

Part two: enable the integration in AirGuard

All three steps below are performed by an AirGuard Admin under Settings › Layers.

Step 1 — Turn on the Skydio DFR integration

In AirGuard, open Settings. Under Layers, locate Skydio DFR and switch the toggle ON. The integration is off by default. Turning it on reveals the Skydio Access Token link directly beneath it.

AirGuard Settings, Layers, Skydio DFR toggle in the off position
AirGuard Settings, Layers, Skydio DFR toggle switched on with success confirmation

The Skydio DFR toggle in AirGuard, off by default (left) and enabled (right).

Step 2 — Add your Skydio access token

Select Skydio Access Token, paste the token you copied from Skydio Cloud into the Access Token field, and select Save Token. AirGuard validates the token against the Skydio API before saving it. The Status indicator on this screen reports the result:

StatusMeaning
Not configuredNo token has been saved yet.
Connecting…AirGuard is validating the token with Skydio.
ConnectedThe token is valid and AirGuard can reach Skydio.
ErrorThe token was rejected. See Troubleshooting below.

Once saved, the token is masked and is never displayed again in plain text. To replace it, enter a new token and save again.

Skydio Access Token screen showing Connecting status
Skydio Access Token screen showing Connected status
Skydio Access Token screen showing Invalid or Expired Token error

The Skydio Access Token screen: Connecting, Connected, and an invalid or expired token error.

Step 3 — Choose which alert zones push to Skydio

Enabling the integration does not, on its own, send anything to Skydio. You also have to nominate the zones that should trigger a DFR response. Open the alert zone you want Skydio to respond to, and in the Manage Alert Zone panel, switch Send Skydio DFR Events to ON. Repeat for each additional zone.

Manage Alert Zone panel with Send Skydio DFR Events toggle switched on

The Manage Alert Zone panel, with Send Skydio DFR Events enabled.

The toggle defaults to OFF for every zone, new and existing, and saves as soon as you switch it. Zones with Skydio push enabled are highlighted in orange on the AirGuard map, so operators can see at a glance which zones will launch a response.

AirGuard map showing alert zones highlighted in orange

Alert zones with Skydio push enabled appear in orange on the AirGuard map.

What Skydio operators see

When a non-whitelisted drone breaches a Skydio-enabled alert zone, AirGuard creates the following in the Skydio DFR Command Center:

Markers identify AirGuard as their source. Positions update as the drone moves, and both markers are removed automatically when the flight ends or the drone exits all Skydio-enabled zones.

Validate the integration

  1. On the Skydio Access Token screen in AirGuard, confirm the Status reads Connected.
  2. Confirm your chosen alert zones appear orange on the AirGuard map.
  3. Fly a test drone that is not on the AirGuard whitelist into one of those zones.
  4. In the Skydio DFR Command Center, confirm drone and pilot markers appear and that their positions update as the drone moves.
  5. End the flight and confirm the markers are removed from the Skydio map.

Troubleshooting

Status shows an error immediately, without contacting Skydio

The token does not match the expected format. Re-copy it from Skydio Cloud, checking for leading or trailing spaces introduced by copy and paste.

Status shows a 403 / permission error

The token is valid but lacks the permissions the integration needs, or it has been revoked in Skydio Cloud. Confirm the token's permissions include the Markers resource with read and write access, or generate a replacement token and save it in AirGuard.

Validation times out

AirGuard could not reach the Skydio API within the validation window. Check outbound connectivity to Skydio and try again.

No markers appear in Skydio

Check, in order: the Skydio DFR master switch is ON, Send Skydio DFR Events is ON for the specific zone that was breached, the detected drone is not on the AirGuard whitelist, and the detection is a Layer 1 (RF) detection.

Markers stopped appearing after working previously

The most common cause is a token revoked or rotated in Skydio Cloud. Check the Status on the Skydio Access Token screen and re-save a current token.

Note: If the Skydio API is unavailable, AirGuard detection, alerting, and Records continue to operate normally. Failed pushes are logged and retried, so a transient Skydio outage does not result in lost detections on the AirGuard side.

Scope of this release

Support

For help with AirGuard configuration or this integration, contact the AirSight Support Team at support@airsight.com, or through your AirGuard customer portal.

Resources: cloud.skydio.com · Skydio API documentation