BerriAI/litellm · error · ValueError

Must provide either `key_ids` (non-empty) or `all_keys_in_te

Error message

Must provide either `key_ids` (non-empty) or `all_keys_in_team=True`.

What it means

Model validator on BulkUpdateTeamKeysRequest: neither a non-empty key_ids list nor all_keys_in_team=True was given, so there is no target set of keys to apply update_fields to.

Source

Thrown at litellm/types/proxy/management_endpoints/key_management_endpoints.py:107

            raise ValueError("update_fields must specify at least one field to update.")
        return self


class BulkUpdateTeamKeysRequest(BaseModel):
    """Apply one update payload to many keys inside a team; provide either `key_ids` or `all_keys_in_team=True`."""

    team_id: str
    key_ids: list[str] | None = None
    all_keys_in_team: bool = False
    update_fields: KeyUpdateFields

    @model_validator(mode="after")
    def validate_selection(self) -> "BulkUpdateTeamKeysRequest":
        has_key_ids: Final = self.key_ids is not None and len(self.key_ids) > 0
        if has_key_ids and self.all_keys_in_team:
            raise ValueError("Provide either `key_ids` or `all_keys_in_team=True`, not both.")
        if not has_key_ids and not self.all_keys_in_team:
            raise ValueError("Must provide either `key_ids` (non-empty) or `all_keys_in_team=True`.")
        return self

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Provide a non-empty key_ids list or set all_keys_in_team=True.

When it happens

Trigger: Thrown at litellm/types/proxy/management_endpoints/key_management_endpoints.py:107 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/d0109d654036e0c3. Report an issue: GitHub.