# Header

Evaluate messages based on header inspection. Supports header existence checks and regex pattern matching. Header name matching is case-sensitive.

Uses OR logic -- the rule matches if any configured header exists or matches.

**Type:** message

**Variants:**

| Action  | ID                                                       |
| ------- | -------------------------------------------------------- |
| allow   | `com.synadia.protect.builtins.v1.allow.header.message`   |
| deny    | `com.synadia.protect.builtins.v1.deny.header.message`    |
| suspend | `com.synadia.protect.builtins.v1.suspend.header.message` |

## Configuration

A map of header names to regex patterns. An empty string checks for header existence only:

```
activations:

  com.synadia.protect.builtins.v1.allow.header.message: true



configurations:

  com.synadia.protect.builtins.v1.allow.header.message:

    X-API-Key: '' # header must exist

    X-App-Version: "^2\\." # value must match regex

    X-Tenant: '^(prod|staging)$' # multiple patterns supported
```

## Schema

```
{

  "type": "object",

  "additionalProperties": {

    "type": "string",

    "format": "regex",

    "description": "Regex pattern (empty = existence check)"

  },

  "propertyNames": {

    "minLength": 1

  },

  "minProperties": 1

}
```
