Product APIs

PUTUpdate Product

Updates existing product data.

PUThttps://api.catalogix.ai/v1/products

Authorization

Authorizationstringrequiredheader
Bearer token, Bearer <token>. Create one under Tokens in your workspace.

Query parameters

store_uuidstringrequired
Example: 67762d4ce590324df813bd8c

Headers

X-Request-Idstring
Optional trace ID. If not provided, one is generated automatically

Body

application/json required

An array of objects. Each item:

statusstring
Allowed: active new problem inactive draft under review
Example: inactive
product_codestringrequired
Unique identifier for the product (SKU code)
Example: CI001

Responses

200Update successful
statusobjectrequired
Status of the operation
Fields
codeintegerrequired
Status code of the operation. 1 means success. -1 means failure. 0 means process moved to background
Example: 0
messagestringrequired
Message describing the status
Example: success
request_idstring
Unique trace ID for the request. Echoed from X-Request-Id header or auto-generated.
Example: 8c8b2b7e-23d7-4c2a-91b0-2a7c4dfbb312
dataobjectrequired
Data containing updated and unavailable SKUs
Fields
store_uuidstringrequired
Unique identifier for the store
Example: 67762d4ce590324df813bd8c
failed_productsobject
Products that failed to update. Keyed by product_code with error details as value.
updated_skusstring[]default: ["CI001"]
List of Products that were successfully updated
unavailable_skusstring[]default: ["CI00000000"]
List of Products that were unavailable for update
400Invalid data format
statusstringdefault: "error"
The status of the request, typically 'error'
detailstringrequired
A description of the error
401Unauthorized – Bearer token missing or invalid
statusobject
Fields
codeinteger
Example: -1
messagestring
Example: Unauthorized – invalid or missing Bearer token
404Mapping profile not found
statusstringdefault: "error"
The status of the request, typically 'error'
detailstringrequired
A description of the error
413Payload too large
statusstringdefault: "error"
The status of the request, typically 'error'
detailstringrequired
A description of the error
422Validation Error
detailobject[]
Item fields
locstring | integer[]requireddefault: ["body",""]
msgstringrequireddefault: "Field Required"
typestringrequireddefault: "missing"
500Internal server error
statusobject
Fields
codeinteger
Example: -1
messagestring
Example: Internal server error. Please contact support@catalogix.ai
502Downstream service unavailable
statusstringdefault: "error"
The status of the request, typically 'error'
detailstringrequired
A description of the error

Something missing or unclear? Write to support@streamoid.com.

esc