langflow-ai/langflow · error · HTTPException

Invalid flow version id: {flow_version_ref}

Error message

Invalid flow version id: {flow_version_ref}

What it means

Error "Invalid flow version id: {flow_version_ref}" thrown in langflow-ai/langflow.

Source

Thrown at src/backend/base/langflow/api/v1/mappers/deployments/helpers.py:105

        FlowVersionDeploymentAttachment,
    )

    from .base import BaseDeploymentMapper


def parse_flow_version_reference_ids(reference_ids: Sequence[UUID | str]) -> list[UUID]:
    """Normalize UUID/string references into validated flow-version UUIDs."""
    flow_version_ids: list[UUID] = []
    for flow_version_ref in reference_ids:
        if isinstance(flow_version_ref, UUID):
            flow_version_ids.append(flow_version_ref)
            continue
        flow_version_ref_str = str(flow_version_ref).strip()
        try:
            flow_version_ids.append(UUID(flow_version_ref_str))
        except ValueError as exc:
            msg = f"Invalid flow version id: {flow_version_ref}"
            raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail=msg) from exc
    return flow_version_ids


def _build_indexed_flow_version_ids_cte(*, flow_version_ids: list[UUID]):
    indexed_selects = [
        select(literal(index).label("position"), literal(flow_version_id).label("flow_version_id"))
        for index, flow_version_id in enumerate(flow_version_ids)
    ]
    return (indexed_selects[0] if len(indexed_selects) == 1 else union_all(*indexed_selects)).cte(
        "indexed_flow_version_ids"
    )


async def build_flow_artifacts_from_flow_versions(
    *,
    db,
    user_id: UUID,
    deployment_db_id: UUID,

View on GitHub (pinned to 976ec789d2)

Solutions

1. Pass a valid UUID for the flow version id.

When it happens

Trigger: Occurs when a flow version reference in a deployment operation is not a valid UUID.

Common situations: See trigger scenarios.

AI-assisted analysis of langflow-ai/langflow@976ec789d2 (2026-08-14). Data as JSON: /api/errors/f3ac1b45ebc240e3. Report an issue: GitHub.