headers

Adds, sets, or removes headers on upstream requests and downstream responses.
On this page

Adds, sets, or removes headers on upstream requests and downstream responses.

Configuration

FieldTypeRequiredDescription
request_addHeaderPair[]noHeaders to append to the upstream request.
request_add[].namestringyesHeader field name.
request_add[].valuestringyesHeader field value.
request_removestring[]noHeader names to remove from the upstream request.
request_setHeaderPair[]noHeaders to set on the upstream request (overwrites existing values).
request_set[].namestringyesHeader field name.
request_set[].valuestringyesHeader field value.
response_addHeaderPair[]noHeaders to append to the downstream response.
response_add[].namestringyesHeader field name.
response_add[].valuestringyesHeader field value.
response_removestring[]noHeader names to remove from the downstream response.
response_setHeaderPair[]noHeaders to set on the downstream response (overwrites existing values).
response_set[].namestringyesHeader field name.
response_set[].valuestringyesHeader field value.

Example

filter: headers
request_add:
  - name: X-Forwarded-By
    value: praxis
request_set:
  - name: X-Custom-Auth
    value: bearer-token
request_remove:
  - X-Internal-Only
response_add:
  - name: X-Frame-Options
    value: DENY
response_remove:
  - X-Backend-Server
response_set:
  - name: Server
    value: praxis