BerriAI/litellm · error · HTTPException

Only proxy admins can view prompt versions

Error message

Only proxy admins can view prompt versions

What it means

Authorization gate on the prompt version-history endpoint: user_api_key_dict does not carry a proxy-admin role, so the caller is refused before any database or registry access. Version history is restricted to proxy administrators only.

Source

Thrown at litellm/proxy/prompts/prompt_endpoints.py:485

                "updated_at": "2023-11-09T12:34:56.789Z"
            },
            {
                "prompt_id": "jack_success.v2",
                "litellm_params": {...},
                "prompt_info": {"prompt_type": "db"},
                "created_at": "2023-11-09T13:45:12.345Z",
                "updated_at": "2023-11-09T13:45:12.345Z"
            }
        ]
    }
    ```
    """
    from litellm.proxy.prompts.prompt_registry import IN_MEMORY_PROMPT_REGISTRY
    from litellm.proxy.proxy_server import prisma_client

    # Only allow proxy admins to view version history
    if not user_api_key_has_admin_view(user_api_key_dict):
        raise HTTPException(status_code=403, detail="Only proxy admins can view prompt versions")

    base_prompt_id: Final = get_base_prompt_id(prompt_id=prompt_id)

    # Query DB for versions
    versioned_prompts: Final = []
    if prisma_client is not None:
        where_clause: Final[dict[str, str]] = {"prompt_id": base_prompt_id}
        if environment:
            where_clause["environment"] = environment
        db_prompts: Final = await _prompt_table(prisma_client).find_many(
            where=where_clause,
            order={"version": "desc"},
        )
        for db_prompt in db_prompts:
            spec = create_versioned_prompt_spec(db_prompt=db_prompt)
            versioned_prompts.append(
                PromptSpec(
                    prompt_id=base_prompt_id,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Use a proxy admin key to view prompt versions, or ask an admin for the version history.

When it happens

Trigger: Thrown at litellm/proxy/prompts/prompt_endpoints.py:485 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/ab5f37984fdc2a6f. Report an issue: GitHub.