Space API

Upload image directly to cloud storage (S3-compatible)

POST /image/upload/cloud
Api key auth
multipart/form-data

Body Required

  • file string(binary) Required
  • uniqueId string
  • private boolean
  • password string
  • desc string

    Maximum length is 200.

  • source string

Responses

  • 200 application/json

    Uploaded image resource response

    Hide response attributes Show response attributes object
    • error boolean
    • timestamp string(date-time)
    • uniqueId string | null
    • message object
      Hide message attributes Show message attributes object
      • uniqueId string
      • url string(uri)
      • description string | null
      • size integer(int64)
      • uploadedAt string(date-time)
      • expiresAt string | null
      • urlSet object
        Hide urlSet attributes Show urlSet attributes object
        • webUrl string(uri)
        • portalUrl string(uri)
        • rawUrl string(uri)
        • shortUrl string(uri)
        • customUrl string(uri)
      • uploader object
        Hide uploader attributes Show uploader attributes object
        • uid integer
        • username string
        • role string

          Values are OWNER, ADMIN, USER, or TESTER.

        • avatar string | null
        • createdAt string(date-time)
        • invitor object
          Hide invitor attributes Show invitor attributes object
          • uid integer
          • username string
          • role string

            Values are OWNER, ADMIN, USER, or TESTER.

          • avatar string | null
          • createdAt string(date-time)
      • requiresPassword boolean
      • isPublic boolean
  • 400 application/json

    Bad request

    Hide response attributes Show response attributes object
    • error boolean
    • timestamp string(date-time)
    • uniqueId string | null
  • 401 application/json

    Unauthorized or invalid API key/cookie

    Hide response attributes Show response attributes object
    • error boolean
    • timestamp string(date-time)
    • uniqueId string | null
  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • error boolean
    • timestamp string(date-time)
    • uniqueId string | null
POST /image/upload/cloud 
curl \
 --request POST 'https://call.xap3y.space/v1/image/upload/cloud' \
 --header "X-API-Key: $API_KEY" \
 --header "Content-Type: multipart/form-data" \
 --form "file=@file" \
 --form "uniqueId=string" \
 --form "private=true" \
 --form "password=string" \
 --form "desc=string" \
 --form "source=string"
Response examples (200) 
{
  "error": true,
  "timestamp": "2025-05-04T09:42:00Z",
  "uniqueId": "string",
  "message": {
    "uniqueId": "string",
    "url": "https://example.com",
    "description": "string",
    "size": 42,
    "uploadedAt": "2025-05-04T09:42:00Z",
    "expiresAt": "string",
    "urlSet": {
      "webUrl": "https://example.com",
      "portalUrl": "https://example.com",
      "rawUrl": "https://example.com",
      "shortUrl": "https://example.com",
      "customUrl": "https://example.com"
    },
    "uploader": {
      "uid": 42,
      "username": "string",
      "role": "OWNER",
      "avatar": "string",
      "createdAt": "2025-05-04T09:42:00Z",
      "invitor": {
        "uid": 42,
        "username": "string",
        "role": "OWNER",
        "avatar": "string",
        "createdAt": "2025-05-04T09:42:00Z"
      }
    },
    "requiresPassword": true,
    "isPublic": true
  }
}
Response examples (400) 
{
  "error": true,
  "timestamp": "2025-05-04T09:42:00Z",
  "uniqueId": "string"
}
Response examples (401) 
{
  "error": true,
  "timestamp": "2025-05-04T09:42:00Z",
  "uniqueId": "string"
}
Response examples (500) 
{
  "error": true,
  "timestamp": "2025-05-04T09:42:00Z",
  "uniqueId": "string"
}