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

# vault.folder.updated

> Fired when a folder in Documents Vault is renamed or moved.

## Event

```
vault.folder.updated
```

This event fires when a folder in Documents Vault is renamed or moved into another folder. Each event describes one change, named in `change`.

## Payload Example

```json theme={null}
{
  "event": "vault.folder.updated",
  "event_id": "3f7c1a8e-5b2d-4e9a-9c31-8a6f0d4b7e12",
  "organization_id": 42,
  "user_id": 1337,
  "payload_version": 1,
  "timestamp": "2026-09-24T14:32:00Z",
  "data": {
    "event": "vault.folder.updated",
    "resource_id": "a1d4f7c2-9e3b-4b6a-8f15-3c7e0d2b9a84",
    "resource_type": "folder",
    "name": "Vendor Contracts",
    "parent_folder_id": "7b3e9d20-4c1f-4a8e-b5d6-2f9a0c8e1d47",
    "path": "u1337.Legal.Vendor_Contracts",
    "external_source": null,
    "external_id": null,
    "change": "moved",
    "previous_name": null,
    "previous_parent_folder_id": "0c9f2e41-7a3b-4d58-b6e2-91f4a8d3c7b0"
  }
}
```

## Payload Fields

### Envelope

| Field             | Type            | Description                                                                                     |
| ----------------- | --------------- | ----------------------------------------------------------------------------------------------- |
| `event`           | string          | Always `vault.folder.updated`                                                                   |
| `event_id`        | string          | UUID for this delivery. Use it to deduplicate retries                                           |
| `organization_id` | integer         | ID of the organization the event occurred in                                                    |
| `user_id`         | integer or null | ID of the user who made the change. For changes made by folder sync, the user who owns the sync |
| `payload_version` | integer         | Envelope schema version. Currently `1`                                                          |
| `timestamp`       | string          | ISO 8601 UTC timestamp of when the event was generated                                          |
| `data`            | object          | Event-specific payload (see below)                                                              |

### Data Object

| Field                       | Type           | Description                                                                                                                          |
| --------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `event`                     | string         | The event name, repeated from the envelope                                                                                           |
| `resource_id`               | string         | UUID of the folder in Documents Vault                                                                                                |
| `resource_type`             | string         | Always `folder`                                                                                                                      |
| `name`                      | string         | Current name of the folder, after the change                                                                                         |
| `parent_folder_id`          | string or null | UUID of the folder that contains the folder. `null` when the folder is at the top level of the vault                                 |
| `path`                      | string or null | Internal hierarchical path of the folder (see [Path format](#path-format))                                                           |
| `external_source`           | string or null | The external drive the folder is synced with, for example `google_drive`. `null` for items created in Chamelio                       |
| `external_id`               | string or null | The folder's ID in the external drive, when `external_source` is set                                                                 |
| `change`                    | string         | What changed: `renamed` or `moved`                                                                                                   |
| `previous_name`             | string or null | The name before the change. Set only when `change` is `renamed`                                                                      |
| `previous_parent_folder_id` | string or null | The containing folder before the change. Set only when `change` is `moved`, and `null` if the folder was previously at the top level |

### Path format

`path` is an internal dot-separated path, not a display path. Each segment is a sanitized label:
characters other than letters, digits, and underscores become `_`. For example, a file named
`Q3 NDA.pdf` appears as a `Q3_NDA_pdf` segment. Use `resource_id` and `parent_folder_id` to
identify items and rebuild the hierarchy; treat `path` as informational.

<Warning>
  Only the folder itself gets an event. Files and subfolders inside it do not receive their own events, even though their `path` changes.
</Warning>