Response Overrides

Use these System Parameters to customize the status code or message APIEase returns after a request completes. For example, a workflow can complete successfully but return a business result such as 409 with the message Item unavailable.

Set a response code or message

Add either or both parameters to the saved request with type System:

Name	Example value	Effect
APIEASE_RESPONSE_CODE_OVERRIDE	409	Set the response status code.
APIEASE_RESPONSE_MESSAGE_OVERRIDE	Item unavailable	Set the response's message field.

The code must be an integer from 200 through 599, or its three-digit text representation. The message must be text; an empty string is allowed. Unresolved variable references are not accepted as override values.

Direct overrides do not require either of the flags below. Their values can also use normal request variable substitution, such as {responseCode} or {responseMessage} from a previous request's response. The resolved values must meet the same code and message rules.

These direct overrides apply to completed HTTP responses and successful System, Liquid, or Flow results. An HTTP destination's error status, such as 404, can be overridden when APIEase received a normal HTTP response; a transport failure cannot.

Overrides change the APIEase response, not the destination API or the work already performed. The message is a response field, not an HTTP reason phrase. Response data remains unchanged by the override, although HTTP statuses 204, 205, and 304, and HEAD responses, are sent without a body.

Read overrides from a Flow or Liquid result

For a result-dependent status or message, enable either or both flags:

Name	Value	Field read from the result
OVERRIDE_APIEASE_RESPONSE_CODE	true	apieaseSystemData.apieaseResponseCodeOverride
OVERRIDE_APIEASE_RESPONSE_MESSAGE	true	apieaseSystemData.apieaseResponseMessageOverride

The flags default to disabled. Enter lowercase true as the parameter value to enable each one independently. These flags read completed Flow or Liquid output; HTTP and System results do not supply output-based overrides.

For Liquid, make the rendered result a JSON object with apieaseSystemData at its top level:

{
  "available": false,
  "apieaseSystemData": {
    "apieaseResponseCodeOverride": 409,
    "apieaseResponseMessageOverride": "Item unavailable"
  }
}

For Flow, include the same apieaseSystemData object at the top level of the JSON returned through APIEase Flow Action, alongside the original executionId supplied by the trigger. Preserve that execution ID so APIEase can resolve the waiting call. See Minimal Flow integration for callback setup.

The returned apieaseSystemData object is separate from the apieaseMetaData System Variable. It must be in the current result, not nested inside another result property.

Precedence and invalid values

APIEase resolves the code and message independently, using this order:

1. A valid value from the Flow or Liquid result, when its corresponding flag is true.
2. A valid direct System parameter value.
3. The normal response code or message.

Invalid override values are ignored and reported with an INVALID_RESPONSE_OVERRIDE warning. An invalid output override can therefore fall back to a valid direct setting. Removing the parameters restores normal response behavior.

Responses that are not overridden

Overrides do not replace authentication or validation failures, concurrency rejections, transport errors, failed execution, or incomplete Flow results. In particular, queued Flow acknowledgments, immediate Flow responses, Flow wait timeouts, and immediate Liquid acknowledgments keep their normal responses.

To use a Flow or Liquid result to determine the response, keep immediate response disabled. See Flow Parameters and Liquid Parameters.

In a request chain, these settings apply to the current request's result. A later request can supply the final response returned by the chain; configure overrides on the request whose response you intend to return.