Refresh Single Product
POST/api/magento2/integration-instances/:magento2IntegrationInstance/products/:product/refresh-single
Synchronous single-product resync. Looks up the product in Magento by its SKU, upserts the local row, and returns the refreshed Magento2ProductResource so the frontend can swap the row in place. No tracked_job_log_id is returned (unlike the bulk Refresh Products endpoint).
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
No request body.
Error responses:
404— product does not exist OR belongs to a different instance.422— local product row has no SKU (cannot resolve it against Magento).502(or the upstream status, when 4xx) — the Magento API call failed.
The mapped SKU.io product is returned as a product object alongside subscription_offering and revenue_line — the three things a channel listing can be mapped to. is_mapped is true when ANY of them is set, so a listing mapped to a revenue line reports mapped even though it has no product (revenue lines never touch inventory). mapped_at is when the mapping was created.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
- 502
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.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.
Bad Gateway