This endpoint is currently in BETA.
Experiment with this API

Boards - Add Assets to Board

Boards are where you collect, curate, collaborate on and manage photo and video assets in one place. More information on the Boards FAQ. Use this endpoint to add a set of assets to a board.

Quickstart

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 add a set of assets to a specific board:

PUT https://api.gettyimages.com/v3/boards/<board_id>/assets

You can use the Get All Boards Quickstart to get a test board id and the Creative Image Search Quickstart to get a set of asset id values.

Add API key and the Resource Owner Grant 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 PUT -H "Api-Key: <your api key>" -H "Authorization: Bearer <secure access token>" https://api.gettyimages.com/v3/boards/<your board id>/assets

Your response will return a 201 - Created if successful.

Request Headers

Api-Key string Provide your API key. Required.
Authorization string Provide access token in the format of 'Bearer {token}'. Required.
Accept-Language string Provide a header to specify the language of result values.

URI Path Parameters

board_id string Specify the board to add assets to. Required.

Request Body Fields

Response Body Fields

AddBoardAssetsResult

assets_added array [ BoardAsset ] Lists the assets that were added to the board.
assets_not_added array [ string ] Lists the assets that were not added to the board.

BoardAsset

asset_id string Specifies a unique identifier for the asset.

Response Status Codes

201 Created
400 InvalidParameterValue
401 Unauthorized
403 SecureTokenRequired
403 InsufficientAccess
403 AssetNotFound
404 BoardNotFound