Skip to main content
POST
/
v2
/
categories
/
import
Bulk Import Categories
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
{
  "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

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"