BerriAI/litellm · error · HTTPException

Failed to patch prompt

Error message

Failed to patch prompt

What it means

Generic failure wrapper raised when re-registering an updated prompt in the in-memory registry (after removing the stale entry) — the re-initialization step failed. The verbose_proxy_logger exception log holds the underlying traceback; the endpoint converts this to a 500.

Source

Thrown at litellm/proxy/prompts/prompt_endpoints.py:1038

    except HTTPException as e:
        raise e
    except Exception as e:
        verbose_proxy_logger.exception("Error deleting prompt: %s", e)
        raise HTTPException(status_code=500, detail=str(e))


def _reload_prompt_in_registry(
    registry: "InMemoryPromptRegistry", versioned_id: str, updated_prompt_spec: PromptSpec
) -> PromptSpec:
    """Remove stale entry and re-initialize the prompt in the in-memory registry."""
    if versioned_id in registry.IN_MEMORY_PROMPTS:
        del registry.IN_MEMORY_PROMPTS[versioned_id]
    if versioned_id in registry.prompt_id_to_custom_prompt:
        del registry.prompt_id_to_custom_prompt[versioned_id]
    initialized: Final = registry.initialize_prompt(prompt=updated_prompt_spec, config_file_path=None)
    if initialized is None:
        raise HTTPException(status_code=500, detail="Failed to patch prompt")
    return initialized


@router.patch(
    "/prompts/{prompt_id}",
    tags=["Prompt Management"],
    dependencies=[Depends(user_api_key_auth)],
)
async def patch_prompt(
    prompt_id: str,
    request: PatchPromptRequest,
    environment: str | None = None,
    user_api_key_dict: UserAPIKeyAuth = Depends(user_api_key_auth),
):
    """
    Partially update an existing prompt

    👉 [Prompt docs](https://docs.litellm.ai/docs/proxy/prompt_management)

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Check logs for the patch failure; ensure the patch payload matches the prompt schema and retry.

When it happens

Trigger: Thrown at litellm/proxy/prompts/prompt_endpoints.py:1038 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/76592f8348dda6a3. Report an issue: GitHub.