langflow-ai/langflow · error · HTTPException

Invalid flow-version provider_data payload: connections must

Error message

Invalid flow-version provider_data payload: connections must be a dict.

What it means

Error "Invalid flow-version provider_data payload: connections must be a dict." thrown in langflow-ai/langflow.

Source

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

            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"],
                    },
                )
            except KeyError as exc:
                raise HTTPException(
                    status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
                    detail=f"Failed to load tool data for tool id {snapshot_id}",
                ) from exc
            except AdapterPayloadValidationError as exc:
                detail = exc.format_first_error()
                raise HTTPException(
                    status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,

View on GitHub (pinned to 976ec789d2)

Solutions

1. Pass connections as a dict in the flow-version provider_data.

When it happens

Trigger: Occurs when a flow-version provider_data payload has a connections field that is not a dict.

Common situations: See trigger scenarios.

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