BerriAI/litellm · error · HTTPException

Pass-through endpoint {endpoint} not found. This could have

Error message

Pass-through endpoint {endpoint} not found. This could have been deleted or not yet added to the proxy.

What it means

404 guard on the catch-all pass-through route: the requested path is not in the registered pass-through routes, meaning the endpoint was never added in config or has been deleted, so the proxy refuses to forward it.

Source

Thrown at litellm/proxy/pass_through_endpoints/pass_through_endpoints.py:1723

            from litellm.proxy.auth.auth_utils import (  # noqa: PLC0415
                get_request_route,
            )
            from litellm.proxy.pass_through_endpoints.pass_through_endpoints import (
                InitPassThroughEndpointHelpers,
            )

            path: Final = get_request_route(request)

            # Parse request data based on content type
            (
                query_params_data,
                custom_body_data,
                file_data,
                stream,
            ) = await _parse_request_data_by_content_type(request)

            if not InitPassThroughEndpointHelpers.is_registered_pass_through_route(route=path):
                raise HTTPException(
                    status_code=404,
                    detail=f"Pass-through endpoint {endpoint} not found. This could have been deleted or not yet added to the proxy.",
                )

            passthrough_params: Final = InitPassThroughEndpointHelpers.get_registered_pass_through_route(
                route=path, method=request.method
            )
            if (
                passthrough_params is None
                and InitPassThroughEndpointHelpers.get_registered_pass_through_route(route=path) is not None
            ):
                raise HTTPException(
                    status_code=status.HTTP_405_METHOD_NOT_ALLOWED,
                    detail=f"Method {request.method} is not allowed for pass-through endpoint {path}.",
                )
            target_params: Final = {
                "target": target,
                "custom_headers": custom_headers,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Register the pass-through endpoint in config.yaml or via the /config/pass_through_endpoint API.
2. List existing pass-through endpoints to verify the path; the endpoint may have been deleted.

When it happens

Trigger: Thrown at litellm/proxy/pass_through_endpoints/pass_through_endpoints.py:1723 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/acb30c63dcfc247a. Report an issue: GitHub.