add-user

name	add-user
description	Create a new user on a live LiteLLM proxy. Asks for email, role, and optional budget/model limits, then calls POST /user/new and shows the result.
license	MIT
compatibility	Requires curl.
metadata	{"author":"BerriAI","version":"1.0"}
allowed-tools	Bash(curl:*)

Add User

Create a new user 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/virtual_keys#creating-a-user

Ask the user

1. Email (required)
2. Role — one of: proxy_admin, proxy_admin_viewer, internal_user (default), internal_user_viewer
3. Max budget (optional, e.g. 10.00)
4. Allowed models (optional, e.g. gpt-4o, claude-3-5-sonnet)

Run

curl -s -X POST "$BASE/user/new" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_email": "<email>",
    "user_role": "<role>",
    "max_budget": <budget_or_null>,
    "models": [<models_or_empty>]
  }'

Output

Show the user:

• user_id — they'll need this for future updates
• key — the auto-generated API key for this user
• user_role, max_budget

On error show detail and the likely fix.