a6-plugin-response-rewrite

Overview

The response-rewrite plugin rewrites response attributes before APISIX returns the response to the client. You can change the HTTP status code, response headers, and response body — either unconditionally or based on matching conditions. It runs in the header_filter and body_filter phases, so it executes even if earlier plugins (like auth) call ngx.exit.

When to Use

• Override the HTTP status code returned to clients
• Add, set, or remove response headers (e.g., security headers, CORS)
• Replace the entire response body (static content, error messages)
• Use regex filters to modify parts of the response body
• Apply response changes conditionally (e.g., only for certain status codes)
• Serve base64-decoded binary content (images, protobuf)