Tearleads

POST/blobs/stages/multipart/{stageId}/parts/{partNumber}/upload

Authorize a direct multipart blob part upload

Operation blobs.multipartStages.parts.authorize

Description

Returns a short-lived signed URL for uploading one part of a blob stage directly to object storage, for parts after the first batch or to renew an expired URL. Only the stage's owner may call it. The URL is scoped to the exact part number, byte length, and Content-MD5, and expiry never invalidates parts already uploaded.

Authentication

Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.

Parameters

NameInTypeDetails
stageIdpathstringrequired
  • UUID
partNumberpathintegerrequired
  • at least 1

Request body

application/jsonobject

3 fields
  • byteLengthintegerrequired
    • 1 to 33,554,432
  • contentMd5stringrequired
    • base64, pattern ^[A-Za-z0-9+/]{21}[AQgw]==$
  • uploadIdstringrequired
    • not empty

Responses

200 OK

application/jsonobject

6 fields
  • byteLengthintegerrequired
    • 1 to 33,554,432
  • contentMd5stringrequired
    • base64, pattern ^[A-Za-z0-9+/]{21}[AQgw]==$
  • partNumberintegerrequired
    • 1 to 10,000
  • stageIdstringrequired
    • UUID
  • uploadIdstringrequired
    • not empty

Other responses

StatusMeaningBody
400Bad Request

application/jsonErrorResponse

401Unauthorized

application/jsonSessionFailureResponse

403Forbidden

application/jsonErrorResponse

404Not Found

application/jsonErrorResponse

409Conflict

application/jsonErrorResponse

500Internal Server Error

application/jsonErrorResponse

503Service Unavailable

application/jsonErrorResponse