diff --git a/pkgs/by-name/sw/swagger-cli/package.nix b/pkgs/by-name/sw/swagger-cli/package.nix
deleted file mode 100644
index 6edc192d6741..000000000000
--- a/pkgs/by-name/sw/swagger-cli/package.nix
+++ /dev/null
@@ -1,35 +0,0 @@
-{
-  lib,
-  buildNpmPackage,
-  fetchFromGitHub,
-}:
-
-buildNpmPackage rec {
-  pname = "swagger-cli";
-  version = "4.0.4";
-
-  src = fetchFromGitHub {
-    owner = "APIDevTools";
-    repo = "swagger-cli";
-    rev = "v${version}";
-    sha256 = "sha256-WgzfSd57vRwa1HrSgNxD0F5ckczBkOaVmrEZ9tMAcRA=";
-  };
-
-  npmDepsHash = "sha256-go9eYGCZmbwRArHVTVa6mxL+kjvBcrLxKw2iVv0a5hY=";
-
-  buildPhase = ''
-    npm run bump
-  '';
-
-  postInstall = ''
-    find $out/lib/node_modules -xtype l -delete
-  '';
-
-  meta = {
-    description = "Swagger 2.0 and OpenAPI 3.0 command-line tool";
-    homepage = "https://apitools.dev/swagger-cli/";
-    license = lib.licenses.mit;
-    maintainers = with lib.maintainers; [ dit7ya ];
-    mainProgram = "swagger-cli";
-  };
-}
diff --git a/pkgs/top-level/aliases.nix b/pkgs/top-level/aliases.nix
index 89f096b3ab71..b9f1e8fa522d 100644
--- a/pkgs/top-level/aliases.nix
+++ b/pkgs/top-level/aliases.nix
@@ -1995,6 +1995,7 @@ mapAliases {
   superTuxKart = warnAlias "'superTuxKart' has been renamed to 'supertuxkart'" supertuxkart; # Added 2026-02-12
   surge-XT = warnAlias "'surge-XT' has been renamed to 'surge-xt'" surge-xt; # Added 2026-02-12
   svt-av1-psy = warnAlias "'svt-av1-psy' has been replaced by 'svt-av1-psyex'" svt-av1-psyex; # Added 2026-01-10
+  swagger-cli = throw "'swagger-cli' has been removed as it is broken and unmaintained. Upstream suggests using 'redocly' instead"; # Added 2026-04-23
   swig4 = throw "'swig4' has been renamed to/replaced by 'swig'"; # Converted to throw 2025-10-27
   swiProlog = throw "'swiProlog' has been renamed to/replaced by 'swi-prolog'"; # Converted to throw 2025-10-27
   swiPrologWithGui = throw "'swiPrologWithGui' has been renamed to/replaced by 'swi-prolog-gui'"; # Converted to throw 2025-10-27