langflow-ai/langflow · error · HTTPException

Snapshot binding count mismatch on create: {} flow versions

Error message

Snapshot binding count mismatch on create: {} flow versions vs {} snapshot bindings

What it means

Error "Snapshot binding count mismatch on create: {} flow versions vs {} snapshot bindings" thrown in langflow-ai/langflow.

Source

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

) -> dict[UUID, str]:
    if not flow_version_ids:
        return {}
    bindings = deployment_mapper.util_create_snapshot_bindings(
        result=result,
    )
    bindings_by_source_ref = bindings.to_source_ref_map()
    if not bindings_by_source_ref:
        msg = "Deployment provider create result is missing required snapshot bindings."
        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)
    expected_source_ref_to_flow_version_id = {
        str(flow_version_id): flow_version_id for flow_version_id in flow_version_ids
    }
    if len(bindings_by_source_ref) != len(expected_source_ref_to_flow_version_id):
        msg = (
            f"Snapshot binding count mismatch on create: {len(expected_source_ref_to_flow_version_id)} "
            f"flow versions vs {len(bindings_by_source_ref)} snapshot bindings"
        )
        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)
    snapshot_id_by_flow_version_id: dict[UUID, str] = {}
    for source_ref, snapshot_id in bindings_by_source_ref.items():
        flow_version_id = expected_source_ref_to_flow_version_id.get(source_ref)
        if flow_version_id is None:
            msg = f"Unexpected source_ref in create snapshot bindings: {source_ref}"
            raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)
        snapshot_id_by_flow_version_id[flow_version_id] = snapshot_id
    return snapshot_id_by_flow_version_id


def resolve_flow_version_patch_for_update(
    *,
    deployment_mapper: BaseDeploymentMapper,
    payload: DeploymentUpdateRequest,
) -> tuple[list[UUID], list[UUID]]:
    patch = deployment_mapper.util_flow_version_patch(payload)
    return patch.add_flow_version_ids, patch.remove_flow_version_ids

View on GitHub (pinned to 976ec789d2)

Solutions

1. Retry the create; the provider returned a mismatched number of snapshot bindings. Report to the provider integration maintainer if reproducible.

When it happens

Trigger: Occurs when the number of snapshot bindings returned by the provider on create does not match the number of attached flow versions.

Common situations: See trigger scenarios.

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