General APIs with JWT

List a volume's files

Changed on

List the files and folders directly under prefix in a volume, without mounting it on a pod. Names are relative to the volume root (/mnt in a pod). Pass next_cursor back as cursor for the next page. Listing reads no file contents, so it bills no egress.

get/volumes/{volume_id}/files

Request

Path parameters

volume_idstring uuid required

Query parameters

prefixstring

Folder to list, e.g. data/

cursorstring nullable

next_cursor from the previous page

limitinteger

Response

Files and folders under the prefix

foldersstring[] required

Folder prefixes one level below prefix, each ending in '/'

next_cursorstring nullable

Pass as cursor for the next page; null at the end

Changes