Skip to main content

​
Error shape

Failed requests return JSON with success: false and an error message: 
{
  "success": false,
  "error": "Missing or invalid API key"
}

​
HTTP status codes

StatusMeaningWhat to do
400Bad request — invalid action, malformed skus, etc.Fix the request body
401Missing or invalid API keyVerify the Authorization header
405Wrong HTTP methodUse POST only
500Server errorRetry with exponential backoff
502 / 503Upstream unavailableRetry with backoff; contact Keystone if persistent

​
Retry guidance

  • Use exponential backoff for 5xx responses.
  • 400 and 401 errors are not retryable without changing the request.
  • For bulk syncs, paginate with limit / offset rather than sending very large skus arrays.