Schema

FileUpload

Where and how to send the file: one PUT of its bytes to uploadUrl, with the same Content-Type, before expiresAt. The URL needs no Authorization header: give it to the browser that holds the file.

Fields

  • uploadUrlstring (uri)
    https://api.printags.com/v2/uploads/<token> (https://sandbox-api.printags.com/... when asked on the sandbox host). The token is signed, bound to the account and to the key's mode (test or live), valid 15 minutes and good for one file. Treat it as a secret until it is used.
  • methodstring: PUT
  • contentTypestring: image/png, image/jpeg, application/pdf
  • maxBytesinteger
    The largest file the URL takes (25 MB)
  • expiresAtstring (date-time)
Example
{
  "uploadUrl": "https://api.printags.com/v2/uploads/eyJhIjoiN2IxZTJhNGMifQ.c2lnbmF0dXJl",
  "method": "PUT",
  "contentType": "image/png",
  "maxBytes": 26214400,
  "expiresAt": "2026-11-10T13:15:00.000Z"
}