---
title: "[DEPRECATED] Team-based Routing"
url: "/docs/proxy/team_based_routing"
canonical_url: "https://docs.litellm.ai/docs/proxy/team_based_routing"
type: "docs"
last_updated: "2026-10-09"
summary: "This is deprecated, please use Tag Based Routing instead"
related:
  - "/docs/rules"
  - "/docs/proxy/customer_routing"
---
# [DEPRECATED] Team-based Routing

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


:::info

This is deprecated, please use [Tag Based Routing](./tag_routing.md) instead

:::

## Routing
Route calls to different model groups based on the team-id

### Config with model group 

Create a config.yaml with 2 model groups + connected postgres db

```yaml
model_list: 
  - model_name: gpt-4o-mini-eu # 👈 Model Group 1
    litellm_params:
      model: azure/chatgpt-v-2
      api_base: os.environ/AZURE_API_BASE_EU
      api_key: os.environ/AZURE_API_KEY_EU
      api_version: "2023-07-01-preview"
  - model_name: gpt-4o-mini-worldwide # 👈 Model Group 2
    litellm_params:
      model: azure/chatgpt-v-2
      api_base: os.environ/AZURE_API_BASE
      api_key: os.environ/AZURE_API_KEY
      api_version: "2023-07-01-preview"

general_settings: 
    master_key: os.environ/LITELLM_MASTER_KEY
    database_url: "postgresql://..." # 👈 Connect proxy to DB
```

Start proxy

```bash
litellm --config /path/to/config.yaml
```

### Create Team with Model Alias

```bash
# Authorization: 👈 Master Key
curl --location 'http://0.0.0.0:4000/team/new' \
--header "Authorization: Bearer $LITELLM_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "team_alias": "my-new-team_4",
  "model_aliases": {"gpt-5.6-luna": "gpt-4o-mini-eu"}
}'

# Returns team_id: my-team-id
```

### Create Team Key 

```bash 
curl --location 'http://localhost:4000/key/generate' \
--header "Authorization: Bearer $LITELLM_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "team_id": "my-team-id",  # 👈 YOUR TEAM ID
}'
```

### Call Model with alias 

```bash
curl --location 'http://0.0.0.0:4000/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-A1L0C3Px2LJl53sF_kTF9A' \
--data '{
  "model": "gpt-5.6-luna", # 👈 MODEL 
  "messages": [{"role": "system", "content": "You'\''re an expert at writing poems"}, {"role": "user", "content": "Write me a poem"}, {"role": "user", "content": "What'\''s your name?"}],
  "user": "usha"
}'
```

## Related pages

- [Rules](https://docs.litellm.ai/docs/rules.md)
- [[DEPRECATED] Region-based Routing](https://docs.litellm.ai/docs/proxy/customer_routing.md)