Folders

Searches for folders whose attributes match a given expression

GET
/v1_1/{cloud_name}/folders/search

Lists the folders that match the specified search expression. Limited to 2000 results. If no parameters are passed, returns the 50 most recently created folders in descending order of creation time.

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.

Query Parameters

expression?string

The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).

sort_by?array<>

Sort order for the results. Each item maps a field name to a direction.

max_results?integer

Maximum number of folders to return (max 500, default 50).

Range1 <= value <= 500
Default50
next_cursor?string

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

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/folders/search?sort_by=%5Bobject+Object%5D"
{  "total_count": 14,  "time": 1136,  "next_cursor": "0a37f8c9f65e79c1cbe782d47987ed108d9f9e0dad4b0666adbf4eac9a634191996204a0ef84ce7b3e0e",  "folders": [    {      "name": "1_folder_param",      "path": "my_parent/1_folder_param",      "created_at": "2024-12-16T11:31:00+00:00",      "external_id": "c7c08f8ecf093353d669d2ea3123967c7"    },    {      "name": "a_folder_param",      "path": "my_parent/a_folder_param",      "created_at": "2024-12-16T11:08:32+00:00",      "external_id": "c7c08b736592482c1125ba5d689ab8779"    }  ]}