langflow-ai/langflow · error · HTTPException

Invalid flow-version provider_data payload: snapshot id must

Error message

Invalid flow-version provider_data payload: snapshot id must be a non-empty string.

What it means

Error "Invalid flow-version provider_data payload: snapshot id must be a non-empty string." thrown in langflow-ai/langflow.

Source

Thrown at src/backend/base/langflow/api/v1/mappers/deployments/watsonx_orchestrate/mapper.py:1462

        return normalized_rows

    def _resolve_flow_version_item_data_by_snapshot_id(
        self,
        *,
        snapshot_result: SnapshotListResult | None,
    ) -> dict[str, dict[str, Any]]:
        """Build API flow-version item provider_data keyed by snapshot id."""
        if snapshot_result is None:
            return {}
        if not snapshot_result.snapshots:
            return {}

        item_data_by_snapshot_id: dict[str, dict[str, Any]] = {}
        for snapshot in snapshot_result.snapshots:
            snapshot_id = str(snapshot.id).strip()
            if not snapshot_id:
                msg = "Invalid flow-version provider_data payload: snapshot id must be a non-empty string."
                raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)

            provider_data = snapshot.provider_data

            if not isinstance(provider_data, dict) or not provider_data:
                msg = "Invalid flow-version provider_data payload: snapshot provider_data must be a non-empty object."
                raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)

            raw_connections = provider_data.get("connections")
            if not isinstance(raw_connections, dict):
                msg = "Invalid flow-version provider_data payload: connections must be a dict."
                raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg)
            try:
                item_data_by_snapshot_id[snapshot_id] = self._validate_slot(
                    self.api_payloads.deployment_item_data,
                    {
                        "app_ids": list(raw_connections.keys()),
                        "tool_name": snapshot.name,
                        "tool_display_name": provider_data["display_name"],

View on GitHub (pinned to 976ec789d2)

Solutions

1. Provide a non-empty string snapshot id in the flow-version provider_data.

When it happens

Trigger: Occurs when a flow-version provider_data payload has a snapshot id that is empty or not a string.

Common situations: See trigger scenarios.

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