v1

latestOpenAPI 3.0.3AGPL-3.0-only2026-07-17120116247.0 KB

public shares

Read directory contents

Returns the contents of the specified directory for the specified share. The share must have exactly one path defined and it must be a directory for this to work

get/shares/{id}/dirs

Query parameters

pathstring

Path to the folder to read. It must be URL encoded, for example the path "my dir/àdir" must be sent as "my%20dir%2F%C3%A0dir". If empty or missing the user's start directory is assumed. If relative, the user's start directory is used as the base

Response

successful operation

namestring

name of the file (or subdirectory) described by the entry. This name is the final element of the path (the base name), not the entire path

sizeinteger

file size, omitted for folders and non regular files

modeinteger

File mode and permission bits. More details here: https://golang.org/pkg/io/fs/#FileMode. Let's see some examples:

for a directory mode&2147483648 != 0
for a symlink mode&134217728 != 0
for a regular file mode&2401763328 == 0

last_modifiedstring date-time