v1

latestOpenAPI 3.0.42026-07-1376217536.1 KB
AssetChanges

Get asset change notifications.

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. Delete notifications for videos and images are often duplicated across each other's channels. For example, a delete notification for a video may be duplicated in a channel for image messages.

If there are no notifications in the channel an empty response body will be returned.

Notifications older than 14 days will be removed from partner channels.

put/v3/asset-changes/change-sets

Query parameters

channel_idinteger

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_sizeinteger

Specifies the number of assets to return. The default is 2200; maximum is 2200.

Response

Success - Channel contains unconfirmed asset change notifications

changeSetIdstring nullable

Contains the identifier for the change-set resource. Passed into ConfirmAssetChanges requests to confirm receipt of the asset changes in the response.