KAkanton-bern
user APIs

Read directory contents

Returns the contents of the specified directory for the logged in user

get/user/dirs

Request

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

Changes

No recorded changes to this operation across all 1 revision of this API.