Space API

Generate a presigned PUT URL for direct upload

POST /image/generate-upload-url
Api key auth

Query parameters

  • contentType string

Responses

  • 200 application/json

    Presigned URL generated

    Hide response attributes Show response attributes object
    • uid string Required
    • url string(uri) Required
    • method string Required

      Value is PUT.
  • 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
POST /image/generate-upload-url 
curl \
 --request POST 'https://call.xap3y.space/v1/image/generate-upload-url' \
 --header "X-API-Key: $API_KEY"
Response examples (200) 
{
  "uid": "string",
  "url": "https://example.com",
  "method": "PUT"
}
Response examples (401) 
{
  "error": true,
  "timestamp": "2025-05-04T09:42:00Z",
  "uniqueId": "string"
}