Get the descendants of a folder
Returns the descendant folders of the folder with the specified identifier, optionally filtered to a set of folder identifiers.
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your product environment.
Request Body
application/json
The parent folder identifier and optional filter.
The parent folder identifier and optional descendant filter.
The immutable identifier of the parent folder whose descendants are returned.
A list of folder identifiers to restrict the returned descendants to.
Whether to include the parent folder itself in the results. If false, only descendants are returned.
Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1_1/my_cloud/folders/descendants" \ -H "Content-Type: application/json" \ -d '{ "id": "string" }'{ "folders": [ { "name": "string", "path": "string", "external_id": "string", "created_at": "2019-08-24T14:15:22Z", "resource_count": 0, "total_bytes": 0, "last_uploaded_at": 0, "ancestors": [ { "name": "string", "path": "string", "external_id": "string", "created_at": "2019-08-24T14:15:22Z" } ] } ]}Get a folder by its path PUT
Returns the details of the folder at the specified path, including its ancestors.
Provides a powerful query interface to filter and retrieve assets and their details POST
Returns a list of resources matching the specified search criteria. Uses a Lucene-like query language to filter assets by descriptive attributes (`public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder`, `tags`, `context.<key>`), file details (`resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`), lifecycle dates (`uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`), moderation and lifecycle state (`status`, `moderation_status`, `moderation_kind`), embedded data (`image_metadata.*`), structured metadata (`metadata.<external_id>`), and analysis fields (`face_count`, `colors`, `quality_score`, `illustration_score`, `accessibility_analysis.*`). Supports sorting, aggregate counts, and complex boolean expressions. Examples: `tags:shirt AND uploaded_at>1d`, `resource_type:image AND bytes>1000000`, `folder:products OR context.category:electronics`. See the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full syntax and field reference.