Table of Contents
Configuring notifications when assets change
15. May 2025
Table of Contents
You can use webhooks to configure the Fotoware system to send notifications when assets change in an archive.
- From the Tools menu (cogwheel icon), go to Site Configuration > Integrations.
- Select Webhooks.
- Three asset events are available for notifications:
- Asset ingested - Used to post a notification when an asset enters the system via the Fotoware API.
Note: Webhooks on asset ingestion are not supported if the upload destination is set to use a custom file system ingestion folder, since the uploaded asset may be picked up by, for example, a Color Factory server and transferred elsewhere and may not be indexed in Fotoware's asset storage folders.
- Asset modified - Send a notification when an asset in the system changes.
- Asset deleted - Send a notification when an asset is deleted by any means.
The asset data can be sent as Form or JSON data to the URL specified in the corresponding field.
JSON Data sent in webhook
| Attribute | Type | Description |
|---|---|---|
| byline | String | The byline of the asset. |
| created | ISO 8601 Date (String) | Date when webhook was created. |
| data | JSON object | Asset representation. |
| description | String | Description of the asset. |
| file-size | String | Size of the file in bytes. |
| href | String | Original URL of the asset within the originating archive. |
| id | String | ID of the webhook. |
| pixel-height | String | A height of the image in pixels, e.g., "2560". |
| pixel-width | String | A width of the image in pixels, e.g., "1440". |
| preview-href | String | URL of the preview image. |
| tags | String | Tags (keywords) of the asset. |
| thumbnail-href | URL (String) | URL of the thumbnail. |
| title | String | Title of the asset. |
| type | String | Type of the data. In this case, "asset". |
Example of the JSON data sent in webhook
Note that the data field below contains the Asset representation. Because of its size, it has been left out in the example.
| JSON |
|---|
|
|
Webhook Payload for Asset Version Changes
With versioning in Fotoware, the payload of the "asset modified" webhook has been updated to include information about how the asset was updated.
Metadata updates
1 |
{ |
2 |
... |
3 |
"operation-name" : "updateMetadata",
|
4 |
"data": { |
5 |
"asset: {<ASSET AFTER CHANGE, same as old "data">}, |
6 |
"assetBefore": {...}, |
7 |
"metadataDiff": {...} |
8 |
} |
9 |
} |
Rename operations
1 |
{ |
2 |
... |
3 |
"operation-name" : "rename",
|
4 |
"previous-name" : "oldName"
|
5 |
"data": { |
6 |
"asset: {<ASSET AFTER CHANGE, same as old "data">} |
7 |
} |
8 |
} |
Restore revision
1 |
{ |
2 |
... |
3 |
"operation-name" : "restoreRevision",
|
4 |
"data": { |
5 |
"asset: {<ASSET AFTER CHANGE, same as old "data">}, |
6 |
"revisionsDiff": {...} |
7 |
} |
8 |
} |
Upload of new local version (image data and potentially metadata) that is added to an asset's version history
1 |
{ |
2 |
... |
3 |
"operation-name" : "upload",
|
4 |
"data": { |
5 |
"asset: {<ASSET AFTER CHANGE, same as old "data">}, |
6 |
"assetBefore": {...}, |
7 |
"metadataDiff": {...} |
8 |
} |
9 |
} |
URLs with limited time validity
Thumbnail and preview URLs have a limited lifetime. They are only valid for being consumed immediately, such as by downloading the rendition image immediately or by embedding it into a dynamic web page that is presented to a user agent immediately.
We do not recommend storing thumbnail and preview URLs for a longer time in external systems, as they will eventually expire. The expiration time of previews and thumbnails is unspecified, but the link should be valid for at least several seconds after receiving it from an API request or webhook.
If an integration needs access to previews and thumbnails at a later time, we recommend storing the asset's API URL (data.href) and requesting thumbnails and previews through the API when needed. Alternatively, an integration can download the thumbnail or preview image and store it for later use