Refresh Amazon Marketplace Offers
POST/api/v2/sales-channels/:integrationInstance/prices/marketplace-offers/refresh
Re-read this account's offers in every non-home marketplace from Amazon: each SKU's price and status per marketplace, whether it is a listing native to the marketplace or an offer created from the home listing, whether its price is still the home listing's number in another currency, and its margin. An offer missing from three complete reads in a row is marked as no longer listed. Runs in the background and returns a tracked job ID to poll. No request body.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.update permission.
Returns 202 with data.tracked_job_log_id. Returns 422 when a refresh is already running for this account, and 404 for a sales channel that is not Amazon.
Request
Responses
- 202
- 401
- 403
- 404
- 422
- 429
Accepted
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
Response Headers
Unprocessable Content
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.