Skip to content
Trile Docs

Upload a product image (multipart "file": SVG/PNG/JPEG, max 2 MB). Stores in object storage, sets imageUrl, emits a product.updated audit row.

POST
/v1/catalog/products/{productId}/image

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
productId
required
string

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string

Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)

Request Body required

Section titled “Request Body required ”
object
file
required
string format: binary

Responses

Section titled “ Responses ”

201

Section titled “201 ”
object
success
required
boolean
data
required
object
id
required
string
businessId
required
string
environment
required
string
Allowed values: sandbox live
name
required
string
description
required
string
nullable
active
required
boolean
imageUrl
required
string
nullable
metadata
required
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
meta
required
object
requestId
required
string