KintsugiKintsugi

Update a marketplace's confirmation status

PATCH/marketplaces/{marketplace_id}

Set a marketplace's confirmation status. The update is processed asynchronously: every transaction currently matched to this marketplace is queued to be re-evaluated, and processingStatus on the response tracks that job. Returns 409 if a previous change to this marketplace is still processing.

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

marketplace_idstringRequired

The unique identifier of the marketplace.

Body

statusPublicMarketplaceStatusEnumRequired

New confirmation state to set.

Available options:YESNONEEDS_REVIEW
requestIdstring

Optional client-generated id for this confirm attempt (a UUID or a short slug), stored on the audit trail so a later read can tell repeated confirms apart.

Response

idstringRequired

Kintsugi's unique identifier for this marketplace registry row.

organizationIdstringRequired

Organization this marketplace registry belongs to.

clientNamestring

Display name of the organization this marketplace belongs to, or null when the organization has no name set.

connectionIdstring

Connection this marketplace channel is synced through, or null when it is not tied to one.

sourceIdstring

Secondary source id the connector reported for this channel, or null when it reported none.

sourceNamestring

Secondary source name the connector reported for this channel (e.g. Amazon, eBay), or null when it reported none.

sourceTypestring

Integration source that synced this registry row, or null when it is not tied to one.

statusPublicMarketplaceStatusEnumRequired

Confirmation state: whether transactions matched to this row are treated as marketplace-facilitated sales.

Available options:YESNONEEDS_REVIEW
processingStatusPublicMarketplaceProcessingStatusEnumRequired

Progress of the last change to status.

Available options:IDLEPROCESSINGCOMPLETEDFAILED
transactionsintegerRequired

Count of transactions currently matched to this registry row.

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

A previous change to this marketplace is still processing.

422

The request failed validation.

cURL
PATCH /marketplaces/{marketplace_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"status": "YES",
"requestId": "b3f2c1a0-1e2d-4a3b-9c8d-7e6f5a4b3c2d"
}
Example request
https://api.trykintsugi.com/marketplaces/{marketplace_id}
Response
{
"id": "mktpl_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"clientName": "Acme Corp",
"connectionId": "conn_2mNpQr7Ls8f3k",
"sourceId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"sourceName": "Acme Corp",
"sourceType": "SHOPIFY",
"status": "YES",
"processingStatus": "IDLE",
"transactions": 1
}
Update a marketplace's confirmation status (2026-07-21) | Kintsugi API Reference