Upload a File

POST

/system/file-explorer/upload

curl --request POST \
  --url 'https://sylve.lan:8181/api/system/file-explorer/upload?path=example' \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form filepond=@file

Upload exactly one file to an absolute destination folder through FilePond without overwriting an existing entry

Authorizations

• BearerAuth

Parameters

Query Parameters

path

required

string

Destination folder path (e.g. /zroot/share)

FormData Parameters

filepond

required

file

File to upload

Responses

201

File uploaded

Media typeapplication/json

object

data

object

bytes

integer

path

string

uploadId

string

error

string

message

string

status

string

Example^generated

{
  "data": {
    "bytes": 1,
    "path": "example",
    "uploadId": "example"
  },
  "error": "example",
  "message": "example",
  "status": "example"
}

400

Invalid path, filename, or multipart request

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

401

Unauthorized

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

403

Administrator access or destination permission required

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

404

Destination folder not found

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

408

Upload cancelled or timed out

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

409

Destination exists or restore is in progress

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

413

File or multipart request too large

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

429

Upload capacity exhausted

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

500

Internal Server Error

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

507

Insufficient storage or quota

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}