Skip to content

docs(agent-gateway): add forwarding headers page - #1133

Merged
narengogi merged 2 commits into
mainfrom
feat/agent-forward-headers
Nov 11, 2026
Merged

narengogi merged 2 commits into
mainfrom
feat/agent-forward-headers

Conversation

@narengogi

Copy link
Copy Markdown
Member

Documents forward_headers for agent integrations.

Changes

  • New page product/agent-gateway/forwarding-headers.mdx, modeled on the MCP forwarding headers page: config forms, renames, headers that are never forwarded, header priority, an A2A example
  • Added to the Agent Gateway nav and linked from the Agent Registry page

Testing

  • Behaviour described matches the gateway change (Portkey-AI/gateway-enterprise-node, feat/agent-forward-headers); not previewed locally

Copilot AI balanced review requested due to automatic review settings October 26, 2026 06:11
@mintlify

mintlify Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
portkey-docs 🟢 Ready View Preview Nov 11, 2026, 3:29 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The changes are documentation-only, with one minor example-completeness issue and no identified blocking defects.

1 open issue
What changed in this PR

Adds Agent Gateway documentation for forwarding client headers to upstream agents, with links from the navigation and Agent Registry.

Changes:

  • Documents configuration modes, renaming, protected headers, and header precedence.
  • Adds an A2A request example and explains forwarding scope.
  • Makes the new page discoverable through existing Agent Gateway documentation.
File Description
product/​agent-gateway/​registry.mdx Adds a card linking to header forwarding documentation.
product/​agent-gateway/​forwarding-headers.mdx Documents forwarding configuration, restrictions, and usage.
docs.json Adds the page to Agent Gateway navigation.

Review effort: Balanced

Co-authored-by: narengogi <47327611+narengogi@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The gateway implementation branch returned 404, preventing confirmation of the documented protected-header filtering, rename validation, case-insensitive credential precedence, and agent-card exclusions.

No open issues 🎉

1 resolved since last review

Review effort: Balanced

@narengogi
narengogi merged commit 973432c into main Nov 11, 2026
2 checks passed

This branch was successfully deployed

1 active deployment
staging — 6d41e929 Deployed Nov 11, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants