Trigger a manual sync (orders / products / transactions) for one or more sites
POST/v1/manual-sync
Dispatch background jobs to fetch data from connected platforms. Supports Amazon (Seller), Etsy, WooCommerce, and others via site_id or site_ids. Rate-limited to 5 syncs per hour per (site, type). Returns 202 immediately — progress must be polled via GET /v1/sync-progress/{site_id} (separate endpoint). Provide EXACTLY ONE of site_id or site_ids.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
Sync accepted and dispatched (actual status code returned by server is 200 with success=true)
No sites to sync or credentials invalid
Unauthenticated
User not authorized for requested sites
No valid sites found
Some sites already syncing
Validation error
Rate limit exceeded (5 syncs per hour per site per type)