BerriAI/litellm · error · ValueError

documents is required for Cohere rerank

Error message

documents is required for Cohere rerank

What it means

Error "documents is required for Cohere rerank" thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/cohere/rerank_v2/transformation.py:80

                documents=documents,
                top_n=top_n,
                rank_fields=rank_fields,
                return_documents=return_documents,
                max_tokens_per_doc=max_tokens_per_doc,
            )
        )

    def transform_rerank_request(
        self,
        model: str,
        optional_rerank_params: dict,
        headers: dict,
        litellm_params: dict | None = None,
    ) -> dict:
        if "query" not in optional_rerank_params:
            raise ValueError("query is required for Cohere rerank")
        if "documents" not in optional_rerank_params:
            raise ValueError("documents is required for Cohere rerank")
        rerank_request: Final = RerankRequest(
            model=model,
            query=optional_rerank_params["query"],
            documents=optional_rerank_params["documents"],
            top_n=optional_rerank_params.get("top_n", None),
            rank_fields=optional_rerank_params.get("rank_fields", None),
            return_documents=optional_rerank_params.get("return_documents", None),
            max_tokens_per_doc=optional_rerank_params.get("max_tokens_per_doc", None),
        )
        return rerank_request.model_dump(exclude_none=True)

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Pass documents for the Cohere rerank request.

When it happens

Trigger: Thrown at litellm/llms/cohere/rerank_v2/transformation.py:80 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/677feecd03953d18. Report an issue: GitHub.