Refresh Target Plus Listings
POST/api/target-plus/:integrationInstance/listings/refresh-tracked
Queues a background re-read of the seller's catalog from Target Plus and returns the tracked job ID right away. New items are added, changed items are updated, and new listings are linked to (or create) SKU.io products according to the integration's settings.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body: mode (optional): since_latest (default) reads items changed since the last refresh; full_catalog reads every item; date_range reads every item Target changed since dateFrom (Y-m-d, required with date_range, the start of that day in the account's time zone). dateTo (Y-m-d, optional, on or after dateFrom) is accepted, but Target's catalog query takes a start date only, so the read runs up to now. A date_range read does not move the incremental since_latest starting point.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
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.