> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vatel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Region pinning

> Pin API requests to a specific Vatel region with the x-vatel-region header

Requests to `https://api.vatel.ai` are routed to a region based on **geographic proximity** by default. Send the `x-vatel-region` header when you want a specific region to handle the request.

<ParamField header="x-vatel-region" type="string">
  Region that should handle this request. Omit the header to keep geo-proximity routing.
</ParamField>

## Supported regions

| Region               | Value                     |
| -------------------- | ------------------------- |
| **US Central**       | `us-central1`             |
| **Canada Northeast** | `northamerica-northeast1` |

These are the regions Vatel currently supports.

## Example

<CodeGroup>
  ```bash us-central1 theme={null}
  curl -X POST https://api.vatel.ai/v1/session-token \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -H 'x-vatel-region: us-central1' \
    -d '{"agent_id": "YOUR_AGENT_ID"}'
  ```

  ```bash northamerica-northeast1 theme={null}
  curl -X POST https://api.vatel.ai/v1/session-token \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -H 'x-vatel-region: northamerica-northeast1' \
    -d '{"agent_id": "YOUR_AGENT_ID"}'
  ```
</CodeGroup>