> ## 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.updated

> Fired when a document's attributes or metadata are updated in Chamelio's Core.

## Event

```
core.document.updated
```

This event fires when a document's metadata attributes are modified — either via the [Update File Attributes](/api-reference/endpoint/core/update-attribute) API or through the Chamelio web application.

## Payload Example

```json theme={null}
{
  "event": "core.document.updated",
  "event_id": "evt_01HXYZ3344556677",
  "organization_id": "org_abc123",
  "timestamp": "2025-06-02T09:15:30Z",
  "data": {
    "file_id": "file_abc123",
    "file_name": "master_services_agreement.pdf",
    "updated_by": "jane.smith@example.com",
    "updated_attributes": [
      {
        "name": "contract_value",
        "data_type": "number",
        "previous_value": "250000",
        "new_value": "300000"
      },
      {
        "name": "auto_renew",
        "data_type": "boolean",
        "previous_value": "true",
        "new_value": "false"
      }
    ]
  }
}
```

## Payload Fields

### Envelope

| Field             | Type   | Description                                     |
| ----------------- | ------ | ----------------------------------------------- |
| `event`           | string | Always `core.document.updated`                  |
| `event_id`        | string | Unique delivery ID — use to deduplicate retries |
| `organization_id` | string | ID of the organization that owns 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 updated document   |
| `file_name`          | string | Name of the document                        |
| `updated_by`         | string | Email of the user who made the change       |
| `updated_attributes` | array  | List of attributes that changed (see below) |

### Updated Attribute Object

| Field            | Type   | Description                                              |
| ---------------- | ------ | -------------------------------------------------------- |
| `name`           | string | Name of the attribute that changed                       |
| `data_type`      | string | Attribute data type                                      |
| `previous_value` | string | Value before the update (`null` if the attribute is new) |
| `new_value`      | string | Value after the update                                   |