From 39ec5728a2f41a3dcff6a73bdcae21f0d4793448 Mon Sep 17 00:00:00 2001
From: jmaeagle99 <44687433+jmaeagle99@users.noreply.github.com>
Date: Fri, 24 Apr 2026 11:23:11 -0700
Subject: [PATCH] Add ExternalStorageReference proto

---
 temporal/api/sdk/v1/external_storage.proto | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 temporal/api/sdk/v1/external_storage.proto

diff --git a/temporal/api/sdk/v1/external_storage.proto b/temporal/api/sdk/v1/external_storage.proto
new file mode 100644
index 000000000..5a08f9995
--- /dev/null
+++ b/temporal/api/sdk/v1/external_storage.proto
@@ -0,0 +1,20 @@
+syntax = "proto3";
+
+package temporal.api.sdk.v1;
+
+option go_package = "go.temporal.io/api/sdk/v1;sdk";
+option java_package = "io.temporal.api.sdk.v1";
+option java_multiple_files = true;
+option java_outer_classname = "ExternalStorageProto";
+option ruby_package = "Temporalio::Api::Sdk::V1";
+option csharp_namespace = "Temporalio.Api.Sdk.V1";
+
+// ExternalStorageReference identifies a payload stored in an external storage system.
+// It is used as a claim-check token, allowing the actual payload data to be retrieved
+// from the named driver using the provided claim data.
+message ExternalStorageReference {
+  // The name of the storage driver responsible for retrieving the payload.
+  string driver_name = 1;
+  // Driver-specific key-value pairs that identify and provide access to the stored payload.
+  map<string, string> claim_data = 2;
+}