---
title: "Get asset change notifications."
method: PUT
path: "/v3/asset-changes/change-sets"
tags: ["AssetChanges"]
---

# Get asset change notifications.

`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. 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.

## Query parameters

- `channel_id` integer
- `batch_size` integer

## Response `200`

Success - Channel contains unconfirmed asset change notifications

- AssetChanges
  - `changeSetId` string, nullable — Contains the identifier for the change-set resource. Passed into ConfirmAssetChanges requests to confirm receipt of the asset changes in the response.
  - `changedAssetList` ChangedAssetDetail[], nullable — Contains a list of ChangedAssetList results for the query.
    - `assetChangedUtcDateTime` string, date-time — Contains the date of the asset change.
    - `assetLifecycle` string, nullable — Specifies the lifecycle: "New", "Update", or "Delete"
    - `assetType` string, nullable — Specifies asset type: "Image", "Film", or "Music"
    - `id` string, nullable — Contains the Id for the asset change.
    - `uri` string, nullable — Contains the asset download URL for assets with an AssetLifecycle of "New."

## Other responses

- `201` — Created
- `400` — InvalidChannelIdException
- `403` — Your access token does not authorize access to this resource
- `404` — The channel you specified does not exist

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)