Skip to main content
Product refresh lets you update a known set of product pages without waiting for the standard catalog update cadence. Use it when your system already knows which products changed, such as a new drop, a merchandiser correction, or a small set of products that should be updated quickly. Refresh starts an asynchronous Octogen workflow: the product pages are recrawled, re-extracted, and re-indexed in sequence. The API returns as soon as the request is accepted; refreshed data — including a product’s active status on lookup — typically becomes visible within a few hours, not minutes.

​
Choose identifiers

Use the identifier you already have: Every target must contain exactly one of url or uuid. Add catalog when you want to pin the request to one active crawled catalog.

​
Make a request

The response includes a workflowId that Octogen support can use to trace the refresh. You do not need to poll it for normal use.

​
Handle partial success

The endpoint accepts valid targets and rejects invalid targets in the same response. Treat accepted as scheduled work and rejected as caller-actionable feedback.
If every target is rejected, the API returns 400 with the same response shape. Fix the rejected targets and retry.

​
Retry guidance

Retry 503 responses and transient network errors. Do not automatically retry 400, 403, or 422; those require a request change. Avoid sending the same large request repeatedly. If you need to refresh many products, batch up to 500 targets per call and retry only the targets that were rejected for transient reasons.