GET
/
api
/
v1
/
files
{
  "data": [
    {
      "type": "file",
      "name": "<string>",
      "path": "<string>",
      "url": "<string>",
      "size": 123,
      "lastModified": "2023-11-07T05:31:56Z"
    }
  ],
  "nextContinuationToken": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
prefix
string
default:""

Prefix (path) to filter the files by. For folders it should end with /. Note that it is currently not possible to list files across workspaces but only within one workspace, i.e., which means that the prefix should start with workspaces/{workspace_id}/.

​
delimiter
string | null

Delimiter to group keys, e.g., / to group by folders, i.e., get files of the root folder or the folder identified by the prefix. If not provided, no folders are included in the response.

​
limit
integer
default:10

Maximum number of files to return per page

Required range: 1 <= x <= 1000
​
continuation_token
string | null

Continuation token to get the next page of results (cursor-based pagination)

​
expand
string[] | null

Expand the response with the signed URL to the file

Response

Files listed successfully

​
data
Data · array
required
​
nextContinuationToken
string | null