Notifications
CO server provides push notifications service indented to notify client about changes made to the cloud file system to perform well-timed user UI update as well as about async file operations results such as import/export, printing etc.
Notifications are sent via the websocket channel and each notification payload contains JSON object with following fields
| Field | Description |
|---|---|
operation | Name of the performed operation |
objectId | ID of the file object |
dirId | Source or target folder ID (depends on the file operation) |
destDirId | Target folder ID |
objectName | Name of the file object |
sourceId | ID of the source file used for conversion (may be hidden one) |
usedBytes | Used disk space |
totalBytes | Total disk space |
revisionId | Revision id |
email | Email for operation [Since 2018.03] |
login | Login of initiator for operation [Since 2019.01] |
newId | New file id if it is changed during operation (e.g. move from shared) [Since 2019.03] |
time | Time of initiation for operation [Since 2020.01] |
requestId | ID of the user initiated operation. Returned in the X-co-request-id header in the response to synchronous API request. |
errorCode | SRV error code. |
group | For group shared notifications will be true if it is group sharing. |
userId | User id for shared notifications. For group shared notifications will contain groupId. |
changedValues | Map with changed file properties for FILE_METADATA_CHANGE and FILE_CUSTOM_PROPS_CHANGE (such as fileNameChanged, fileCorrupted). |
customProperties | Map with custom file properties. |
deletedKeys | List of deleted file properties for FILE_CUSTOM_PROPS_CHANGE. |