Import Part Compatibilities
POST/api/repairs/part-compatibilities/import
Upserts part compatibility from a CSV file. Headers: part_sku (required), product_sku, category (a category path or ID), issue_type (an ID or a "Parent › Child" path), default_quantity (default 1). Each row needs a product SKU, category or issue type. Rows are matched on part + product + category + issue type, so re-importing updates quantities instead of duplicating rows.
repairs:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body (multipart/form-data):
file(file, required) — CSV or TXT, max 20 MB, up to 50,000 rows.
Files up to 1,000 rows import immediately and return created, updated and errors (row, message per skipped row). Larger files run in the background: queued is true and tracked_job_log_id identifies the job.
Authentication: Bearer token with the repairs:write scope.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.