KintsugiKintsugi

Approve partially-approved products in bulk

POST/products/bulk-approve

Approve partially-approved products in one organization, either by naming productIds (at most 100) or by filters. Provide exactly one of the two: sending both, or neither, returns 400. The approval is atomic: either every matched product is approved or none is. approvedCount and skippedCount report what actually changed, not how many you asked for. An id that is not partially-approved, does not exist, or belongs to an organization your credential cannot access is counted in skippedCount, never approved. Send the target organization as Organization-Id when your credential owns more than one.

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.

Body

productIdsstring[]

Explicit product ids to approve (at most 100). Mutually exclusive with filters; provide exactly one of the two. An id that is not partially-approved, not found, or in an organization you cannot access is counted in skippedCount, never approved.

filtersBulkApproveFilters

Attribute filters selecting which partially-approved products to approve. Mutually exclusive with productIds; provide exactly one of the two.

Response

approvedCountintegerRequired

Number of products moved to APPROVED by this request.

skippedCountintegerRequired

Number of requested products left unchanged because they were not partially-approved, not found, or outside your access. Always 0 for a filter-based request.

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.

422

The request failed validation.

503

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

cURL
POST /products/bulk-approve
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"productIds": [
"prod_1",
"prod_2"
],
"filters": {
"productCategory": "Physical",
"productSubcategory": "General Clothing",
"source": "SHOPIFY"
}
}
Response
{
"approvedCount": 2,
"skippedCount": 1
}
Approve partially-approved products in bulk (2026-07-21) | Kintsugi API Reference