Assets

List the assets in a folder by container ID

GET
/v1_1/{cloud_name}/resources/by_container_id/{container_id}

Returns the assets contained in the folder identified by the given container ID.

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.

container_id*string

The immutable identifier of the folder container whose assets are listed.

Query Parameters

max_results?integer

The maximum number of results to return. Default is 10.

Range1 <= value <= 500
Default10
next_cursor?string

The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.

sort_by?string

The field by which the assets are sorted. Default is "uploaded_at".

fields?string

A comma-separated list of asset fields to include in each returned asset.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/resources/by_container_id/cd7e9d690a014c68ae8b58f08e090cb03a"
{  "resources": [    {      "asset_id": "string",      "public_id": "string",      "asset_folder": "string",      "display_name": "string",      "folder": "string",      "filename": "string",      "format": "string",      "version": 0,      "resource_type": "string",      "type": "upload",      "created_at": "2019-08-24T14:15:22Z",      "uploaded_at": "2019-08-24T14:15:22Z",      "bytes": 0,      "backup_bytes": 0,      "width": 0,      "height": 0,      "aspect_ratio": 0,      "pixels": 0,      "tags": [        "string"      ],      "context": {        "custom": {          "property1": "string",          "property2": "string"        },        "property1": {          "property1": "string",          "property2": "string"        },        "property2": {          "property1": "string",          "property2": "string"        }      },      "metadata": {},      "moderation_kind": "string",      "moderation_status": "string",      "moderation": [        {          "kind": "string",          "status": "string",          "updated_at": "2019-08-24T14:15:22Z"        }      ],      "backup": true,      "url": "http://example.com",      "secure_url": "http://example.com",      "status": "string",      "access_control": [        {          "access_type": "token",          "key": "string",          "start": "string",          "end": "string"        }      ],      "etag": "string",      "animated": true,      "duration": 0,      "resource_subtype": "string",      "substatus": "string",      "related_assets": [        {}      ],      "last_updated": {        "access_control_updated_at": "2019-08-24T14:15:22Z",        "context_updated_at": "2019-08-24T14:15:22Z",        "metadata_updated_at": "2019-08-24T14:15:22Z",        "public_id_updated_at": "2019-08-24T14:15:22Z",        "tags_updated_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z"      },      "next_cursor": "string",      "derived": [        {          "transformation": "string",          "format": "string",          "bytes": 0,          "id": "string",          "url": "http://example.com",          "secure_url": "http://example.com"        }      ],      "faces": [        [          0        ]      ],      "coordinates": {        "faces": [          [            0          ]        ],        "custom": [          [            0          ]        ]      },      "illustration_score": 0,      "semi_transparent": true,      "grayscale": true,      "colors": [        []      ],      "predominant": {        "property1": [          []        ],        "property2": [          []        ]      },      "versions": [        {          "version_id": "string",          "version": "string",          "format": "string",          "size": 0,          "time": "2019-08-24T14:15:22Z",          "restorable": true        }      ],      "info": {},      "derivatives": [        {          "id": "string",          "transformation": "string",          "transformation_signature": "string",          "secure_url": "http://example.com"        }      ]    }  ],  "total_count": 0,  "next_cursor": "string"}