Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Asset Relations

Add related assets by asset ID

POST
/v1_1/{cloud_name}/resources/related_assets/{asset_id}

Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

asset_id*string

The asset ID of the resource. Must be a 32-character hexadecimal string.

Match^[0-9a-f]{32}$

Request Body

application/json

The asset IDs to relate.

The asset relation request.

assets_to_relate*array<>

Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.

Itemsitems <= 10

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1_1/my_cloud/resources/related_assets/f4e6579cf84dd9cf5683b21f5b30c7d9" \  -H "Content-Type: application/json" \  -d '{    "assets_to_relate": [      "string"    ]  }'
{  "failed": [    {      "message": "string",      "code": "rejected_ids",      "asset": "string",      "status": 0    }  ],  "success": [    {      "message": "string",      "code": "rejected_ids",      "asset": "string",      "status": 0    }  ]}

Get video views GET

Retrieves analytics data for video views. Results can be filtered using expressions based on various criteria such as video public ID, view duration, viewer information, and more.

Delete asset relations by asset ID DELETE

Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.