folders

Update folder

Updates an existing folder

put/folders/{name}

Request

Base URL
/api/v2 (relative, and the document was published on a file host, not at the API’s origin)
Auth
- HTTP bearer
- or API key in header X-SFTPGO-API-KEY
TypeScript
https://skmtc.dev/kanton-bern/apis/sftpgo/docs/folders/:name/put.ts
A function with typed inputs. Its response is checked against the schema.

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

messagestring

message, can be empty

errorstring

error description if any

Changes

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