POST/vendor/products/import/uploadVendor bearer token required

Upload CSV for Bulk Import

Upload a CSV file to create an async bulk import job (multipart/form-data).

What this means in plain English

Uploads a CSV (max 64MB) and queues an async import job. Requires OWNER, ADMIN, or EDITOR role.

When to use this

Importing large product catalogs from ERP/PIM systems.

Headers

Name	Type	Required	Description
X-Vendor-Id	string (UUID)	Yes	UUID of the vendor context. Required for vendor-scoped endpoints when your account has multiple vendor memberships. Use the vendor.id from the login response.

Request example

curl -X POST 'http://localhost:8080/api/v1/vendor/products/import/upload' \
  -H 'X-Vendor-Id: 550e8400-e29b-41d4-a716-446655440010'

Response examples

201Created

{
  "id": "550e8400-e29b-41d4-a716-446655440050",
  "status": "PROCESSING",
  "filename": "catalog.csv",
  "totalRows": 1200,
  "processedRows": 450
}

Status codes

200

Request succeeded.

401

Unauthorized

Missing or invalid bearer token.

403

Forbidden

Insufficient permissions for this action.

400

Bad Request

Validation failed or invalid parameters.

404

Not Found

Resource not found.

500

Internal Server Error

Unexpected server error.

403

Forbidden

Invalid X-Vendor-Id, no vendor membership, or insufficient vendor role (requires OWNER, ADMIN, or EDITOR for write operations).

Send as multipart/form-data with field name "file" (CSV) and optional "name".

Example: curl -X POST .../import/upload -H "Authorization: Bearer TOKEN" -H "X-Vendor-Id: UUID" -F "file=@catalog.csv"

Try it

Edit values below to generate a cURL command. This endpoint requires multipart upload — run in your terminal.

Bearer tokenX-Vendor-IdHeader: X-Vendor-Id *

Copy-only

Multipart and file-download endpoints cannot be executed from the browser panel. Copy the cURL command and run it in your terminal.