Sign InBook a Demo
Support

Asset APIs

POSTCreate Assets

Create or update asset links with rank assignment. Supports batch input.

POSThttps://api.catalogix.ai/v1/assets

Authorization

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

Query parameters

store_uuidstringrequired
Store identifier
Example: 699ec31355208b213e56059a

Headers

X-Request-Idstring
Optional trace ID

Body

application/json required

An array of objects. Each item:

parent_codestringrequired
Parent/product code
Example: SKU001
asset_typestring
Defaults to image. Must be one of the store's supported doc types, or the request fails with 400.
Allowed: image video pdf 3D text
Example: image
product_uuidstring
Optional; resolved via search API if not provided
channelsobjectrequired
Channels to upsert this parent_code's assets under, keyed by channel name, each an ordered URL list (see below). Each channel must be enabled on the store's own settings, or the request fails with 400 before any asset is written.

Responses

200Assets created or updated
statusobject
Fields
codeinteger
0 = success, -1 = error
Example: 0
messagestring
Example: SUCCESS
request_idstring
Example: 8c8b2b7e-23d7-4c2a-91b0-2a7c4dfbb312
dataobject
Fields
createdinteger
Example: 1
updatedinteger
Example: 0
failedinteger
Example: 0
error_infoobject[]
400Validation error: an asset_type not in the store's supported doc types, a channel not enabled for this store, or a channel's URL list longer than its image-config attribute order.
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
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