langflow-ai/langflow · error · HTTPException

One or more flow version ids are not checkpoints of flows in

Error message

One or more flow version ids are not checkpoints of flows in the selected project.

What it means

Error "One or more flow version ids are not checkpoints of flows in the selected project." thrown in langflow-ai/langflow.

Source

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

            and_(
                FlowVersion.user_id == user_id,
                FlowVersion.id == indexed_flow_version_ids_cte.c.flow_version_id,
            ),
        )
        .join(
            Flow,
            and_(
                Flow.id == FlowVersion.flow_id,
                Flow.user_id == user_id,
                Flow.folder_id == project_id,
            ),
        )
        .order_by(indexed_flow_version_ids_cte.c.position)
    )
    rows = list((await db.exec(statement)).all())
    if len(rows) < len(flow_version_ids):
        msg = "One or more flow version ids are not checkpoints of flows in the selected project."
        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=msg)

    artifacts: list[tuple[UUID, BaseFlowArtifact]] = []
    for row in rows:
        if row.flow_version_data is None:
            msg = f"Flow version {row.flow_version_id} has no data (snapshot may be corrupted)."
            raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail=msg)
        artifacts.append(
            (
                row.flow_version_id,
                BaseFlowArtifact(
                    id=row.flow_id,
                    name=row.flow_name,
                    description=row.flow_description,
                    data=row.flow_version_data,
                    tags=row.flow_tags,
                ),
            )
        )

View on GitHub (pinned to 976ec789d2)

Solutions

1. Select checkpoints of flows that are in the selected project, or move the flows into the project first.

When it happens

Trigger: Occurs when referenced flow version ids are not checkpoints of flows within the deployment's selected project.

Common situations: See trigger scenarios.

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