Folders

Get a folder by its path

PUT
/v1_1/{cloud_name}/folders/by_path

Returns the details of the folder at the specified path, including its ancestors.

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.

Request Body

application/json

The path of the folder to retrieve.

The path of the folder to retrieve.

path*string

The full path of the folder to retrieve. Use an empty string for the root folder.

case_sensitive?boolean

Whether to match the folder path case-sensitively. If false, the path is matched case-insensitively.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1_1/my_cloud/folders/by_path" \  -H "Content-Type: application/json" \  -d '{    "path": "string"  }'
{  "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"    }  ]}