Skip to navigation
POS Integration Service APIAPIV1UploadsSigned URL

Generate a signed upload URL

View as MarkdownOpen in Claude

Generate a pre-signed GCS URL for direct browser-to-cloud image upload. The client uses the returned uploadUrl to PUT the file directly to GCS, then uses publicUrl as the image reference (e.g. for mainImageUrl on products).

Constraints:

  • Allowed content types: image/jpeg, image/png, image/webp
  • Maximum file size: 5 MB
  • Signed URL expires after 15 minutes

Authentication

X-Api-Keystring
API Key authentication via header

Headers

X-Tenant-IDstringOptional
Tenant identifier

Request

This endpoint expects an object.
filenamestringRequired
contentTypestringRequired

Response

OK
codeinteger
isSuccessboolean
messagestring
uploadUrlstringformat: "uri"
publicUrlstringformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error