Articles in this section

See more

How can I list all of my existing folders and subfolders?

Avatar
Nadav Ofir
  • Updated
Follow

Cloudinary allows you to list all of your existing folders and subfolders via the Admin-API.

For example, for listing all root folders, send an HTTP GET request to the following URL:

https://api.cloudinary.com/v1_1/<your_cloud_name>/folders

Or, listing all folders within a subfolder:

https://api.cloudinary.com/v1_1/<your_cloud_name>/folders/<subfolder>

Note that requests must first be signed with your credentials, as described in our Admin-API documentation.

Our client libraries provide helper methods to simplify the request, e.g. (PHP):

$api = new \Cloudinary\Api();
$api->root_folders();
$api->subfolders("my_folder");

Related articles

Comments

6 comments

Sort by Date Votes
  • Avatar
    Michael Hodson
    • Edited

    So, I'm trying to test this using the direct API as per the example above.

    For the signature hash, since there are no other parameters:

    timestamp=1529697857abcd (abcd is the api_secret value)

    I generate the hash and add it to call

    https://api.cloudinary.com/v1_1/my_cloud_name/folders?api_key=1234&timestamp=1529697857&signature=4b569a0f8322b3a285296b3b8c2908c2a1cb1937

    A dialog pops up "Authentication Required" / User Name: / Password: / OK

    Clear the dialog and JSON return says:

    {"error":{"message":"Invalid credentials"}}

    What am I missing?

     

     

     

     

    0
    Comment actions Permalink
  • Avatar
    Aditi Madan

    Hi Michael,

    What was the  Username/Password you provided in the dialog box? Username here should be the API key and password should be the API secret.

    Thanks,
    Aditi

    0
    Comment actions Permalink
  • Avatar
    Jim Klymus
    • Edited

    Why is something as simple as listing the names of the files and folders soooo 1980's-ish?? You have to use something so cumbersome as an API just to LIST the filenames and folders of your media assets? And isn't there some limit to the max number of results you can get back? Something like 500 or so?

    Why is it impossible to put this functionality in the main user interface? Nice and simple.

    0
    Comment actions Permalink
  • Avatar
    Victor Li

    Hi Jim,

    I do see your point here! I've opened up a feature request for this, and our internal team will evaluate it against their other projects and we will update you if or when there is going to be an implementation of this.

    Thanks,
    Victor

    1
    Comment actions Permalink
  • Avatar
    M.Albiero

    Hello,

    I tried the tutorial above and all I can do is get a list of first level folders only.

    I want to list all the folders and corresponding subfolders with a single API call.

    Is it possible?

    Thank you

    1
    Comment actions Permalink
  • Avatar
    Erwin Lukas

    Hi M.Albiero,

    Unfortunately currently at this point it's not possible to have a single API call to list all the subfolders recursively.

    Thanks,
    Erwin Lukas

    0
    Comment actions Permalink

Please sign in to leave a comment.