Upload a file

POST /{client}

Api key

Query parameters

private boolean

Flag that determines the visibility of the file.

Body

file string(binary)

You can use any name you like and send as many files as you like at once.

Responses

201

File successfully uploaded
Hide response attributes Show response attributes array[object]
- name string
- owner string
- visibility string
  
  Values are public or private.
- path string
  
  file path without domain
- mime string
- size number
  
  size of a file in bytes
- lastModified number
  
  UNIX timestamp of the last time the file was modified
500

Unexpected error
Hide response attributes Show response attributes object
- message string
- code number

POST /{client}

curl \
 -X POST http://api.example.com/{client} \
 -H "x-api-key: $API_KEY" \
 -H "Content-Type: multipart/form-data" \
 -F "file=@file"

Request example

{
  "file": "@file"
}

Request examples

{
  "file": "@file"
}

Response examples (201)

[
  {
    "name": "8BgXSCaMZae9auk1kVA9tRP2Km1CzvKsyE8ml8R0.jpg",
    "owner": "client",
    "visibility": "public",
    "path": "client/8BgXSCaMZae9auk1kVA9tRP2Km1CzvKsyE8ml8R0.jpg",
    "mime": "image/jpeg",
    "size": 142083,
    "lastModified": 1640104826
  }
]

Response examples (201)

[
  {
    "name": "8BgXSCaMZae9auk1kVA9tRP2Km1CzvKsyE8ml8R0.jpg",
    "owner": "client",
    "visibility": "public",
    "path": "client/8BgXSCaMZae9auk1kVA9tRP2Km1CzvKsyE8ml8R0.jpg",
    "mime": "image/jpeg",
    "size": 142083,
    "lastModified": 1640104826
  }
]

Response examples (500)

{
  "message": "An error occurred.",
  "code": 500
}

Response examples (500)

{
  "message": "An error occurred.",
  "code": 500
}