Skip to main content

change_request_parameters

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

What this means

The Inttegro 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 because the provided payment_method_id does not exist, use a valid payment method ID. Unlike repeat_same_request, this fix code means the request will continue to fail until you correct the parameter identified by the error.

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://studio.inttegro.com/e/1564"
  }
}