Assets
Restore assets by asset ID
Restores one or more resources from backup using their asset IDs. Can optionally specify versions to restore.
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.
Request Body
application/json
The asset IDs to restore and optional version parameters.
asset_ids*array<>
The unique and immutable asset IDs of backed up assets to restore.
Items
items <= 100versions?array<string>
If you specify versions, the number of versions in the array must exactly match the number of asset_ids.
notification_url?string
The URL that will receive notification when restore is complete.
Format
uriResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1_1/my_cloud/resources/restore" \ -H "Content-Type: application/json" \ -d '{ "asset_ids": [ "string" ] }'{ "2262b0b5eb88f1fd7724e29b0e57d730": { "asset_id": "2262b0b5eb88f1fd7724e29b0e57d730", "public_id": "sample", "format": "jpg", "version": 1750590339, "version_id": "da744ebcc95851cbbcecaef52e2246f5", "resource_type": "image", "type": "upload", "created_at": "2017-08-04T12:33:24Z", "bytes": 120253, "width": 864, "height": 576, "tags": [], "placeholder": false, "asset_folder": "" }, "d23c0526e6feca2c343e40c2fce5231a": { "asset_id": "d23c0526e6feca2c343e40c2fce5231a", "public_id": "coffee", "format": "jpg", "version": 1750590339, "version_id": "da744ebcc95851cbbcecaef52e2246f5", "resource_type": "image", "type": "upload", "created_at": "2017-08-04T12:35:25Z", "bytes": 85641, "width": 640, "height": 480, "tags": [], "placeholder": false, "asset_folder": "" }}