chroma-core/chroma · error · AuthError

Authorization header '{self._token_transport_header.value}'

Error message

Authorization header '{self._token_transport_header.value}' not found

What it means

Error "Authorization header '{self._token_transport_header.value}' not found" thrown in chroma-core/chroma.

Source

Thrown at chromadb/auth/token_authn/__init__.py:197

                if (
                    token in self._token_user_mapping
                    and self._token_user_mapping[token] != user
                ):
                    raise ValueError(
                        f"Token {token} already in use: wanted to use it for "
                        f"user {user['id']} but it's already in use by "
                        f"user {self._token_user_mapping[token]}"
                    )
                self._token_user_mapping[token] = user

    @trace_method(
        "TokenAuthenticationServerProvider.authenticate", OpenTelemetryGranularity.ALL
    )
    @override
    def authenticate_or_raise(self, headers: Dict[str, str]) -> UserIdentity:
        try:
            if self._token_transport_header.value.lower() not in headers.keys():
                raise AuthError(
                    f"Authorization header '{self._token_transport_header.value}' not found"
                )
            token = headers[self._token_transport_header.value.lower()]
            if self._token_transport_header == TokenTransportHeader.AUTHORIZATION:
                if not token.startswith("Bearer "):
                    raise AuthError("Bearer not found in Authorization header")
                token = re.sub(r"^Bearer ", "", token)

            token = token.strip()
            _check_token(token)

            if token not in self._token_user_mapping:
                raise AuthError("Invalid credentials: Token not found}")

            user_identity = UserIdentity(
                user_id=self._token_user_mapping[token]["id"],
                tenant=self._token_user_mapping[token]["tenant"],
                databases=self._token_user_mapping[token]["databases"],

View on GitHub (pinned to aecdd12c8a)

When it happens

Trigger: Thrown at chromadb/auth/token_authn/__init__.py:197 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of chroma-core/chroma@aecdd12c8a (2026-08-16). Data as JSON: /api/errors/17b9e5d98a4f0020. Report an issue: GitHub.