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
enum<string>[] | null

Expand the response with the signed URL to the file

Available options:
url

Response

200
application/json
Files listed successfully
data
object[]
required
nextContinuationToken
string | null