KintsugiKintsugi

Confirm a bulk-classification import

POST/products/bulk-classifications/{import_id}/confirm

Confirm a review-ready bulk-classification import and queue it to apply. idempotencyKey makes a retried confirm safe: resending the same key returns the same result rather than confirming twice. Returns 409 if the import is not review-ready, has no valid rows, or a different idempotencyKey was already recorded for it.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

import_idstringRequired

The unique identifier of the import.

Body

idempotencyKeystringRequired

A caller-chosen key. Resending the same key for this import returns the same confirmation instead of confirming twice.

Response

importIdstringRequired

The unique identifier of this import.

statusPublicProductImportStatusEnumRequired

Lifecycle status of a bulk-classification import.

Every pre-validation internal status (queued, submitted, virus scan, validating) reports as VALIDATING. A virus-scan failure reports as VALIDATION_FAILURE. An import archived before completion reports as CANCELLED.

Available options:VALIDATINGVALIDATION_SUCCESSVALIDATION_FAILURECONFIRM_PENDINGIMPORT_STARTEDIMPORTINGSUCCESSFAILURECANCELLED
confirmedBystring

Id of the user who confirmed this import, or null if unconfirmed.

alreadyConfirmedboolean

True when this confirm resent an idempotency key that was already recorded, rather than confirming for the first time.

202

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /products/bulk-classifications/{import_id}/confirm
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"idempotencyKey": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10"
}
Example request
https://api.trykintsugi.com/products/bulk-classifications/{import_id}/confirm
Response
{
"importId": "impt_2mNpQr7Ls8f3k",
"status": "VALIDATING",
"confirmedBy": "confirmed by",
"alreadyConfirmed": false
}
Confirm a bulk-classification import (2026-07-21) | Kintsugi API Reference