Assets
Get resources by asset folder
Retrieves a list of resources within a specific asset folder. Requires folder decoupling to be enabled.
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.
Query Parameters
asset_folder*string
The full path of the asset folder.
resource_type?string
Resource type filter.
Value in
- "image"
- "video"
- "raw"
next_cursor?string
Cursor for pagination.
max_results?integer
Maximum number of results to return (1-500).
Range
1 <= value <= 500direction?string
The sort direction for the results. Default is "desc".
Value in
- "asc"
- "desc"
fields?|array<>
Additional fields to include in the response. The fields public_id and asset_id are always included.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1_1/my_cloud/resources/by_asset_folder?asset_folder=string"{ "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" } ] } ], "next_cursor": "string", "total_count": 0}