Experiment with this API

Register Assets

Registers a list of assets that a customer has stored in their system.


You'll need an API key and a Resource Owner Grant access token to use this resource. Please see our Getting Started page for more information on how to sign up for an API key.

Use the following endpoint to register assets:

POST https://api.gettyimages.com/v3/asset-registrations

Add your API key and the Resource Owner Grant access token to the request header:

Api-Key: <your api key>
Authorization: Bearer <your secure access token>

Your request would look like this using curl:

curl -X POST -H "Authorization: Bearer <access token>" -H "Api-Key: <your api key>" -H "Content-Type: application/json" -d '{
  "asset_ids": [
    "<asset id>"
}' 'https://api.gettyimages.com/v3/asset-registrations'

In the event of a successful query (response code 200) there will be nothing in the response body.

Request Headers

Authorization string Authorization token required. Used for applying content access restrictions. Use one of the OAuth2 grants to auto-populate this value. Required.
Api-Key string Api-Key Required.
Accept-Language string Accept-Language parameter optional. Used to restrict the set of natural languages that are preferred as a response to the request.

Request Body Fields


asset_ids array [string ] Specifies the list of asset ids you want to register.

Response Status Codes

200 Success - The assets were successfully registered.
401 AuthorizationTokenRequired - Authorization token was missing or not valid.
500 AssetRegistrationFailed - There was a failure when registering assets.