From a299942c7215b9e986814a1a3eb7d85b92b682fc Mon Sep 17 00:00:00 2001
From: tobias-tengler <45513122+tobias-tengler@users.noreply.github.com>
Date: Tue, 23 Jun 2026 09:54:15 +0200
Subject: [PATCH] Surface CLI/backend version mismatch on HC0020

---
 .../src/CommandLine/Extensions/CommandExtensions.cs          | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Nitro/CommandLine/src/CommandLine/Extensions/CommandExtensions.cs b/src/Nitro/CommandLine/src/CommandLine/Extensions/CommandExtensions.cs
index dd28b99a466..78800ddfac3 100644
--- a/src/Nitro/CommandLine/src/CommandLine/Extensions/CommandExtensions.cs
+++ b/src/Nitro/CommandLine/src/CommandLine/Extensions/CommandExtensions.cs
@@ -47,10 +47,11 @@ public static Command SetActionWithExceptionHandling(
 
                 console.Error.WriteErrorLine(message);
             }
-            catch (NitroClientGraphQLException ex) when (ex.Code == "HC0067")
+            catch (NitroClientGraphQLException ex) when (ex.Code == "HC0020")
             {
                 console.Error.WriteErrorLine(
-                    "The server rejected the persisted operation of the command. Make sure your Nitro backend is on the latest version.");
+                    "The server rejected the persisted operation of the command. "
+                    + "If you are running a self-hosted instance, make sure it's running the latest version, or downgrade your CLI to match.");
             }
             catch (NitroClientGraphQLException ex)
             {