Bulk Import Categories

Upload a CSV file to import category data for the specified brand/domain. The import is processed asynchronously.

Expected CSV columns

• name or category_name (required): Category name
• parent_id or parent_category_id (optional): Parent category ID
• breadcrumb (optional): Full breadcrumb path
• inferred_category (optional): AI-inferred category

POST /v2/categories/import

Bulk Import Categories

cURL

curl --request POST \
  --url https://commerceos.aiagents.fabric.inc/api/v2/categories/import \
  --header 'Content-Type: multipart/form-data' \
  --header 'domain: <domain>' \
  --form file='@example-file' \
  --form 'name=Spring catalog category import' \
  --form notify_email=true

202

{
  "import_id": "a0cf63a0-55b8-4a25-9218-d972d4d65a79",
  "status": "PENDING",
  "message": "Import queued. Use GET /categories/import/{import_id} to track progress.",
  "created_at": "2026-03-12T17:58:13.605818Z"
}

Headers

domain · string · required

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.

Example:

"vessel.com"

Body

multipart/form-data

file · file · required

CSV file containing categories (e.g. categories.csv)

name · string

Human friendly import name

Example:

"Spring catalog category import"

notify_email · boolean · default: true

Send an email when the import completes.

Example:

true

Response

202

application/json

Import accepted for asynchronous processing

import_id · string<uuid> · required

Identifier for the import job.

Example:

"a0cf63a0-55b8-4a25-9218-d972d4d65a79"

status · string · required

Example:

"PENDING"

message · string · required

Status message for the queued import.

Example:

"Import queued. Use GET /categories/import/{import_id} to track progress."

created_at · string<date-time> · required

Timestamp when the import was created.

Example:

"2026-03-12T17:58:13.605818Z"