Forum Discussion

scrouet's avatar
scrouet
Explorer | Level 3
8 years ago

What is traverse_only for?

Hi,

 

I noticed the traverse_only entry within several endpoints' returns (create_folder_v2, list_folder...). What is it for and how can it be set?

6 Replies

  • Hello scrouet,

     

    traverse_only is one of several possible access rights a given user can have to content within Dropbox, as stated in our Content Access Guide here:
    https://www.dropbox.com/developers/reference/content-access-guide

    traverse-only: If true, the user only has traversal rights on the folder.
    Explicitly enumerating the folder with list_folder will only return the subset of paths the user
    has access to.

    This basically means that the user in question may have full access to sub-folders while not necessarily having full access to all of the parent folders. Yet in order to access the sub-folders, the user needs to "traverse" the parent folder(s). The user can't read or see any contents but for the sake of folder tree structure navigation, they are allowed to move through those folders to get to the content they do have access to.

     

    The Content Access Guide describes all other possible values as well.

     

    Hope that helps!

     

    -Chuck

  • scrouet's avatar
    scrouet
    Explorer | Level 3
    8 years ago

    Hi Chirstius,

     

    Thank you for your answer. Is there a way to set it? When I share a sub-sub-folder of a team folder to a group, without granting any access on its parents folders (because I do not want to grand access to other sub-sub-folders), this sub-sub-folder is displayed directly at the top level of the users' Dropbox, without complete tree-structure. This is not much user-friendly.

  • chirstius's avatar
    chirstius
    Icon for Dropbox Staff rankDropbox Staff
    8 years ago

    scrouet-

     

    I have a hunch that your team has not moved to Team space and member folders yet, which means the results you are seeing are to be expected. Under the previous model if you share a folder with a user that does not have access to the root Team folder, it will be handled as if it's regular share. You can find this information here:
    https://www.dropbox.com/help/business/team-folders

     

    So for the moment, this is the expected behavior.

     

    -Chuck

  • scrouet's avatar
    scrouet
    Explorer | Level 3
    8 years ago

    We use team folders, but it seems it is the old structure (no purple folder with one person on it). How can we migrate?

About Discuss Dropbox Developer & API

Node avatar for Discuss Dropbox Developer & API
Make connections with other developers

The Dropbox Community team is active from Monday to Friday. We try to respond to you as soon as we can, usually within 2 hours.

If you need more help you can view your support options (expected response time for an email or ticket is 24 hours), or contact us on X, Facebook or Instagram.

For more info on available support options for your Dropbox plan, see this article.

If you found the answer to your question in this Community thread, please 'like' the post to say thanks and to let us know it was useful!