# add-team

Creates a team on a LiteLLM proxy with a budget and allowed models, then shows the new team ID.

Skill by LiteLLM. Category: Security.

## Install

Project (for this project only):

```sh
npx skills add berriai/litellm-skills --skill add-team
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add berriai/litellm-skills --skill add-team -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Runs shell commands: Its steps run shell commands in your terminal.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 115. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/berriai/litellm-skills/add-team)

## Source

[Open the source](https://github.com/berriai/litellm-skills/tree/HEAD/add-team). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: add-team
description: "Create a new team on a live LiteLLM proxy. Asks for team name, budget, and allowed models, then calls POST /team/new and shows the result. Use when the user wants to create a new team, set up team budgets, or configure model access for a team on the proxy."
license: MIT
compatibility: Requires curl.
metadata:
  author: BerriAI
  version: "1.0"
allowed-tools: Bash(curl:*)
---

# Add Team

Create a new team on a live LiteLLM proxy.

## Setup

Ask for these if not already known:
```
LITELLM_BASE_URL  — e.g. https://my-proxy.example.com
LITELLM_API_KEY   — proxy admin key
```

API reference: https://litellm.vercel.app/docs/proxy/team_based_routing

## Ask the user

1. **Team name** (required, becomes `team_alias`)
2. **Max budget** (optional, e.g. `100.00`)
3. **Allowed models** (optional, e.g. `gpt-4o, gpt-4o-mini`) — leave empty to allow all
4. **TPM / RPM limits** (optional)

## Run

```bash
BASE="$LITELLM_BASE_URL"
KEY="$LITELLM_API_KEY"

curl -s -X POST "$BASE/team/new" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "team_alias": "<name>",
    "max_budget": <budget_or_null>,
    "models": [<models_or_empty>],
    "tpm_limit": <tpm_or_null>,
    "rpm_limit": <rpm_or_null>
  }'
```

## Verify

Confirm the team was created:
```bash
curl -s "$BASE/team/info?team_id=<team_id>" \
  -H "Authorization: Bearer $KEY"
```

## Output

Show the user:
- `team_id` — they'll need this to generate keys for the team
- `team_alias`, `max_budget`, `models`

On error:
- **401** — check that `LITELLM_API_KEY` is a valid admin key
- **400** — check required fields (team_alias is required)
- Other errors — show `detail` and the likely fix
````

- Previous: [delete-mcp](https://syn4pse.dev/terminal/litellm-delete-mcp.md)
- Next: [delete-agent](https://syn4pse.dev/terminal/litellm-delete-agent.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
