From b49ffb5798a786f10ca77dca18a5e73ea2bde176 Mon Sep 17 00:00:00 2001
From: Maruthi ChandraSekhar Vemuri <maruthi.vemuri@temporal.io>
Date: Fri, 24 Jul 2026 10:18:04 -0700
Subject: [PATCH] [SDK Ergonomics] NEXUS-519: Add link to QueryWorkflowResponse

For Nexus Operations. Query is both read-only and sync- so
1. no callbacks
2. the link is only from caller to the handler- and is specifically a workflow link as there isnt a history event in handler for query
---
 openapi/openapiv2.json                                 | 4 ++++
 openapi/openapiv3.yaml                                 | 4 ++++
 temporal/api/workflowservice/v1/request_response.proto | 2 ++
 3 files changed, 10 insertions(+)

diff --git a/openapi/openapiv2.json b/openapi/openapiv2.json
index 97ff181c9..43a9e9b77 100644
--- a/openapi/openapiv2.json
+++ b/openapi/openapiv2.json
@@ -18208,6 +18208,10 @@
         },
         "queryRejected": {
           "$ref": "#/definitions/v1QueryRejected"
+        },
+        "link": {
+          "$ref": "#/definitions/v1Link",
+          "description": "Holds the link to the Workflow execution that processed the Query."
         }
       }
     },
diff --git a/openapi/openapiv3.yaml b/openapi/openapiv3.yaml
index f2081bd9b..19810f640 100644
--- a/openapi/openapiv3.yaml
+++ b/openapi/openapiv3.yaml
@@ -14770,6 +14770,10 @@ components:
           $ref: '#/components/schemas/Payloads'
         queryRejected:
           $ref: '#/components/schemas/QueryRejected'
+        link:
+          allOf:
+            - $ref: '#/components/schemas/Link'
+          description: Holds the link to the Workflow execution that processed the Query.
     RampByPercentage:
       type: object
       properties:
diff --git a/temporal/api/workflowservice/v1/request_response.proto b/temporal/api/workflowservice/v1/request_response.proto
index 66f478c5c..fe05f3cfe 100644
--- a/temporal/api/workflowservice/v1/request_response.proto
+++ b/temporal/api/workflowservice/v1/request_response.proto
@@ -1187,6 +1187,8 @@ message QueryWorkflowRequest {
 message QueryWorkflowResponse {
     temporal.api.common.v1.Payloads query_result = 1;
     temporal.api.query.v1.QueryRejected query_rejected = 2;
+    // Holds the link to the Workflow execution that processed the Query. 
+    temporal.api.common.v1.Link link = 3;
 }
 
 message DescribeWorkflowExecutionRequest {