List files

List files under a folder. If not specified, files at root folder will be listed. Listing is not recursive. However, if you pass "-1", all files of the user will be returned. If you pass "-1", make sure that you also specify per_page param to make use of cursor.

Number of files to be returned in response. If not specified cursor will always be null and no more than 2000 items will be returned.

Sort order of files in response. If not specified, the value saved in user settings will be used.

Filter files by content type.

Filter files by file type.

Include stream_url in files array.

Include stream_url in parent object.

Include mp4_stream_url in files array.

Currently has no effect. Use mp4_status_parent to include mp4_stream_url in parent object.

Folders such as "Your friends files" at root and folders in it are hidden by default if they are empty. If you want to include them in response, you can pass true.

Include mp4_size and need_convert fields in response.

Include mp4_size, need_convert and mp4_stream_url in parent object.

Include codec info in parent object.

Include media info in parent object.

Include video_metadata in files array.

Include video_metadata in parent object.

Include media_metadata in files array.

Include media_metadata in parent object.

Alias of sort_by. Used only when sort_by is absent.

Include breadcrumbs in response. Not allowed with parent_id=-1.

Do not return a cursor, even when per_page is set.

null when parent_id=-1.

Cursor value for fetching next page. You have to specify "per_page" param to get a cursor. Otherwise, it will always be null.

[id, name] pairs of the parent folder's ancestors, starting at root. Present only when breadcrumbs=true is passed.