← RETURN TO OPERATIONS HUB
REST API DOCS [VERSION 1.0]

Integration Spec

The PAN API provides a secure, event-driven interface for Autonomous Vehicle fleets to instantly trigger hyper-local, physical interventions. Integrate M2H dispatch directly into your existing fleet management dashboard.

🔒

Zero-Trust Ephemeral Access

PAN acts as a secure courier for your digital keys. Using our asset_access payload, you generate a Time-Boxed JWT. The PAN app locks this token directly into the Agent's hardware Secure Enclave. The key mathematically self-destructs after 30 minutes, or the moment the agent's BLE signal drops beyond 100 feet of the asset.

POST [https://api.proxyagent.network/v1/dispatch/mission](https://api.proxyagent.network/v1/dispatch/mission)

Initiate a geographic reverse-auction to dispatch the nearest qualified Vanguard Agent to a stranded asset.

{
  "fleet_id": "waymo_mesa_01",
  "vehicle_id": "W-7492",
  "fault_code": "sensor_cleaning",
  "max_bounty_usd": 50.00,
  "location": {
    "latitude": 33.415031,
    "longitude": -111.831492,
    "intersection_hint": "E Main St & S Macdonald"
  },
  // Ephemeral Key Handshake
  "asset_access": {
    "requires_unlock": true,
    "ephemeral_key_token": "eyJhbGciOiJIUzI1NiIs...",
    "allowed_actions": ["unlock_doors", "trunk_access"],
    "expiry_minutes": 30,
    "geo_revoke_distance_feet": 100
  }
}
ParameterDescription
vehicle_idstring, required Your internal tracking ID for the stranded asset. This ensures audit logs tie directly to your database.
fault_codestring, required The task type. Must map to one of our 12 standard tiers (e.g. door_securing, sensor_cleaning). Filters agent dispatch pool.
max_bounty_usdfloat, required The maximum L402 escrow payout authorized. PAN's reverse-auction will attempt to fill the contract below this threshold.
ephemeral_key_tokenstring, optional A secure JWT generated by your servers. This will be transmitted via UWB/BLE from the Agent's TPM enclave to unlock the physical asset on-site.
WEBHOOK [https://api.yourfleet.com/pan-callbacks](https://api.yourfleet.com/pan-callbacks)

PAN utilizes an event-driven architecture. We push real-time mission state changes directly to your listener endpoints so you do not need to poll our servers.

{
  "event_id": "evt_4920184",
  "type": "mission.status_updated",
  "data": {
    "mission_id": "PAN-MSN-98421",
    "vehicle_id": "W-7492",
    "status": "BUSY_ON_SITE",
    "agent": {
      "uid": "AGT-VANGUARD-042",
      "distance_to_asset_meters": 2.4
    },
    "timestamp": "2026-03-10T00:04:12Z"
  }
}

Supported Webhook States:

  • AUCTION_PENDING - Calculating proximity routing and verifying qualifications.
  • BUSY_ON_WAY - Contract accepted. Agent is navigating to coordinates.
  • BUSY_ON_SITE - Agent has arrived and established BLE handshake with asset.
  • COMPLETED - Cryptographic photo proof uploaded. Fleet is cleared to resume ops.