Upload a catalog artifact
Uploads a catalog CSV as multipart form data and returns an artifact_id for use when starting an optimization workflow.
The HTTP client must set the Content-Type: multipart/form-data header with the appropriate boundary; the header should not be set manually. The domain header is required and must be a brand domain (for example, vessel.com) that the authenticated principal is authorized to access.
Each request creates a new artifact, even when the file content is identical to a previously uploaded file. Retain the returned artifact_id for the workflow that will reference it.
For catalogs larger than approximately 100 MB, contact fabric support to enable the presigned-URL upload flow.
Catalog CSV format
The uploaded file must be UTF-8 encoded, comma-delimited, and include a header row. The supported columns are:
| Column | Required | Description |
|---|---|---|
title | Yes | Product display name as shown on the product detail page. |
sku | Yes | Unique product identifier within the brand catalog. |
description | Yes | Full product description from the product detail page. |
category_id | Conditional | The brand’s category identifier. Each row must provide either category_id or breadcrumb. |
breadcrumb | Conditional | Full category hierarchy separated by > (for example, Mens > Clothing > Pants). Each row must provide either breadcrumb or category_id. |
category | No | Free-text category label. Used as a hint when neither category_id nor breadcrumb resolves to a known category. |
product_group_id | No | Identifier shared by product variants that belong to the same family. |
price | No | Numeric price value for the product. |
currency | No | Currency code corresponding to price. |
url | No | Canonical product detail page URL. |
images | No | One or more image URLs separated by the pipe character (|). |
attribute.<name> | No | Custom attribute value. Free-form string, single value per cell. The <name> segment must match an attribute key configured for the brand. |
For a worked end-to-end example including auth and workflow creation, see the Product Import Developer Guide.
Documentation Index
Fetch the complete documentation index at: https://developer.fabric.inc/llms.txt
Use this file to discover all available pages before exploring further.
Headers
The brand domain name (for example, vessel.com or containerstore.com) used to scope the request to a specific brand's data and configuration. The authenticated principal must be authorized for the specified brand.
"vessel.com"
Body
Response
Artifact uploaded
Stable identifier for the artifact. Reference this value when creating a workflow.
"art_95c650ded4824dc79bb6df16427e4a10"
Artifact file format. The supported value is csv.
csv Indicates how the artifact was ingested. upload denotes a direct multipart upload, presigned denotes the presigned-URL flow used for large files, uri denotes a server-side fetch from an external URI, and generated denotes a system-produced artifact.
upload, presigned, uri, generated MIME type as detected by the server.
"text/csv"
Internal storage URI for the artifact. Informational only.
"s3://product-agent-data-prod-ue2/optimize-artifacts/svc_yourClientId/art_95c650ded4824dc79bb6df16427e4a10/catalog.csv"
The brand the artifact is associated with, derived from the domain header.
"691df5949676c8e0b1d7b6b3"
Upload timestamp in UTC.
"2026-05-15T10:30:00Z"
File size in bytes.
45678
Hex-encoded SHA-256 checksum of the file contents.
"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
The filename submitted with the multipart upload.
"catalog.csv"