v1

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-1341511.2 KB
Transfer Tickets

Create an upload transfer ticket

Creates either:

  • a single PUT upload ticket for smaller files, or
  • a multipart upload session for larger files.

The client supplies sizeBytes and the API decides which upload path to use.

post/transfer-tickets

Request body

clientIdstring required
fileNamestring required
contentTypestring
sizeBytesinteger required
requestedExpirySecondsinteger
contentMd5string

Base64-encoded MD5 digest for single PUT uploads only

Example request

{
  "clientId": "products-poc",
  "fileName": "example-upload.csv",
  "contentType": "text/csv",
  "sizeBytes": 12345,
  "requestedExpirySeconds": 900,
  "contentMd5": "CY9rzUYh03PK3k6DJie09g=="
}

Response

Upload session created

OR

Example response

{
  "upload": {
    "method": "PUT"
  }
}
All 4 operations