fix(spend_logs): persist user email in spend log metadata so it shows in UI request logs (#41150)

* fix(spend_logs): persist user email in spend log metadata so it shows in UI request logs Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * fix(spend_logs): update payload expectations for user email metadata Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * test(gcs_pubsub): add user_api_key_user_email to the spend log fixture Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * fix(spend_logs): drop untyped metadata key args from the debug log to keep the type gate flat Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * fix(spend_logs): pass metadata keys to the debug log as a lazy %-style argument Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * feat(spend_logs): store user email in spend logs only behind store_user_email_in_spend_logs Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * revert(spend_logs): store user email in spend logs by default, drop store_user_email_in_spend_logs Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> * fix(spend_logs): store an empty user email as null, narrow the expected payload test diff Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --------- Co-authored-by: jesus <jesus@berri.ai> Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-10-23 05:34:41 +00:00 · 2026-10-17 13:26:09 -07:00 · 2026-10-17 13:26:09 -07:00 · 4273996985
commit 4273996985
parent 90fccd4d87
8 changed files with 95 additions and 12 deletions
--- a/litellm/proxy/_types.py
+++ b/litellm/proxy/_types.py
@ -3667,6 +3667,7 @@ class SpendLogsMetadata(TypedDict):
    user_api_key_project_alias: str | None
    user_api_key_org_id: str | None
    user_api_key_user_id: str | None
+    user_api_key_user_email: ReadOnly[str | None]
    user_api_key_team_alias: str | None
    spend_logs_metadata: dict | None  # special param to log k,v pairs to spendlogs for a call
    requester_ip_address: str | None
--- a/litellm/proxy/spend_tracking/spend_tracking_utils.py
+++ b/litellm/proxy/spend_tracking/spend_tracking_utils.py
@ -179,10 +179,16 @@ _STAMPED_METADATA_KEYS: Final = frozenset(
        "autorouter_baseline_observation",
        "used_client_oauth_token",
        "litellm_roi_estimator",
+        "user_api_key_user_email",
    )
 )


+def _stored_user_email(metadata: Mapping[str, object]) -> str | None:
+    email: Final = metadata.get("user_api_key_user_email")
+    return email if isinstance(email, str) and email.strip() else None
+
+
 def _get_spend_logs_metadata(
    metadata: dict | None,
    applied_guardrails: list[str] | None = None,
@ -214,6 +220,7 @@ def _get_spend_logs_metadata(
            user_api_key_project_alias=None,
            user_api_key_org_id=None,
            user_api_key_user_id=None,
+            user_api_key_user_email=None,
            user_api_key_team_alias=None,
            spend_logs_metadata=None,
            requester_ip_address=None,
@ -251,9 +258,7 @@ def _get_spend_logs_metadata(
            azure_spillover=azure_spillover,
            used_client_oauth_token=used_client_oauth_token,
        )
-    verbose_proxy_logger.debug(
-        "getting payload for SpendLogs, available keys in metadata: " + str(list(metadata.keys()))
-    )
+    verbose_proxy_logger.debug("getting payload for SpendLogs, available keys in metadata: %s", [*metadata])

    # Filter the metadata dictionary to include only the specified keys
    clean_metadata: Final = SpendLogsMetadata(
@ -267,6 +272,7 @@ def _get_spend_logs_metadata(
        azure_spillover=azure_spillover,
        used_client_oauth_token=used_client_oauth_token,
        litellm_roi_estimator=metadata.get("litellm_roi_estimator") is True,
+        user_api_key_user_email=_stored_user_email(metadata),
    )
    _raw_key: Final = clean_metadata.get("user_api_key")
    _trusted_hash: Final = metadata.get("user_api_key_hash")
--- a/tests/unit/integrations/gcs_pubsub/spend_logs_payload.json
+++ b/tests/unit/integrations/gcs_pubsub/spend_logs_payload.json
@ -11,7 +11,7 @@
    "user": "",
    "team_id": "",
    "organization_id": "",
-    "metadata": "{\"actor_agent_id\": null, \"target_agent_id\": null, \"billing_agent_id\": null, \"agent_execution_mode\": null, \"verified_human_user_id\": null, \"used_client_oauth_token\": null, \"applied_guardrails\": [], \"attempted_fallbacks\": null, \"original_model_group\": null, \"batch_models\": null, \"batch_successful_requests\": null, \"batch_failed_requests\": null, \"mcp_tool_call_metadata\": null, \"vector_store_request_metadata\": null, \"routing_decision\": null, \"internal_call_origin\": null, \"litellm_roi_estimator\": false, \"router_metadata\": null, \"autorouter_savings_estimate\": null, \"autorouter_baseline_observation\": null, \"azure_spillover\": null, \"guardrail_information\": null, \"compression_savings\": null, \"litellm_gateway_injected_cache\": null, \"usage_object\": {\"completion_tokens\": 20, \"prompt_tokens\": 10, \"total_tokens\": 30, \"completion_tokens_details\": null, \"prompt_tokens_details\": null}, \"model_map_information\": {\"model_map_key\": \"gpt-4o\", \"model_map_value\": {\"key\": \"gpt-4o\", \"max_tokens\": 16384, \"max_input_tokens\": 128000, \"max_output_tokens\": 16384, \"input_cost_per_token\": 2.5e-06, \"cache_creation_input_token_cost\": null, \"cache_read_input_token_cost\": 1.25e-06, \"input_cost_per_character\": null, \"input_cost_per_token_above_128k_tokens\": null, \"input_cost_per_token_above_200k_tokens\": null, \"input_cost_per_query\": null, \"input_cost_per_second\": null, \"input_cost_per_audio_token\": null, \"input_cost_per_token_batches\": 1.25e-06, \"output_cost_per_token_batches\": 5e-06, \"output_cost_per_token\": 1e-05, \"output_cost_per_audio_token\": null, \"output_cost_per_character\": null, \"output_cost_per_token_above_128k_tokens\": null, \"output_cost_per_character_above_128k_tokens\": null, \"output_cost_per_token_above_200k_tokens\": null, \"output_cost_per_second\": null, \"output_cost_per_image\": null, \"output_vector_size\": null, \"litellm_provider\": \"openai\", \"mode\": \"chat\", \"supports_system_messages\": true, \"supports_response_schema\": true, \"supports_vision\": true, \"supports_function_calling\": true, \"supports_tool_choice\": true, \"supports_assistant_prefill\": false, \"supports_prompt_caching\": true, \"supports_audio_input\": false, \"supports_audio_output\": false, \"supports_pdf_input\": false, \"supports_embedding_image_input\": false, \"supports_native_streaming\": null, \"supports_web_search\": true, \"supports_reasoning\": false, \"search_context_cost_per_query\": {\"search_context_size_low\": 0.03, \"search_context_size_medium\": 0.035, \"search_context_size_high\": 0.05}, \"tpm\": null, \"rpm\": null, \"supported_openai_params\": [\"frequency_penalty\", \"logit_bias\", \"logprobs\", \"top_logprobs\", \"max_tokens\", \"max_completion_tokens\", \"modalities\", \"prediction\", \"n\", \"presence_penalty\", \"seed\", \"stop\", \"stream\", \"stream_options\", \"temperature\", \"top_p\", \"tools\", \"tool_choice\", \"function_call\", \"functions\", \"max_retries\", \"extra_headers\", \"parallel_tool_calls\", \"audio\", \"response_format\", \"user\"]}}, \"additional_usage_values\": {\"completion_tokens_details\": null, \"prompt_tokens_details\": null}, \"user_api_key\": null, \"user_api_key_alias\": null, \"user_api_key_team_id\": null, \"user_api_key_project_id\": null, \"user_api_key_project_alias\": null, \"user_api_key_org_id\": null, \"user_api_key_user_id\": null, \"user_api_key_team_alias\": null, \"spend_logs_metadata\": null, \"requester_ip_address\": null, \"user_agent\": null, \"status\": null, \"proxy_server_request\": null, \"error_information\": null, \"attempted_retries\": null, \"max_retries\": null}",
+    "metadata": "{\"actor_agent_id\": null, \"target_agent_id\": null, \"billing_agent_id\": null, \"agent_execution_mode\": null, \"verified_human_user_id\": null, \"used_client_oauth_token\": null, \"applied_guardrails\": [], \"attempted_fallbacks\": null, \"original_model_group\": null, \"batch_models\": null, \"batch_successful_requests\": null, \"batch_failed_requests\": null, \"mcp_tool_call_metadata\": null, \"vector_store_request_metadata\": null, \"routing_decision\": null, \"internal_call_origin\": null, \"litellm_roi_estimator\": false, \"router_metadata\": null, \"autorouter_savings_estimate\": null, \"autorouter_baseline_observation\": null, \"azure_spillover\": null, \"guardrail_information\": null, \"compression_savings\": null, \"litellm_gateway_injected_cache\": null, \"usage_object\": {\"completion_tokens\": 20, \"prompt_tokens\": 10, \"total_tokens\": 30, \"completion_tokens_details\": null, \"prompt_tokens_details\": null}, \"model_map_information\": {\"model_map_key\": \"gpt-4o\", \"model_map_value\": {\"key\": \"gpt-4o\", \"max_tokens\": 16384, \"max_input_tokens\": 128000, \"max_output_tokens\": 16384, \"input_cost_per_token\": 2.5e-06, \"cache_creation_input_token_cost\": null, \"cache_read_input_token_cost\": 1.25e-06, \"input_cost_per_character\": null, \"input_cost_per_token_above_128k_tokens\": null, \"input_cost_per_token_above_200k_tokens\": null, \"input_cost_per_query\": null, \"input_cost_per_second\": null, \"input_cost_per_audio_token\": null, \"input_cost_per_token_batches\": 1.25e-06, \"output_cost_per_token_batches\": 5e-06, \"output_cost_per_token\": 1e-05, \"output_cost_per_audio_token\": null, \"output_cost_per_character\": null, \"output_cost_per_token_above_128k_tokens\": null, \"output_cost_per_character_above_128k_tokens\": null, \"output_cost_per_token_above_200k_tokens\": null, \"output_cost_per_second\": null, \"output_cost_per_image\": null, \"output_vector_size\": null, \"litellm_provider\": \"openai\", \"mode\": \"chat\", \"supports_system_messages\": true, \"supports_response_schema\": true, \"supports_vision\": true, \"supports_function_calling\": true, \"supports_tool_choice\": true, \"supports_assistant_prefill\": false, \"supports_prompt_caching\": true, \"supports_audio_input\": false, \"supports_audio_output\": false, \"supports_pdf_input\": false, \"supports_embedding_image_input\": false, \"supports_native_streaming\": null, \"supports_web_search\": true, \"supports_reasoning\": false, \"search_context_cost_per_query\": {\"search_context_size_low\": 0.03, \"search_context_size_medium\": 0.035, \"search_context_size_high\": 0.05}, \"tpm\": null, \"rpm\": null, \"supported_openai_params\": [\"frequency_penalty\", \"logit_bias\", \"logprobs\", \"top_logprobs\", \"max_tokens\", \"max_completion_tokens\", \"modalities\", \"prediction\", \"n\", \"presence_penalty\", \"seed\", \"stop\", \"stream\", \"stream_options\", \"temperature\", \"top_p\", \"tools\", \"tool_choice\", \"function_call\", \"functions\", \"max_retries\", \"extra_headers\", \"parallel_tool_calls\", \"audio\", \"response_format\", \"user\"]}}, \"additional_usage_values\": {\"completion_tokens_details\": null, \"prompt_tokens_details\": null}, \"user_api_key\": null, \"user_api_key_alias\": null, \"user_api_key_team_id\": null, \"user_api_key_project_id\": null, \"user_api_key_project_alias\": null, \"user_api_key_org_id\": null, \"user_api_key_user_id\": null, \"user_api_key_user_email\": null, \"user_api_key_team_alias\": null, \"spend_logs_metadata\": null, \"requester_ip_address\": null, \"user_agent\": null, \"status\": null, \"proxy_server_request\": null, \"error_information\": null, \"attempted_retries\": null, \"max_retries\": null}",
    "cache_key": "Cache OFF",
    "spend": 0.00022500000000000002,
    "total_tokens": 30,
--- a/tests/unit/proxy/spend_tracking/test_spend_management_endpoints.py
+++ b/tests/unit/proxy/spend_tracking/test_spend_management_endpoints.py
@ -3725,7 +3725,7 @@ class TestSpendLogsPayload:
                    "model": "gpt-4o",
                    "user": "",
                    "team_id": "",
-                    "metadata": '{"actor_agent_id": null, "target_agent_id": null, "billing_agent_id": null, "agent_execution_mode": null, "verified_human_user_id": null, "applied_guardrails": [], "attempted_fallbacks": null, "original_model_group": null, "batch_models": null, "batch_successful_requests": null, "batch_failed_requests": null, "mcp_tool_call_metadata": null, "vector_store_request_metadata": null, "routing_decision": null, "internal_call_origin": null, "guardrail_information": null, "compression_savings": null, "litellm_gateway_injected_cache": null, "router_metadata": null, "autorouter_savings_estimate": null, "autorouter_baseline_observation": null, "azure_spillover": null, "used_client_oauth_token": null, "litellm_roi_estimator": false, "usage_object": {"completion_tokens": 20, "prompt_tokens": 10, "total_tokens": 30, "completion_tokens_details": null, "prompt_tokens_details": null}, "model_map_information": {"model_map_key": "gpt-4o", "model_map_value": {"key": "gpt-4o", "max_tokens": 16384, "max_input_tokens": 128000, "max_output_tokens": 16384, "input_cost_per_token": 2.5e-06, "cache_creation_input_token_cost": null, "cache_read_input_token_cost": 1.25e-06, "input_cost_per_character": null, "input_cost_per_token_above_128k_tokens": null, "input_cost_per_token_above_200k_tokens": null, "input_cost_per_query": null, "input_cost_per_second": null, "input_cost_per_audio_token": null, "input_cost_per_token_batches": 1.25e-06, "output_cost_per_token_batches": 5e-06, "output_cost_per_token": 1e-05, "output_cost_per_audio_token": null, "output_cost_per_character": null, "output_cost_per_token_above_128k_tokens": null, "output_cost_per_character_above_128k_tokens": null, "output_cost_per_token_above_200k_tokens": null, "output_cost_per_second": null, "output_cost_per_reasoning_token": null, "output_cost_per_image": null, "output_vector_size": null, "litellm_provider": "openai", "mode": "chat", "supports_system_messages": true, "supports_response_schema": true, "supports_vision": true, "supports_function_calling": true, "supports_tool_choice": true, "supports_assistant_prefill": false, "supports_prompt_caching": true, "supports_audio_input": false, "supports_audio_output": false, "supports_pdf_input": false, "supports_embedding_image_input": false, "supports_native_streaming": null, "supports_web_search": true, "supports_reasoning": false, "search_context_cost_per_query": {"search_context_size_low": 0.03, "search_context_size_medium": 0.035, "search_context_size_high": 0.05}, "tpm": null, "rpm": null, "supported_openai_params": ["frequency_penalty", "logit_bias", "logprobs", "top_logprobs", "max_tokens", "max_completion_tokens", "modalities", "prediction", "n", "presence_penalty", "seed", "stop", "stream", "stream_options", "temperature", "top_p", "tools", "tool_choice", "function_call", "functions", "max_retries", "extra_headers", "parallel_tool_calls", "audio", "response_format", "user"]}}, "additional_usage_values": {"completion_tokens_details": null, "prompt_tokens_details": null}}',
+                    "metadata": '{"user_api_key_user_email": null, "actor_agent_id": null, "target_agent_id": null, "billing_agent_id": null, "agent_execution_mode": null, "verified_human_user_id": null, "applied_guardrails": [], "attempted_fallbacks": null, "original_model_group": null, "batch_models": null, "batch_successful_requests": null, "batch_failed_requests": null, "mcp_tool_call_metadata": null, "vector_store_request_metadata": null, "routing_decision": null, "internal_call_origin": null, "guardrail_information": null, "compression_savings": null, "litellm_gateway_injected_cache": null, "router_metadata": null, "autorouter_savings_estimate": null, "autorouter_baseline_observation": null, "azure_spillover": null, "used_client_oauth_token": null, "litellm_roi_estimator": false, "usage_object": {"completion_tokens": 20, "prompt_tokens": 10, "total_tokens": 30, "completion_tokens_details": null, "prompt_tokens_details": null}, "model_map_information": {"model_map_key": "gpt-4o", "model_map_value": {"key": "gpt-4o", "max_tokens": 16384, "max_input_tokens": 128000, "max_output_tokens": 16384, "input_cost_per_token": 2.5e-06, "cache_creation_input_token_cost": null, "cache_read_input_token_cost": 1.25e-06, "input_cost_per_character": null, "input_cost_per_token_above_128k_tokens": null, "input_cost_per_token_above_200k_tokens": null, "input_cost_per_query": null, "input_cost_per_second": null, "input_cost_per_audio_token": null, "input_cost_per_token_batches": 1.25e-06, "output_cost_per_token_batches": 5e-06, "output_cost_per_token": 1e-05, "output_cost_per_audio_token": null, "output_cost_per_character": null, "output_cost_per_token_above_128k_tokens": null, "output_cost_per_character_above_128k_tokens": null, "output_cost_per_token_above_200k_tokens": null, "output_cost_per_second": null, "output_cost_per_reasoning_token": null, "output_cost_per_image": null, "output_vector_size": null, "litellm_provider": "openai", "mode": "chat", "supports_system_messages": true, "supports_response_schema": true, "supports_vision": true, "supports_function_calling": true, "supports_tool_choice": true, "supports_assistant_prefill": false, "supports_prompt_caching": true, "supports_audio_input": false, "supports_audio_output": false, "supports_pdf_input": false, "supports_embedding_image_input": false, "supports_native_streaming": null, "supports_web_search": true, "supports_reasoning": false, "search_context_cost_per_query": {"search_context_size_low": 0.03, "search_context_size_medium": 0.035, "search_context_size_high": 0.05}, "tpm": null, "rpm": null, "supported_openai_params": ["frequency_penalty", "logit_bias", "logprobs", "top_logprobs", "max_tokens", "max_completion_tokens", "modalities", "prediction", "n", "presence_penalty", "seed", "stop", "stream", "stream_options", "temperature", "top_p", "tools", "tool_choice", "function_call", "functions", "max_retries", "extra_headers", "parallel_tool_calls", "audio", "response_format", "user"]}}, "additional_usage_values": {"completion_tokens_details": null, "prompt_tokens_details": null}}',
                    "cache_key": "Cache OFF",
                    "spend": 0.00022500000000000002,
                    "total_tokens": 30,
--- a/tests/unit/proxy/spend_tracking/test_spend_tracking_utils.py
+++ b/tests/unit/proxy/spend_tracking/test_spend_tracking_utils.py
@ -526,6 +526,7 @@ def _make_standard_logging_payload_with_usage_object(usage_object: dict) -> Stan
            user_api_key_team_id=None,
            user_api_key_org_id=None,
            user_api_key_user_id=None,
+            user_api_key_user_email=None,
            user_api_key_team_alias=None,
            spend_logs_metadata=None,
            requester_ip_address=None,
@ -1957,6 +1958,7 @@ def test_get_logging_payload_includes_overhead_in_spend_logs_metadata():
            user_api_key_team_id=None,
            user_api_key_org_id=None,
            user_api_key_user_id=None,
+            user_api_key_user_email=None,
            user_api_key_team_alias=None,
            spend_logs_metadata=None,
            requester_ip_address=None,
@ -2090,6 +2092,7 @@ def test_get_logging_payload_handles_missing_overhead_gracefully():
            user_api_key_team_id=None,
            user_api_key_org_id=None,
            user_api_key_user_id=None,
+            user_api_key_user_email=None,
            user_api_key_team_alias=None,
            spend_logs_metadata=None,
            requester_ip_address=None,
@ -2677,6 +2680,7 @@ def test_get_logging_payload_includes_retry_info_in_spend_logs_metadata():
                user_api_key_team_id=None,
                user_api_key_org_id=None,
                user_api_key_user_id=None,
+                user_api_key_user_email=None,
                user_api_key_team_alias=None,
                spend_logs_metadata=None,
                requester_ip_address=None,
@ -2772,6 +2776,7 @@ def test_get_logging_payload_handles_missing_retry_info_gracefully():
                user_api_key_team_id=None,
                user_api_key_org_id=None,
                user_api_key_user_id=None,
+                user_api_key_user_email=None,
                user_api_key_team_alias=None,
                spend_logs_metadata=None,
                requester_ip_address=None,
@ -5243,6 +5248,37 @@ def test_get_spend_logs_metadata_sibling_fields_preserved():
    assert meta["user_api_key_team_id"] == "team-123"


+@pytest.mark.parametrize(
+    ("user_email", "stored_email"),
+    [
+        ("sso-user@example.com", "sso-user@example.com"),
+        ("", None),
+        ("   ", None),
+        (None, None),
+    ],
+)
+def test_get_logging_payload_stores_user_email_in_spend_log_metadata(user_email, stored_email):
+    payload = get_logging_payload(
+        kwargs={
+            "model": "gpt-4o-mini",
+            "litellm_params": {
+                "metadata": {
+                    "user_api_key_user_email": user_email,
+                    "user_api_key_user_id": "okta|abc123",
+                }
+            },
+        },
+        response_obj=litellm.ModelResponse(id="chatcmpl-user-email", choices=[], usage=litellm.Usage()),
+        start_time=datetime.datetime.now(timezone.utc),
+        end_time=datetime.datetime.now(timezone.utc),
+    )
+
+    metadata = json.loads(payload["metadata"])
+
+    assert metadata["user_api_key_user_email"] == stored_email
+    assert metadata["user_api_key_user_id"] == "okta|abc123"
+
+
 def test_redact_logged_api_key_partial_sha256_is_hashed():
    partial_hex = "a" * 63
    result = _redact_logged_api_key(partial_hex)
@ -5342,6 +5378,7 @@ def test_get_logging_payload_includes_fallback_info_in_spend_logs_metadata():
                user_api_key_team_id=None,
                user_api_key_org_id=None,
                user_api_key_user_id=None,
+                user_api_key_user_email=None,
                user_api_key_team_alias=None,
                spend_logs_metadata=None,
                requester_ip_address=None,
@ -5437,6 +5474,7 @@ def test_get_logging_payload_handles_missing_fallback_info_gracefully():
                user_api_key_team_id=None,
                user_api_key_org_id=None,
                user_api_key_user_id=None,
+                user_api_key_user_email=None,
                user_api_key_team_alias=None,
                spend_logs_metadata=None,
                requester_ip_address=None,
--- a/tests/unit/responses/litellm_completion_transformation/test_session_handler_with_cold_storage.py
+++ b/tests/unit/responses/litellm_completion_transformation/test_session_handler_with_cold_storage.py
@ -10,20 +10,18 @@ Tests for the changes to integrate cold storage handling across different compon
 """

 import json
-from datetime import datetime, timezone
-from typing import Optional
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import AsyncMock, patch

 import pytest

 from litellm.integrations.s3_v2 import S3Logger
-from litellm.proxy._types import SpendLogsMetadata, SpendLogsPayload
+from litellm.proxy._types import SpendLogsMetadata
 from litellm.proxy.spend_tracking.cold_storage_handler import ColdStorageHandler
 from litellm.proxy.spend_tracking.spend_tracking_utils import _get_spend_logs_metadata
 from litellm.responses.litellm_completion_transformation.session_handler import (
    ResponsesSessionHandler,
 )
-from litellm.types.utils import StandardLoggingMetadata, StandardLoggingPayload
+from litellm.types.utils import StandardLoggingMetadata


 class TestColdStorageObjectKeyIntegration:
@ -57,7 +55,9 @@ class TestColdStorageObjectKeyIntegration:
        """
        # Create a SpendLogsMetadata instance with cold_storage_object_key
        metadata = SpendLogsMetadata(
-            user_api_key="test_key", cold_storage_object_key="test/path/to/object.json"
+            user_api_key="test_key",
+            user_api_key_user_email=None,
+            cold_storage_object_key="test/path/to/object.json",
        )

        # Verify the field can be set and accessed
--- a/ui/litellm-dashboard/src/components/logs/request/RequestLogsTableColumns.test.tsx
+++ b/ui/litellm-dashboard/src/components/logs/request/RequestLogsTableColumns.test.tsx
@ -147,6 +147,41 @@ describe("Internal User column", () => {
    expect(await screen.findByText("alice@example.com (106514937785257944828)")).toBeInTheDocument();
  });

+  it("shows the email stored in the log metadata when the user list has no entry for that user", async () => {
+    const user = userEvent.setup();
+    renderRows(
+      [
+        logEntry({
+          request_id: "req-sso-user",
+          user: "okta|abc123",
+          metadata: { user_api_key_user_email: "sso-user@example.com" },
+        }),
+      ],
+      deps,
+    );
+
+    const emailCell = screen.getByText("sso-user@example.com");
+    expect(screen.queryByText("okta|abc123")).not.toBeInTheDocument();
+    await user.hover(emailCell);
+    expect(await screen.findByText("sso-user@example.com (okta|abc123)")).toBeInTheDocument();
+  });
+
+  it("prefers the user list email over the one stored in the log metadata", () => {
+    renderRows(
+      [
+        logEntry({
+          request_id: "req-renamed-user",
+          user: "106514937785257944828",
+          metadata: { user_api_key_user_email: "old@example.com" },
+        }),
+      ],
+      deps,
+    );
+
+    expect(screen.getByText("alice@example.com")).toBeInTheDocument();
+    expect(screen.queryByText("old@example.com")).not.toBeInTheDocument();
+  });
+
  it("falls back to the raw id when no email is known for the user", () => {
    renderRows([logEntry({ request_id: "req-unknown-user", user: "unknown-user-id" })], deps);

--- a/ui/litellm-dashboard/src/components/logs/request/RequestLogsTableColumns.tsx
+++ b/ui/litellm-dashboard/src/components/logs/request/RequestLogsTableColumns.tsx
@ -365,7 +365,10 @@ export const getRequestLogsTableColumns = ({
    cell: ({ row }) => (
      <UserCell
        userId={row.original.user}
-        email={row.original.user ? resolveUserEmail(row.original.user) : undefined}
+        email={
+          (row.original.user ? resolveUserEmail(row.original.user) : undefined) ??
+          readMetaString(row.original.metadata, "user_api_key_user_email")
+        }
      />
    ),
  },