langflow-ai/langflow · error · HTTPException

Unable to create tool name for flow_version_id: [{flow_versi

Error message

Unable to create tool name for flow_version_id: [{flow_version_id}]

What it means

Error "Unable to create tool name for flow_version_id: [{flow_version_id}]" thrown in langflow-ai/langflow.

Source

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

        tool_display_name: str,
    ) -> _FlowToolPayload:
        parsed_provider_data = self.parse_adapter_slot(
            slot=WXO_ADAPTER_PAYLOAD_SCHEMAS.flow_artifact,
            slot_name="flow_artifact",
            raw={
                "source_ref": str(flow_version_id),
                "project_id": str(project_id),
                "tool_display_name": tool_display_name,
            },
            operation="building flow tool provider data",
        )
        provider_data = parsed_provider_data.model_dump(mode="json", exclude_none=True)

        try:
            technical_name = provider_data["tool_name"]
        except KeyError as exc:
            msg = f"Unable to create tool name for flow_version_id: [{flow_version_id}]"
            raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg) from exc
        return {
            "display_name": tool_display_name,
            "provider_data": provider_data,
            "raw_name": technical_name,
        }

    def _get_flow_tool_payload(
        self,
        *,
        flow_tool_by_flow_version_id: dict[UUID, _FlowToolPayload],
        flow_version_id: UUID,
        field_name: str,
    ) -> _FlowToolPayload:
        try:
            return flow_tool_by_flow_version_id[flow_version_id]
        except KeyError as exc:
            msg = f"Failed to resolve wxO tool payload for {field_name}: [{flow_version_id}]"
            raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=msg) from exc

View on GitHub (pinned to 976ec789d2)

Solutions

1. Verify the flow version exists and has a valid flow name so a tool name can be derived.

When it happens

Trigger: Occurs when the mapper cannot generate a tool name for the given flow_version_id during watsonx operations.

Common situations: See trigger scenarios.

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