Folders

Get folder roles

GET
/v1_1/{cloud_name}/folder_operations/invite/{folder_id}

Lists the principals (users, groups, or API keys) and their role assignments on a specific folder, including roles inherited from ancestor folders.

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.

folder_id*string

The immutable identifier of the folder, returned by the Get root folders and Get subfolders endpoints.

Query Parameters

permitted_roles?boolean

Whether to include in the response the roles the authenticated user can assign on this folder, based on their permission level. Default: false.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/folder_operations/invite/cd7e9d690a014c68ae8b58f08e090cb03a"
{  "shared_with": [    {      "type": "user",      "id": "string",      "folder_id": "string",      "roles": [        {          "id": "string",          "name": "string",          "description": "string",          "inherited": true        }      ]    }  ],  "permitted_roles": [    {      "id": "string",      "name": "string",      "description": "string"    }  ]}