New

New Team

Allow users to create a new team. Apply user permissions to their team.

👉 Detailed Doc on setting team budgets

Parameters:

• team_alias: Optional[str] - User defined team alias
• team_id: Optional[str] - The team id of the user. If none passed, we'll generate it.
• members_with_roles: List[{"role": "admin" or "user", "user_id": ""}] - A list of users and their roles in the team. Get user_id when making a new user via /user/new.
• metadata: Optional[dict] - Metadata for team, store information for team. Example metadata = {"extra_info": "some info"}
• tpm_limit: Optional[int] - The TPM (Tokens Per Minute) limit for this team - all keys with this team_id will have at max this TPM limit
• rpm_limit: Optional[int] - The RPM (Requests Per Minute) limit for this team - all keys associated with this team_id will have at max this RPM limit
• max_budget: Optional[float] - The maximum budget allocated to the team - all keys for this team_id will have at max this max_budget
• budget_duration: Optional[str] - The duration of the budget for the team. Doc here
• models: Optional[list] - A list of models associated with the team - all keys for this team_id will have at most, these models. If empty, assumes all models are allowed.
• blocked: bool - Flag indicating if the team is blocked or not - will stop all calls from keys with this team_id.
• members: Optional[List] - Control team members via /team/member/add and /team/member/delete.
• tags: Optional[List[str]] - Tags for tracking spend and/or doing tag-based routing.
• organization_id: Optional[str] - The organization id of the team. Default is None. Create via /organization/new.
• model_aliases: Optional[dict] - Model aliases for the team. Docs
• guardrails: Optional[List[str]] - Guardrails for the team. Docs Returns:
• team_id: (str) Unique team id - used for tracking spend across multiple keys for same team id.

_deprecated_params:

• admins: list - A list of user_id's for the admin role
• users: list - A list of user_id's for the user role

Example Request:

curl --location 'http://0.0.0.0:4000/team/new'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data '{
  "team_alias": "my-new-team_2",
  "members_with_roles": [{"role": "admin", "user_id": "user-1234"},
    {"role": "user", "user_id": "user-2434"}]
}'

curl --location 'http://0.0.0.0:4000/team/new'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data '{
           "team_alias": "QA Prod Bot", 
           "max_budget": 0.000000001, 
           "budget_duration": "1d"
       }'

POST/team/new

Authorization

APIKeyHeaderAPIKeyHeaderAPIKeyHeaderAPIKeyHeader

Header parameters

Body

application/json

team_aliasTeam Alias

stringnull

team_idTeam Id

stringnull

organization_idOrganization Id

stringnull

adminsAdmins

membersMembers

members_with_rolesMembers With Roles

metadataMetadata

objectnull

tpm_limitTpm Limit

integernull

rpm_limitRpm Limit

integernull

max_budgetMax Budget

numbernull

budget_durationBudget Duration

stringnull

modelsModels

blockedBlocked

model_aliasesModel Aliases

objectnull

tagsTags

array of anynull

guardrailsGuardrails

array of stringnull

Response

200422

Successful Response

Body

application/json

team_aliasTeam Alias

stringnull

team_id*Team Id

organization_idOrganization Id

stringnull

adminsAdmins

membersMembers

members_with_rolesMembers With Roles

metadataMetadata

objectnull

tpm_limitTpm Limit

integernull

rpm_limitRpm Limit

integernull

max_budgetMax Budget

numbernull

budget_durationBudget Duration

stringnull

modelsModels

blockedBlocked

spendSpend

numbernull

max_parallel_requestsMax Parallel Requests

integernull

budget_reset_atBudget Reset At

string (date-time)null

model_idModel Id

integernull

litellm_model_tableany of

LiteLLM_ModelTablenull

created_atCreated At

string (date-time)null

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/team/new', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200422

{
  "team_alias": "text",
  "team_id": "text",
  "organization_id": "text",
  "admins": [],
  "members": [],
  "members_with_roles": [
    {
      "user_id": "text",
      "user_email": "text",
      "role": "admin"
    }
  ],
  "tpm_limit": 0,
  "rpm_limit": 0,
  "max_budget": 0,
  "budget_duration": "text",
  "models": [],
  "blocked": false,
  "spend": 0,
  "max_parallel_requests": 0,
  "budget_reset_at": "2025-01-29T19:58:59.310Z",
  "model_id": 0,
  "litellm_model_table": {
    "created_by": "text",
    "updated_by": "text"
  },
  "created_at": "2025-01-29T19:58:59.310Z"
}