PUT /v3/asset-changes/change-sets
Asset Changes
Get notifications about new, updated or deleted assets for a specific channel.
Quickstart
You'll need an API key and an access token to use this resource.
Maximum batch size is 2200.
Change-sets must be confirmed before a new batch of notifications can be retrieved from this endpoint. Use the DELETE asset-changes/change-sets/{change-set-id} endpoint to confirm reciept of these notifications.
Values returned for asset_type include Image, Film, and null. Values returned for asset_lifecycle include New, Update, and Delete.
Delete notifications may be provided for asset ids that have not previously been received as New or Update notifications. Delete notifications may return null for the asset_type.
If there are no notifications in the channel an empty response body will be returned.
Notifications older than 60 days will be removed from partner channels.
Servers
- https://api.gettyimages.com
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
channel_id |
Integer | No |
Specifies the id of the channel for the asset data. Valid channel ids can be found in the results of the Get Partner Channel query. |
batch_size |
Integer | No |
Specifies the number of assets to return. The default is 2200; maximum is 2200. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.