List items in directory

Lists all items of a directory (folders first, then files, each sorted by name).

  • If oid equals the current object ID of the directory, the string uptodate is returned instead of the list.
  • Lock fields (is_locked, lock_owner, lock_owner_name, lock_time, locked_by_me) are only returned for files.
  • Items with folder permission invisible are not listed.
  • Response headers: oid (object ID of the directory) and dir_perm (permission of the current user on it).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$

The unique identifier of a library

Query Params
string

Path to the dir

string

The object id of the directory. The object id is the checksum of the directory contents.

string
enum

Only list items of this type: f = files, d = directories. Empty = both.

Allowed:
string
enum
Defaults to 0

1 = list all items recursively (returns a flat list with parent_dir per item), 0 = only direct children.

Allowed:
Responses

Language
Credentials
Bearer
Account-Token
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json