Skip to main content
GET

Overview

Returns a paginated list of file entries (files and folders) that the user has access to. Supports filtering, searching, and sorting.

Query Parameters

integer
default:"0"
Workspace ID. Use 0 for personal workspace.
integer
default:"50"
Number of entries per page
integer
default:"1"
Page number (1-indexed)
array
Filter to entries that are children of specified folder IDs
string
Display files in specified folder (by hash)
string
Search query to filter entry names
string
Filter by file type: folder, image, text, audio, video, pdf
boolean
Return only trashed entries
boolean
Return only starred entries
boolean
Return only recently accessed entries
boolean
Return only entries shared with you
string
default:"updated_at"
Sort field: updated_at, created_at, name, file_size
string
default:"desc"
Sort direction: asc or desc

Response

array
Array of file entry objects
object
Current folder info (null if listing root)
integer
Current page number
integer
Total number of pages
integer
Total number of entries