change_request_parameters

Fix code indicating the request parameters are invalid and must be corrected before retrying.

What this means

The Commerce API has determined that your request contains one or more parameter values that don't meet validation requirements, and you must modify these parameters before retrying the operation. This is the most actionable fix code you'll encounter—it tells you that the solution is in your hands and requires changing your request. The error detail field will specify exactly which parameter is problematic and what constraint it violated, giving you clear direction on what to fix. For example, if you paginate through orders with page_number: 15 and receive this fix code, you need to change the page number to a value between 1 and 10 before retrying.

Similarly, if paying for an order fails with this fix code because the provided payment_method_id doesn't exist, you need to use a valid payment method ID from your application. Unlike repeat_same_request which tells you to retry unchanged, this fix code explicitly indicates that retrying with the exact same parameters will always fail—you must examine the error detail, understand what's invalid, correct those specific values, and then resubmit the modified request.

Example error response

{
  "error": {
    "type": "invalid_request_parameter",
    "cause": "invalid_request_parameter",
    "code": "1564",
    "message": "page_number out of bounds",
    "detail": "The `page_number` value you provided, `15`, is out of bounds. It should be between 1 and 10 inclusive.",
    "fix_code": "change_request_parameters",
    "url": "https://commerce.zebo.dev/e/1564"
  }
}

Related errors

• invalid_request_parameter - Error type often paired with this fix code
• missing_request_parameter - Related validation cause