Maps

scan.failed

Received when a drone map could not be made.

{
  "delivery_id": "019d5a10-3c42-7d81-9b6e-2f4c8a1e7d90",
  "event": "scan.failed",
  "timestamp": 1775201234567,
  "workspace_id": "01986573-8d04-72fc-85b3-573c77a18511",
  "data": {
    "id": "019d5a0e-77a1-7c2b-8f30-6d2e9b4c1a55",
    "name": "Building A roof",
    "profile": "map3d",
    "status": "failed",
    "project_id": "01964c6b-7a3e-7f00-8000-abc123def456",
    "job_id": "019d4350-a1b2-7c3d-8e4f-567890abcdef",
    "project_name": "Westfield Bridge Inspection",
    "job_name": "Roof Inspection - Building A",
    "photo_count": 412,
    "created": 1775198400000,
    "updated": 1775199100000,
    "created_by": {
      "type": "user",
      "id": "03144892-6021-705a-08f2-8e147cff3f28"
    },
    "started_at": 1775198460000,
    "finished_at": 1775199100000,
    "total_seconds": 640,
    "error": "The processing machine stopped unexpectedly.",
    "error_stage": "processing"
  }
}

Event triggered when a drone map stops with an error. The error field says what went wrong. Processing credits for a failed map are refunded.

Response Body Parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

delivery_idstring

Unique identifier for this delivery. Use this to deduplicate events.

eventstring

The event type that triggered the webhook (e.g., scan.failed).

timestampnumber

Unix timestamp (milliseconds) when the event was delivered.

workspace_idstring

The workspace where the event occurred.

dataobject

The map that failed.