Skip to main content
POST
/
v2
/
taxonomy-workflow
Bulk Import Products
curl --request POST \
  --url https://commerceos.aiagents.fabric.inc/api/v2/taxonomy-workflow \
  --header 'Content-Type: multipart/form-data' \
  --header 'domain: <domain>' \
  --form file='@example-file' \
  --form 'name=My Catalog Upload' \
  --form enable_manual_review=true \
  --form review_confidence_threshold=0.6
{
  "id": "a1462a91-f733-45fe-993b-5d0353f33ee3",
  "brand_id": "268465dd-71f5-4179-959c-9bac01029451",
  "status": "PENDING",
  "workflow_type": "ATTRIBUTE_AND_CATEGORY_MAPPING",
  "import_document_path": "taxonomy-workflow/vessel/d6441888-f25d-4acb-8898-07808526ecdb/d6441888-f25d-4acb-8898-07808526ecdb_input.csv",
  "created_at": "2026-03-12T17:54:07.374339Z",
  "updated_at": "2026-03-12T17:54:07.374339Z",
  "total_category_mappings": 0,
  "total_attribute_mappings": 0,
  "workflow_id": "a1462a91-f733-45fe-993b-5d0353f33ee3",
  "workflow_status": "PENDING",
  "tenant_id": "268465dd-71f5-4179-959c-9bac01029451",
  "workflow_phase": "PRE_PROCESS",
  "domain": "vessel",
  "total_items": 0,
  "processed_items": 0,
  "successful_items": 0,
  "failed_items": 0,
  "total_chunks": 0,
  "processed_chunks": 0,
  "input_file_id": "69b2fdbfd1dcca3911c666e6",
  "output_file_id": null,
  "error_file_id": null,
  "review_required": false,
  "review_task_id": null,
  "enrichment_workflow_id": null,
  "error_message": null
}

Headers

​
domain
string
required

The brand domain or brand identifier used to scope the request to a specific brand’s data and configuration.

Example:

"vessel"

Body

multipart/form-data
​
file
file
required

CSV file containing product rows.

​
name
string

Workflow name (auto-generated if omitted).

Example:

"My Catalog Upload"

​
enable_manual_review
boolean
default:true

Enable manual review step.

Example:

true

​
review_confidence_threshold
number<float>
default:0.6

Confidence threshold from 0.0 to 1.0.

Required range: 0 <= x <= 1
Example:

0.6

Response

Workflow created

​
id
string<uuid>
required

Workflow identifier.

Example:

"a1462a91-f733-45fe-993b-5d0353f33ee3"

​
brand_id
string<uuid>
required
Example:

"268465dd-71f5-4179-959c-9bac01029451"

​
status
string
required
Example:

"PENDING"

​
workflow_type
string
required
Example:

"ATTRIBUTE_AND_CATEGORY_MAPPING"

​
import_document_path
string
required
Example:

"taxonomy-workflow/vessel/d6441888-f25d-4acb-8898-07808526ecdb/d6441888-f25d-4acb-8898-07808526ecdb_input.csv"

​
created_at
string<date-time>
required
Example:

"2026-03-12T17:54:07.374339Z"

​
updated_at
string<date-time>
required
Example:

"2026-03-12T17:54:07.374339Z"

​
total_category_mappings
integer
required
Example:

0

​
total_attribute_mappings
integer
required
Example:

0

​
workflow_id
string<uuid>
required
Example:

"a1462a91-f733-45fe-993b-5d0353f33ee3"

​
workflow_status
string
required
Example:

"PENDING"

​
tenant_id
string<uuid>
required
Example:

"268465dd-71f5-4179-959c-9bac01029451"

​
workflow_phase
string
required
Example:

"PRE_PROCESS"

​
domain
string
required
Example:

"vessel"

​
total_items
integer
required
Example:

0

​
processed_items
integer
required
Example:

0

​
successful_items
integer
required
Example:

0

​
failed_items
integer
required
Example:

0

​
total_chunks
integer
required
Example:

0

​
processed_chunks
integer
required
Example:

0

​
input_file_id
string
required
Example:

"69b2fdbfd1dcca3911c666e6"

​
review_required
boolean
required
Example:

false

​
output_file_id
string | null
Example:

null

​
error_file_id
string | null
Example:

null

​
review_task_id
string | null
Example:

null

​
enrichment_workflow_id
string | null
Example:

null

​
error_message
string | null
Example:

null