Skip to main content
Requires authentication and image:write permission

Endpoint

POST /images/upload

Request

Multipart form data with the following fields:
  • image (file): The image file to upload
  • path (string): The folder path where the image should be stored (e.g., “users/profile-pictures”, “documents/contracts”)

Example Request

curl -X POST "https://api.example.com/images/upload" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "image=@profile.jpg" \
  -F "path=users/profile-pictures"

Response

{
  "success": true,
  "statusCode": 201,
  "data": {
    "url": "https://s3.eu-central-003.backblazeb2.com/bucket-name/ganjan/users/profile-pictures/uuid-filename.jpg"
  }
}

Error Responses

{
  "success": false,
  "statusCode": 400,
  "error": {
    "message": "No Image Provided",
    "code": "NOT_FOUND"
  }
}