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

# core.document.deleted

> Fired when a document is permanently deleted from Chamelio's Core.

## Event

```
core.document.deleted
```

This event fires when a document is deleted from Core — either via the API or through the Chamelio web application. Deletion is permanent and the document's content and metadata are no longer accessible.

## Payload Example

```json theme={null}
{
  "event": "core.document.deleted",
  "event_id": "evt_01HXYZ4455667788",
  "organization_id": "org_abc123",
  "timestamp": "2025-06-03T11:00:00Z",
  "data": {
    "file_id": "file_abc123",
    "file_name": "master_services_agreement.pdf",
    "file_extension": "pdf",
    "deleted_by": "admin@example.com"
  }
}
```

## Payload Fields

### Envelope

| Field             | Type   | Description                                     |
| ----------------- | ------ | ----------------------------------------------- |
| `event`           | string | Always `core.document.deleted`                  |
| `event_id`        | string | Unique delivery ID — use to deduplicate retries |
| `organization_id` | string | ID of the organization that owned the document  |
| `timestamp`       | string | ISO 8601 UTC timestamp of the event             |
| `data`            | object | Event-specific payload (see below)              |

### Data Object

| Field            | Type   | Description                                  |
| ---------------- | ------ | -------------------------------------------- |
| `file_id`        | string | Unique identifier of the deleted document    |
| `file_name`      | string | Name of the document at time of deletion     |
| `file_extension` | string | File extension of the deleted document       |
| `deleted_by`     | string | Email of the user who performed the deletion |

## Notes

<Warning>
  This event is your last opportunity to sync the deletion to external systems. Once the event fires, the document and all associated data are permanently removed from Chamelio and cannot be recovered.
</Warning>