Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Asset Relations

Delete asset relations by public ID

DELETE
/v1_1/{cloud_name}/resources/related_assets/{resource_type}/{type}/{public_id}

Unrelates the asset from other assets, specified by public IDs. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.

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.

resource_type*string

The type of resource (image, video, or raw).

Value in

  • "image"
  • "video"
  • "raw"
type*string

The delivery type of the asset.

Default"upload"

Value in

  • "upload"
  • "private"
  • "authenticated"
public_id*string

The public ID of the asset.

Request Body

application/json

The assets to unrelate by public ID.

The asset unrelation request.

assets_to_unrelate*array<string>

Unrelates the asset from all the assets specified in this array of assets, specified as resource_type/type/public_id.

Response Body

application/json

application/json

application/json

application/json

application/json

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

Create asset relations by public ID POST

Relates an asset to other assets by public IDs. This allows you to indicate that the asset is logically related to other assets in some way (e.g., similar content, or a peripheral asset like video/transcript, etc). This is a bidirectional process, meaning that the asset is also 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.

Lists all adaptive streaming profiles (both built-in and custom) defined in your Cloudinary account GET

Next Page