BerriAI/litellm · error · HTTPException

User does not have permission to call vector store file endp

Error message

User does not have permission to call vector store file endpoint {vector_store_id}. Ask your administrator to add the necessary permissions to your API key/Team.

What it means

Vector-store file-endpoint permission check: the request matched a read/write file pattern for a vector store, but the caller's key/team metadata lacks the corresponding vector-store file permission. Unlike the index check, unmatched routes return None (allowed); this fires only when an explicit permission is required and absent.

Source

Thrown at litellm/proxy/vector_store_endpoints/utils.py:481

    if permission_type is None:
        for endpoint in provider_vector_store_endpoints.get("read", ()):
            if request.method == endpoint[0] and _does_endpoint_match(endpoint[1], request_route):
                permission_type = "read"
                break

    if permission_type is None:
        return None

    has_permission: Final = check_vector_store_permission(
        index_name=vector_store_id,
        permission=permission_type,
        key_metadata=key_metadata,
        team_metadata=team_metadata,
    )

    if not has_permission:
        raise HTTPException(
            status_code=403,
            detail=f"User does not have permission to call vector store file endpoint {vector_store_id}. Ask your administrator to add the necessary permissions to your API key/Team.",
        )

    return has_permission

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Ask your administrator to add vector store file endpoint permissions to your API key or team.

When it happens

Trigger: Thrown at litellm/proxy/vector_store_endpoints/utils.py:481 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/a6373c9ef05d837f. Report an issue: GitHub.