Skip to content

Commit 85cd878

Browse files
added header hierachy docs
1 parent aa9f525 commit 85cd878

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

src/content/docs/ai-gateway/glossary.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,21 @@ pcx_content_type: glossary
55

66
import { Glossary } from "~/components";
77

8+
# Configuration Hierarchy in AI Gateway
9+
10+
Settings in AI Gateway can be configured at three levels: **Provider**, **Request**, and **Gateway**. Since the same settings can be configured in multiple locations, the following hierarchy determines which value is applied:
11+
12+
1. **Provider-level headers**:
13+
Relevant only when using the [Universal Endpoint](/ai-gateway/providers/universal/), these headers take precedence over all other configurations.
14+
15+
2. **Request-level headers**:
16+
Apply if no provider-level headers are set.
17+
18+
3. **Gateway-level settings**:
19+
Act as the default if no headers are set at the provider or request levels.
20+
21+
This hierarchy ensures consistent behavior, prioritizing the most specific configurations. Use provider-level and request-level headers for more fine-tuned control, and gateway settings for general defaults.
22+
823
AI Gateway supports a variety of headers to help you configure, customize, and manage your API requests. This page provides a complete list of all supported headers, along with a short description
924

1025
<Glossary product="ai-gateway" />

0 commit comments

Comments
 (0)