Cancel a bulk-classification import

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

Cancel a bulk-classification import before it is confirmed. Returns 404 if the import does not exist or belongs to an organization your credential cannot access, and 409 if it cannot be cancelled in its current state.

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.

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

alreadyCancelledboolean

True when this import was already cancelled.

200

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.

cURL

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

-H "Api-Key: ***"

-H "Api-Version: 2026-07-21"

Example request

https://api.trykintsugi.com/products/bulk-classifications/{import_id}/cancel

Response

{

"importId": "impt_2mNpQr7Ls8f3k",

"status": "VALIDATING",

"alreadyCancelled": false

}