team management

Patch Team

Changed on

Partially update a team using RFC 7386 JSON Merge Patch semantics.

team_id is taken from the path; a team_id in the body is accepted only when it matches. metadata is merged with the team's stored metadata rather than replacing it: an omitted key is preserved, key: null deletes it, and any other value overwrites (recursing into nested objects). Every other field behaves exactly like POST /team/update (omitted preserves, a value overwrites). Returns the full updated team.

curl --location --request PATCH 'http://0.0.0.0:4000/team/8d916b1c-510d-4894-a334-1c16a93344f5'     --header "Authorization: Bearer $LITELLM_MASTER_KEY"     --header 'Content-Type: application/json'     --data-raw '{
    "metadata": {"cost_center": "1234", "deprecated_key": null}
}'
patch/team/{team_id}

Request

  • Base URL: https://api.sea-lion.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.sea-lion.ai/team/{team_id}
  • Auth: API key in header x-litellm-api-key

Path parameters

team_idstring required

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

Request body

team_idstring nullable
team_aliasstring nullable
organization_idstring nullable
metadataobject nullable
tpm_limitinteger nullable
rpm_limitinteger nullable
tpd_limitinteger nullable
max_budgetnumber nullable
soft_budgetnumber nullable
blockedboolean nullable
budget_durationstring nullable
model_aliasesobject nullable
guardrailsstring[] nullable
policiesstring[] nullable
disable_global_guardrailsboolean 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
denied_passthrough_routesstring[] nullable
secret_manager_settingsobject nullable
promptsstring[] nullable
model_rpm_limitobject nullable
model_tpm_limitobject nullable
default_estimated_output_tokensinteger nullable
default_estimated_output_tokens_per_modelobject nullable
mcp_rpm_limitobject nullable
enforced_batch_output_expires_afterobject nullable
enforced_file_expires_afterobject nullable
access_group_idsstring[] nullable
default_team_member_modelsstring[] nullable
model_max_budgetobject nullable

Max budget per model for every key on the team, overridable per key (e.g. {'gpt-4o': {'max_budget': 10, 'budget_duration': '1d'}})

Response

Successful Response

team_aliasstring nullable
team_idstring required
organization_idstring nullable
adminsstring[]
membersstring[]
team_member_permissionsstring[] nullable
metadataobject nullable
tpm_limitinteger nullable
rpm_limitinteger nullable
tpd_limitinteger nullable
max_budgetnumber nullable
soft_budgetnumber nullable
budget_durationstring nullable
modelsstring[]
blockedboolean
router_settingsobject nullable
access_group_idsstring[] nullable
default_team_member_modelsstring[] nullable
spendnumber nullable
max_parallel_requestsinteger nullable
budget_reset_atstring date-time nullable
model_idinteger nullable
model_spendobject nullable
model_max_budgetobject nullable
policiesstring[] nullable
allow_team_guardrail_configboolean nullable
object_permission_idstring nullable
updated_atstring date-time nullable
created_atstring date-time nullable

Changes