BerriAI/litellm · error · ValueError

prompt_id is required for dotprompt manager

Error message

prompt_id is required for dotprompt manager

What it means

Error "prompt_id is required for dotprompt manager" thrown in BerriAI/litellm.

Source

Thrown at litellm/integrations/dotprompt/dotprompt_manager.py:124

        prompt_id: str | None,
        prompt_spec: PromptSpec | None,
        prompt_variables: dict | None,
        dynamic_callback_params: StandardCallbackDynamicParams,
        prompt_label: str | None = None,
        prompt_version: int | None = None,
    ) -> PromptManagementClient:
        """
        Compile a .prompt file into a PromptManagementClient structure.

        This method:
        1. Loads the prompt template from the .prompt file (with optional version)
        2. Renders it with the provided variables
        3. Converts the rendered text into chat messages
        4. Extracts model and optional parameters from metadata
        """

        if prompt_id is None:
            raise ValueError("prompt_id is required for dotprompt manager")

        try:
            # Get the prompt template (versioned or base)
            template: Final = self.prompt_manager.get_prompt(prompt_id=prompt_id, version=prompt_version)
            if template is None:
                version_str: Final = f" (version {prompt_version})" if prompt_version else ""
                raise ValueError(f"Prompt '{prompt_id}'{version_str} not found in prompt directory")

            # Render the template with variables (pass version for proper lookup)
            rendered_content: Final = self.prompt_manager.render(
                prompt_id=prompt_id,
                prompt_variables=prompt_variables,
                version=prompt_version,
            )

            # Convert rendered content to chat messages
            messages: Final = self._convert_to_messages(rendered_content)

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Pass prompt_id when calling the dotprompt manager.

When it happens

Trigger: Thrown at litellm/integrations/dotprompt/dotprompt_manager.py:124 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/fc8b2d317a627fec. Report an issue: GitHub.