Generate a signed upload URL | Cata API

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

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

Request

This endpoint expects an object.

filenamestringRequired

contentTypestringRequired

Response

codeinteger

isSuccessboolean

messagestring

uploadUrlstringformat: "uri"

publicUrlstringformat: "uri"

Errors

400

Bad Request Error

401

Unauthorized Error

1	curl -X POST http://localhost:8080/api/v1/uploads/signed-url \
2	-H "X-Tenant-ID: string" \
3	-H "X-Api-Key: <apiKey>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"filename": "product-hero.jpg",
7	"contentType": "image/jpeg"
8	}'

1	{
2	"code": 200,
3	"isSuccess": true,
4	"message": "Upload URL generated",
5	"uploadUrl": "https://storage.googleapis.com/bucket/tenant/items/uuid-product-hero.jpg?X-Goog-Signature=...",
6	"publicUrl": "https://storage.googleapis.com/bucket/tenant/items/uuid-product-hero.jpg"
7	}

Authentication

Headers

Request

Response

Errors