v2

latestOpenAPI 3.1.02026-08-014610794.4 KB
files

List Files

List files.

  • To list files within a workspace, the prefix (query parameter) must start with workspaces/{workspace_id}/
  • Cannot list files across multiple workspaces, i.e., if the prefix does not start with workspaces/{workspace_id}/, it will return an empty list.
get/api/v1/files

Query parameters

prefixstring

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}/.

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}/.

delimiterstring nullable

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.

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.

limitinteger

Maximum number of files to return per page

Maximum number of files to return per page

continuation_tokenstring nullable

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

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

expandstring[] nullable

Expand the response with the signed URL to the file

Expand the response with the signed URL to the file

Response

Files listed successfully

nextContinuationTokenstring nullable