v14

latestOpenAPI 3.1.02026-08-043122950.3 KB

buckets

List files

get/api/buckets/{namespace}/{repo}/tree/{path}

Path parameters

namespacestring required

repostring required

pathstring required

Wildcard path parameter

Query parameters

limitinteger

cursorstring

Pagination cursor

recursiveboolean

When false, returns collapsed directory entries instead of listing all files recursively. The number of entries returned can then be less than the limit, but there will always be a pagination link if there are more entries. Note: non-recursive listing hasn't a strong consistency guarantees.

sort'path' | 'uploadedAt'

Sort order. path (default) sorts lexicographically; uploadedAt sorts by most recent upload first. In recursive mode uploadedAt is only supported at the bucket root (no path prefix). In non-recursive mode, only supported at root or exact folder prefixes.

direction'asc' | 'desc'

Sort direction. Defaults to asc for path and desc for uploadedAt.

Response

List of files and directories

type'file' | 'directory' required

pathstring required

sizeinteger

xetHashstring

Not defined for directories

mtimestring date-time

mtimeNanosinteger

Sub-millisecond remainder of mtime, in nanoseconds (0–999_999)

uploadedAtstring date-time required

contentTypestring