File Upload

File upload operations for single and multiple files

Upload single file

post

https://api.example.com/v1https://staging-api.example.com/v1

/upload

Upload a single file to the server with validation and size limits

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

imagestring · binaryRequired

File to upload (JPEG, PNG, GIF, PDF)

Example: file.jpg

Responses

200

File uploaded successfully

application/json

400

File upload error

application/json

500

Internal server error

application/json

post

/upload

HTTPcURLJavaScriptPython

POST /v1/upload HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 20

{
  "image": "file.jpg"
}

{
  "success": true,
  "data": {
    "url": "https://api.example.com/uploads/file.jpg",
    "filename": "file.jpg",
    "originalName": "my-image.jpg",
    "size": 1024000,
    "mimetype": "image/jpeg"
  }
}

Upload multiple files

post

https://api.example.com/v1https://staging-api.example.com/v1

/upload/multiple

Upload multiple files to the server with validation and size limits

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

filesstring · binary[]Required

Multiple files to upload (JPEG, PNG, GIF, PDF)

Example: ["file1.jpg","file2.png","document.pdf"]

Responses

200

Files uploaded successfully

application/json

400

File upload error

application/json

500

Internal server error

application/json

post

/upload/multiple

HTTPcURLJavaScriptPython

POST /v1/upload/multiple HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 50

{
  "files": [
    "file1.jpg",
    "file2.png",
    "document.pdf"
  ]
}

{
  "success": true,
  "data": [
    {
      "url": "https://api.example.com/uploads/file1.jpg",
      "filename": "file1.jpg",
      "originalName": "my-image.jpg",
      "size": 1024000,
      "mimetype": "image/jpeg"
    }
  ]
}