langgraph/docs/docs/cloud/how-tos/configurable_headers.md

Configurable Headers

LangGraph allows runtime configuration to modify agent behavior and permissions dynamically. When using the LangGraph Platform, you can pass this configuration in the request body (config) or specific request headers. This enables adjustments based on user identity or other request data (see the configuration how-to for more details on how to access within your graph).

For privacy, control which headers are passed to the runtime configuration via the http.configurable_headers section in your langgraph.json file.

Here's how to customize the included and excluded headers:

{
  "http": {
    "configurable_headers": {
      "include": ["x-user-id", "x-organization-id", "my-prefix-*"],
      "exclude": ["authorization", "x-api-key"]
    }
  }
}

The include and exclude lists accept exact header names or patterns using * to match any number of characters. For your security, no other regex patterns are supported.