latestOpenAPI 3.1.02026-08-226994571.1 MB

1e929292ddd5

team management

Update Team

Use /team/member_add AND /team/member/delete to add/remove new team members

You can now update team budget / rate limits via /team/update

Parameters:

  • team_id: str - The team id of the user. Required param.
  • team_alias: Optional[str] - User defined team alias
  • team_member_permissions: Optional[List[str]] - A list of routes that non-admin team members can access. example: ["/key/generate", "/key/update", "/key/delete"]
  • metadata: Optional[dict] - Metadata for team, store information for team. Example metadata = {"team": "core-infra", "app": "app2", "email": "ishaan@berri.ai" }
  • 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
  • soft_budget: Optional[float] - The soft budget threshold for the team. If max_budget is set (either in the request or existing), soft_budget must be strictly lower than max_budget. Can be set independently if max_budget is not set.
  • 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.
  • prompts: Optional[List[str]] - List of prompts that the team is allowed to use.
  • blocked: bool - Flag indicating if the team is blocked or not - will stop all calls from keys with this team_id.
  • 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
  • policies: Optional[List[str]] - Policies for the team. Docs
  • disable_global_guardrails: Optional[bool] - Whether to disable global guardrails for the key.
  • object_permission: Optional[LiteLLM_ObjectPermissionBase] - team-specific object permission. Example - {"vector_stores": ["vector_store_1", "vector_store_2"], "agents": ["agent_1", "agent_2"], "agent_access_groups": ["dev_group"]}. IF null or {} then no object permission.
  • team_member_budget: Optional[float] - The maximum budget allocated to an individual team member.
  • team_member_budget_duration: Optional[str] - The duration of the budget for the team member. Doc here
  • team_member_rpm_limit: Optional[int] - The RPM (Requests Per Minute) limit for individual team members.
  • team_member_tpm_limit: Optional[int] - The TPM (Tokens Per Minute) limit for individual team members.
  • team_member_key_duration: Optional[str] - The duration for a team member's key. e.g. "1d", "1w", "1mo"
  • allowed_passthrough_routes: Optional[List[str]] - List of allowed pass through routes for the team.
  • model_rpm_limit: Optional[Dict[str, int]] - The RPM (Requests Per Minute) limit per model for this team. Example: {"gpt-4": 100, "gpt-3.5-turbo": 200}
  • model_tpm_limit: Optional[Dict[str, int]] - The TPM (Tokens Per Minute) limit per model for this team. Example: {"gpt-4": 10000, "gpt-3.5-turbo": 20000} Example - update team TPM Limit
  • allowed_vector_store_indexes: Optional[List[dict]] - List of allowed vector store indexes for the key. Example - [{"index_name": "my-index", "index_permissions": ["write", "read"]}]. If specified, the key will only be able to use these specific vector store indexes. Create index, using /v1/indexes endpoint.
  • secret_manager_settings: Optional[dict] - Secret manager settings for the team. Docs
  • router_settings: Optional[UpdateRouterConfig] - team-specific router settings. Example - {"model_group_retry_policy": {"max_retries": 5}}. IF null or {} then no router settings.
  • access_group_ids: Optional[List[str]] - List of access group IDs to associate with the team. Access groups define which models the team can access. Example - ["access_group_1", "access_group_2"].
  • enforced_file_expires_after: Optional[dict] - Enforced file expiration policy for the team. Keys created under this team will inherit this policy for file uploads. Example - {"anchor": "created_at", "days": 30}.
  • enforced_batch_output_expires_after: Optional[dict] - Enforced batch output file expiration policy for the team. Keys created under this team will inherit this policy for batch output files. Example - {"anchor": "created_at", "days": 30}.
curl --location 'http://0.0.0.0:4000/team/update'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data-raw '{
    "team_id": "8d916b1c-510d-4894-a334-1c16a93344f5",
    "tpm_limit": 100
}'

Example - Update Team max_budget budget

curl --location 'http://0.0.0.0:4000/team/update'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data-raw '{
    "team_id": "8d916b1c-510d-4894-a334-1c16a93344f5",
    "max_budget": 10
}'
post/team/update

Headers

litellm-changed-bystring nullable

The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability

The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability

Request body

team_idstring required
team_aliasstring nullable
organization_idstring nullable
metadataobject nullable
tpm_limitinteger nullable
rpm_limitinteger nullable
max_budgetnumber nullable
soft_budgetnumber nullable
blockedboolean nullable
budget_durationstring nullable
model_aliasesobject nullable
guardrailsstring[] nullable
policiesstring[] nullable
team_member_budgetnumber nullable
team_member_budget_durationstring nullable
team_member_rpm_limitinteger nullable
team_member_tpm_limitinteger nullable
team_member_key_durationstring nullable
secret_manager_settingsobject nullable
promptsstring[] nullable
model_rpm_limitobject nullable
model_tpm_limitobject nullable
enforced_batch_output_expires_afterobject nullable
enforced_file_expires_afterobject nullable
router_settingsobject nullable
access_group_idsstring[] nullable

Response

Successful Response

{"stackTrail":"paths:/team/update:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}