Sign in

v1

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

Add folder

Adds a new folder. A quota scan is required to update the used files/size

post/folders

Query parameters

confidential_datainteger

If set to 1 confidential data will not be hidden. This means that the response will contain the key and additional data for secrets. If a master key is not set or an external KMS is used, the data returned are enough to get the secrets in cleartext. Ignored if the * permission is not granted.

Request body

idinteger
namestring

unique name for this virtual folder

mapped_pathstring

absolute filesystem path to use as virtual folder

descriptionstring

optional description

used_quota_sizeinteger
used_quota_filesinteger
last_quota_updateinteger

Last quota update as unix timestamp in milliseconds

usersstring[]

list of usernames associated with this virtual folder

Example request

{
  "filesystem": {
    "s3config": {
      "key_prefix": "folder/subfolder/"
    },
    "gcsconfig": {
      "key_prefix": "folder/subfolder/"
    },
    "azblobconfig": {
      "key_prefix": "folder/subfolder/"
    },
    "sftpconfig": {
      "buffer_size": 2
    }
  }
}

Response

successful operation

idinteger
namestring

unique name for this virtual folder

mapped_pathstring

absolute filesystem path to use as virtual folder

descriptionstring

optional description

used_quota_sizeinteger
used_quota_filesinteger
last_quota_updateinteger

Last quota update as unix timestamp in milliseconds

usersstring[]

list of usernames associated with this virtual folder

Example response

{
  "filesystem": {
    "s3config": {
      "key_prefix": "folder/subfolder/"
    },
    "gcsconfig": {
      "key_prefix": "folder/subfolder/"
    },
    "azblobconfig": {
      "key_prefix": "folder/subfolder/"
    },
    "sftpconfig": {
      "buffer_size": 2
    }
  }
}