litellm_users Data Source

Retrieves a page of LiteLLM users, with optional server-side filters

Example Usage

data "litellm_users" "internal" {
  role      = "internal_user"
  page      = 1
  page_size = 100
}

output "internal_user_ids" {
  value = data.litellm_users.internal.ids
}

Argument Reference

• role (Optional) - Filter users by role
• user_ids (Optional) - Comma-separated list of user IDs to filter by
• user_email (Optional) - Filter users by partial email match
• team (Optional) - Filter users by team ID
• page (Optional, Default 1) - Page number to fetch
• page_size (Optional, Default 25) - Number of users per page, max 100
• sort_by (Optional) - Column to sort by, e.g. user_id, user_email, created_at
• sort_order (Optional) - Sort order, asc or desc

Attribute Reference

• users - Users returned for the requested page. Each entry has:
  • user_id - The user ID
  • user_email - Email address of the user
  • user_alias - Descriptive name for the user
  • user_role - Role of the user on the proxy
  • teams - List of team IDs the user belongs to
  • models - Models the user is allowed to call
  • max_budget - Maximum budget in USD
  • spend - Current spend in USD
  • tpm_limit - Tokens per minute limit
  • rpm_limit - Requests per minute limit
  • key_count - Number of API keys owned by the user
  • created_at - Timestamp when the user was created
• ids - IDs of the users returned for the requested page
• total - Total number of users matching the filters
• total_pages - Total number of pages available