Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview

Reserve quota and presign a create-only upload

Each file id is granted once. Send the returned headers with the PUT; the URL signs the exact length and If-None-Match: *, so it can never replace stored bytes. Upload again under a new id.

POST/api/admin/storage/upload-url
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
fileIdstringrequired
prefixstringrequired
Allowed:servicescertificates
contentLengthintegerrequired
min 1 · max 9007199254740991
Responses
200

Success

uploadUrlstringrequired
headersobjectrequired
401

Unauthorized

errorstringrequired
409

Response for status 409

errorstringrequired
413

Response for status 413

errorstringrequired
422

Validation failed

typestringrequired
onstringrequired
summarystring
messagestring
foundany
propertystring
expectedstring
500

Unhandled server error

errorstringrequired
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST '/api/admin/storage/upload-url' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "fileId": "string",
  "prefix": "services",
  "contentLength": 1
}'
Response
{
  "uploadUrl": "string",
  "headers": {
    "property1": "string",
    "property2": "string"
  }
}