The jq plugin enables arbitrary jq transformations on JSON objects included in API requests or responses.
The configuration accepts two sets of options: one for the request and another for the response. For both the request and response, a jq program string can be included, along with some jq option flags and a list of media types.
One of the configured media types must be included in the
Content-Type header of
the request or response for the jq program to run. The default media type in the
In the response context, you can also specify a list of status
codes, one of which must match the response status code.
The default response status code is
- In the response context the entire body must be buffered to be processed. This requirement also implies that the
Content-Lengthheader will be dropped if present, and the body transferred with chunked encoding.
- To use this plugin in Konnect, upgrade your runtimes to at least v126.96.36.199.
See jq’s documentation on Basic filters for more information on writing programs with jq.