> ## Documentation index
> Fetch the complete documentation index at: https://dronebundle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# scan.failed

> Received when a drone map could not be made.

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_id** `string`

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

**event** `string`

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

**timestamp** `number`

Unix timestamp (milliseconds) when the event was delivered.

**workspace_id** `string`

The workspace where the event occurred.

**data** `object`

The map that failed.

**id** `string`

Unique identifier for the map.

**name** `string`

Map name.

**profile** `string`

What the map produces. One of: `map` (measurable 2D map), `map3d` (2D map plus a textured 3D model), `thermal` (thermal map).

**status** `string`

Map status. Always `failed` for this event.

**project_id** `string`

The project the map belongs to.

**job_id** `string`

The job whose photos the map is made from.

**project_name** `string`

Project name when the map was started.

**job_name** `string`

Job name when the map was started.

**photo_count** `number`

Number of photos sent for processing.

**created** `number`

Unix timestamp (milliseconds) when the map was started.

**updated** `number`

Unix timestamp (milliseconds) when the map was last updated.

**created_by** `object`

The user who started the map.

**type** `string`

Either `user` or `api_key`.

**id** `string`

User ID or API key ID.

**started_at** `number`

Unix timestamp (milliseconds) when processing started.

**finished_at** `number`

Unix timestamp (milliseconds) when processing ended.

**total_seconds** `number`

How long processing took, in seconds.

**error** `string`

What went wrong, in plain words.

**error_stage** `string`

The step the map was in when it failed (e.g., `provisioning` or `processing`).

### Example response

```json Example Payload
{
  "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"
  }
}
```

Web version: https://dronebundle.com/docs/webhooks/scan-failed
