From f70c9877d814c8b1b8ec4ad5c587b123964646fd Mon Sep 17 00:00:00 2001
From: Shivam Saraf <shivam.saraf@temporal.io>
Date: Thu, 9 Apr 2026 10:24:19 -0700
Subject: [PATCH] Add revision_number to DeclinedTargetVersionUpgrade

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 openapi/openapiv2.json                | 5 +++++
 openapi/openapiv3.yaml                | 7 +++++++
 temporal/api/history/v1/message.proto | 5 +++++
 3 files changed, 17 insertions(+)

diff --git a/openapi/openapiv2.json b/openapi/openapiv2.json
index 74f2dfb28..da5f7ba3f 100644
--- a/openapi/openapiv2.json
+++ b/openapi/openapiv2.json
@@ -12725,6 +12725,11 @@
       "properties": {
         "deploymentVersion": {
           "$ref": "#/definitions/v1WorkerDeploymentVersion"
+        },
+        "revisionNumber": {
+          "type": "string",
+          "format": "int64",
+          "description": "Revision number of the task queue routing config at the time the target\nwas declined. If an incoming target's revision is <= this value, it is\nnot newer and is not used for deciding whether or not to suppress the\nupgrade signal."
         }
       },
       "description": "Wrapper for a target deployment version that the SDK declined to upgrade to.\nSee declined_target_version_upgrade on WorkflowExecutionStartedEventAttributes."
diff --git a/openapi/openapiv3.yaml b/openapi/openapiv3.yaml
index 93f3a1075..069279d19 100644
--- a/openapi/openapiv3.yaml
+++ b/openapi/openapiv3.yaml
@@ -9762,6 +9762,13 @@ components:
       properties:
         deploymentVersion:
           $ref: '#/components/schemas/WorkerDeploymentVersion'
+        revisionNumber:
+          type: string
+          description: |-
+            Revision number of the task queue routing config at the time the target
+             was declined. If an incoming target's revision is <= this value, it is
+             not newer and is not used for deciding whether or not to suppress the
+             upgrade signal.
       description: |-
         Wrapper for a target deployment version that the SDK declined to upgrade to.
          See declined_target_version_upgrade on WorkflowExecutionStartedEventAttributes.
diff --git a/temporal/api/history/v1/message.proto b/temporal/api/history/v1/message.proto
index cf866fcdd..8c3d6e656 100644
--- a/temporal/api/history/v1/message.proto
+++ b/temporal/api/history/v1/message.proto
@@ -202,6 +202,11 @@ message WorkflowExecutionStartedEventAttributes {
 // See declined_target_version_upgrade on WorkflowExecutionStartedEventAttributes.
 message DeclinedTargetVersionUpgrade {
     temporal.api.deployment.v1.WorkerDeploymentVersion deployment_version = 1;
+    // Revision number of the task queue routing config at the time the target
+    // was declined. If an incoming target's revision is <= this value, it is
+    // not newer and is not used for deciding whether or not to suppress the
+    // upgrade signal.
+    int64 revision_number = 2;
 }
 
 message WorkflowExecutionCompletedEventAttributes {