Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Fired when a folder in Documents Vault is renamed or moved to a new parent, whether the change was made by a user or by folder sync.
vault.folder.updated
change.
{
"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"
}
}
| 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) |
| 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) |
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 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.
path changes.Was this page helpful?