Fix: Populate spend_logs_metadata in batch and files endpoints

[Sameerlite]

Title

Fix: Populate spend_logs_metadata in batch and files endpoints

Relevant issues

Pre-Submission checklist

Please complete all items before asking a LiteLLM maintainer to review your PR

• I have Added testing in the tests/litellm/ directory, Adding at least 1 test is a hard requirement - see details

• I have added a screenshot of my new test passing locally

• My PR passes all unit tests on make test-unit

• My PR's scope is as isolated as possible, it only solves 1 specific problem

Type

🐛 Bug Fix

Changes

Problem

When users passed litellm_metadata with spend_logs_metadata via extra_body in OpenAI SDK calls, the metadata field appeared as null in logs instead of containing the expected values.

Root Cause

1. Files endpoint: The create_file endpoint wasn't reading litellm_metadata from multipart form data
2. Parsing logic: The add_litellm_data_to_request function wasn't parsing litellm_metadata when sent as a JSON string (common in form data)

Solution

1. Updated litellm/proxy/openai_files_endpoints/files_endpoints.py

• Added litellm_metadata: Optional[str] = Form(default=None) parameter to create_file endpoint
• Extract metadata from form field before processing request

2. Updated litellm/proxy/litellm_pre_call_utils.py

• Added parsing logic to convert litellm_metadata from JSON string to dict
• Added merging logic to combine user metadata with system metadata
• User-provided values take precedence over team defaults

Usage

For POST requests (create_batch, create_file):

client.files.create(
    file=open("data.jsonl", "rb"),
    purpose="batch",
    extra_body={
        "litellm_metadata": {
            "spend_logs_metadata": {
                "owner": "team-name",
                "product": "my-product"
            }
        }
    }
)

For GET requests (retrieve_batch, file_content):

client.batches.retrieve(
    batch_id,
    extra_headers={
        "x-litellm-spend-logs-metadata": json.dumps({
            "owner": "team-name",
            "product": "my-product"
        })
    }
)

Testing

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
litellm	Error			Nov 21, 2025 11:45am