@temporalio/core-bridge 1.12.0 → 1.12.2

package/sdk-core/sdk-core-protos/protos/api_upstream/openapi/openapiv2.json

@@ -1510,7 +1510,7 @@
           },
           {
             "name": "taskQueueType",
-            "description": "Deprecated. Use `ENHANCED` mode with `task_queue_types`. Ignored in `ENHANCED` mode.\nIf unspecified (TASK_QUEUE_TYPE_UNSPECIFIED), then default value (TASK_QUEUE_TYPE_WORKFLOW) will be used.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
+            "description": "If unspecified (TASK_QUEUE_TYPE_UNSPECIFIED), then default value (TASK_QUEUE_TYPE_WORKFLOW) will be used.\nOnly supported in default mode (use `task_queue_types` in ENHANCED mode instead).\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
             "in": "query",
             "required": false,
             "type": "string",
@@ -1522,16 +1522,23 @@
             ],
             "default": "TASK_QUEUE_TYPE_UNSPECIFIED"
           },
+          {
+            "name": "reportStats",
+            "description": "Report stats for the requested task queue type(s).",
+            "in": "query",
+            "required": false,
+            "type": "boolean"
+          },
           {
             "name": "includeTaskQueueStatus",
-            "description": "Deprecated. Ignored in `ENHANCED` mode.",
+            "description": "Deprecated, use `report_stats` instead.\nIf true, the task queue status will be included in the response.",
             "in": "query",
             "required": false,
             "type": "boolean"
           },
           {
             "name": "apiMode",
-            "description": "All options except `task_queue_type` and `include_task_queue_status` are only available in the `ENHANCED` mode.\n\n - DESCRIBE_TASK_QUEUE_MODE_UNSPECIFIED: Unspecified means legacy behavior.\n - DESCRIBE_TASK_QUEUE_MODE_ENHANCED: Enhanced mode reports aggregated results for all partitions, supports Build IDs, and reports richer info.",
+            "description": "Deprecated. ENHANCED mode is also being deprecated.\nSelect the API mode to use for this request: DEFAULT mode (if unset) or ENHANCED mode.\nConsult the documentation for each field to understand which mode it is supported in.\n\n - DESCRIBE_TASK_QUEUE_MODE_UNSPECIFIED: Unspecified means legacy behavior.\n - DESCRIBE_TASK_QUEUE_MODE_ENHANCED: Enhanced mode reports aggregated results for all partitions, supports Build IDs, and reports richer info.",
             "in": "query",
             "required": false,
             "type": "string",
@@ -1568,7 +1575,7 @@
           },
           {
             "name": "taskQueueTypes",
-            "description": "Task queue types to report info about. If not specified, all types are considered.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nTask queue types to report info about. If not specified, all types are considered.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
             "in": "query",
             "required": false,
             "type": "array",
@@ -1583,23 +1590,16 @@
             },
             "collectionFormat": "multi"
           },
-          {
-            "name": "reportStats",
-            "description": "Report stats for the requested task queue types and versions",
-            "in": "query",
-            "required": false,
-            "type": "boolean"
-          },
           {
             "name": "reportPollers",
-            "description": "Report list of pollers for requested task queue types and versions",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nReport list of pollers for requested task queue types and versions.",
             "in": "query",
             "required": false,
             "type": "boolean"
           },
           {
             "name": "reportTaskReachability",
-            "description": "Report task reachability for the requested versions and all task types (task reachability is not reported\nper task type).",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nReport task reachability for the requested versions and all task types (task reachability is not reported\nper task type).",
             "in": "query",
             "required": false,
             "type": "boolean"
@@ -1777,6 +1777,13 @@
             "in": "query",
             "required": false,
             "type": "string"
+          },
+          {
+            "name": "reportTaskQueueStats",
+            "description": "Report stats for task queues which have been polled by this version.",
+            "in": "query",
+            "required": false,
+            "type": "boolean"
           }
         ],
         "tags": [
@@ -2184,6 +2191,98 @@
         ]
       }
     },
+    "/api/v1/namespaces/{namespace}/workers": {
+      "get": {
+        "summary": "ListWorkers is a visibility API to list worker status information in a specific namespace.",
+        "operationId": "ListWorkers2",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ListWorkersResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "namespace",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "required": false,
+            "type": "integer",
+            "format": "int32"
+          },
+          {
+            "name": "nextPageToken",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "byte"
+          },
+          {
+            "name": "query",
+            "description": "`query` in ListWorkers is used to filter workers based on worker status info.\nThe following worker status attributes are expected are supported as part of the query:\n* WorkerInstanceKey\n* WorkerIdentity\n* HostName\n* TaskQueue\n* DeploymentName\n* BuildId\n* SdkName\n* SdkVersion\n* StartTime\n* LastHeartbeatTime\n* Status\nCurrently metrics are not supported as a part of ListWorkers query.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "WorkflowService"
+        ]
+      }
+    },
+    "/api/v1/namespaces/{namespace}/workers/heartbeat": {
+      "post": {
+        "summary": "WorkerHeartbeat receive heartbeat request from the worker.",
+        "operationId": "RecordWorkerHeartbeat2",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1RecordWorkerHeartbeatResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "namespace",
+            "description": "Namespace this worker belongs to.",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/WorkflowServiceRecordWorkerHeartbeatBody"
+            }
+          }
+        ],
+        "tags": [
+          "WorkflowService"
+        ]
+      }
+    },
     "/api/v1/namespaces/{namespace}/workflow-count": {
       "get": {
         "summary": "CountWorkflowExecutions is a visibility API to count of workflow executions in a specific namespace.",
@@ -5058,7 +5157,7 @@
           },
           {
             "name": "taskQueueType",
-            "description": "Deprecated. Use `ENHANCED` mode with `task_queue_types`. Ignored in `ENHANCED` mode.\nIf unspecified (TASK_QUEUE_TYPE_UNSPECIFIED), then default value (TASK_QUEUE_TYPE_WORKFLOW) will be used.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
+            "description": "If unspecified (TASK_QUEUE_TYPE_UNSPECIFIED), then default value (TASK_QUEUE_TYPE_WORKFLOW) will be used.\nOnly supported in default mode (use `task_queue_types` in ENHANCED mode instead).\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
             "in": "query",
             "required": false,
             "type": "string",
@@ -5070,16 +5169,23 @@
             ],
             "default": "TASK_QUEUE_TYPE_UNSPECIFIED"
           },
+          {
+            "name": "reportStats",
+            "description": "Report stats for the requested task queue type(s).",
+            "in": "query",
+            "required": false,
+            "type": "boolean"
+          },
           {
             "name": "includeTaskQueueStatus",
-            "description": "Deprecated. Ignored in `ENHANCED` mode.",
+            "description": "Deprecated, use `report_stats` instead.\nIf true, the task queue status will be included in the response.",
             "in": "query",
             "required": false,
             "type": "boolean"
           },
           {
             "name": "apiMode",
-            "description": "All options except `task_queue_type` and `include_task_queue_status` are only available in the `ENHANCED` mode.\n\n - DESCRIBE_TASK_QUEUE_MODE_UNSPECIFIED: Unspecified means legacy behavior.\n - DESCRIBE_TASK_QUEUE_MODE_ENHANCED: Enhanced mode reports aggregated results for all partitions, supports Build IDs, and reports richer info.",
+            "description": "Deprecated. ENHANCED mode is also being deprecated.\nSelect the API mode to use for this request: DEFAULT mode (if unset) or ENHANCED mode.\nConsult the documentation for each field to understand which mode it is supported in.\n\n - DESCRIBE_TASK_QUEUE_MODE_UNSPECIFIED: Unspecified means legacy behavior.\n - DESCRIBE_TASK_QUEUE_MODE_ENHANCED: Enhanced mode reports aggregated results for all partitions, supports Build IDs, and reports richer info.",
             "in": "query",
             "required": false,
             "type": "string",
@@ -5116,7 +5222,7 @@
           },
           {
             "name": "taskQueueTypes",
-            "description": "Task queue types to report info about. If not specified, all types are considered.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nTask queue types to report info about. If not specified, all types are considered.\n\n - TASK_QUEUE_TYPE_WORKFLOW: Workflow type of task queue.\n - TASK_QUEUE_TYPE_ACTIVITY: Activity type of task queue.\n - TASK_QUEUE_TYPE_NEXUS: Task queue type for dispatching Nexus requests.",
             "in": "query",
             "required": false,
             "type": "array",
@@ -5131,23 +5237,16 @@
             },
             "collectionFormat": "multi"
           },
-          {
-            "name": "reportStats",
-            "description": "Report stats for the requested task queue types and versions",
-            "in": "query",
-            "required": false,
-            "type": "boolean"
-          },
           {
             "name": "reportPollers",
-            "description": "Report list of pollers for requested task queue types and versions",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nReport list of pollers for requested task queue types and versions.",
             "in": "query",
             "required": false,
             "type": "boolean"
           },
           {
             "name": "reportTaskReachability",
-            "description": "Report task reachability for the requested versions and all task types (task reachability is not reported\nper task type).",
+            "description": "Deprecated (as part of the ENHANCED mode deprecation).\nReport task reachability for the requested versions and all task types (task reachability is not reported\nper task type).",
             "in": "query",
             "required": false,
             "type": "boolean"
@@ -5286,6 +5385,13 @@
             "in": "query",
             "required": false,
             "type": "string"
+          },
+          {
+            "name": "reportTaskQueueStats",
+            "description": "Report stats for task queues which have been polled by this version.",
+            "in": "query",
+            "required": false,
+            "type": "boolean"
           }
         ],
         "tags": [
@@ -5693,6 +5799,98 @@
         ]
       }
     },
+    "/namespaces/{namespace}/workers": {
+      "get": {
+        "summary": "ListWorkers is a visibility API to list worker status information in a specific namespace.",
+        "operationId": "ListWorkers",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ListWorkersResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "namespace",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "required": false,
+            "type": "integer",
+            "format": "int32"
+          },
+          {
+            "name": "nextPageToken",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "byte"
+          },
+          {
+            "name": "query",
+            "description": "`query` in ListWorkers is used to filter workers based on worker status info.\nThe following worker status attributes are expected are supported as part of the query:\n* WorkerInstanceKey\n* WorkerIdentity\n* HostName\n* TaskQueue\n* DeploymentName\n* BuildId\n* SdkName\n* SdkVersion\n* StartTime\n* LastHeartbeatTime\n* Status\nCurrently metrics are not supported as a part of ListWorkers query.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "WorkflowService"
+        ]
+      }
+    },
+    "/namespaces/{namespace}/workers/heartbeat": {
+      "post": {
+        "summary": "WorkerHeartbeat receive heartbeat request from the worker.",
+        "operationId": "RecordWorkerHeartbeat",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1RecordWorkerHeartbeatResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "namespace",
+            "description": "Namespace this worker belongs to.",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/WorkflowServiceRecordWorkerHeartbeatBody"
+            }
+          }
+        ],
+        "tags": [
+          "WorkflowService"
+        ]
+      }
+    },
     "/namespaces/{namespace}/workflow-count": {
       "get": {
         "summary": "CountWorkflowExecutions is a visibility API to count of workflow executions in a specific namespace.",
@@ -6734,6 +6932,21 @@
         }
       }
     },
+    "DescribeWorkerDeploymentVersionResponseVersionTaskQueue": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/definitions/v1TaskQueueType"
+        },
+        "stats": {
+          "$ref": "#/definitions/v1TaskQueueStats",
+          "description": "Only set if `report_task_queue_stats` is set on the request."
+        }
+      }
+    },
     "EndpointTargetExternal": {
       "type": "object",
       "properties": {
@@ -6812,6 +7025,18 @@
         },
         "routingConfig": {
           "$ref": "#/definitions/v1RoutingConfig"
+        },
+        "latestVersionSummary": {
+          "$ref": "#/definitions/WorkerDeploymentInfoWorkerDeploymentVersionSummary",
+          "description": "Summary of the version that was added most recently in the Worker Deployment."
+        },
+        "currentVersionSummary": {
+          "$ref": "#/definitions/WorkerDeploymentInfoWorkerDeploymentVersionSummary",
+          "description": "Summary of the current version of the Worker Deployment."
+        },
+        "rampingVersionSummary": {
+          "$ref": "#/definitions/WorkerDeploymentInfoWorkerDeploymentVersionSummary",
+          "description": "Summary of the ramping version of the Worker Deployment."
         }
       },
       "title": "A subset of WorkerDeploymentInfo"
@@ -6922,7 +7147,7 @@
       "properties": {
         "operationId": {
           "type": "string",
-          "description": "Deprecated: Renamed to operation_token."
+          "description": "Deprecated. Renamed to operation_token."
         },
         "links": {
           "type": "array",
@@ -7095,6 +7320,10 @@
           "type": "string",
           "description": "Deprecated. Use `deployment_version`."
         },
+        "status": {
+          "$ref": "#/definitions/v1WorkerDeploymentVersionStatus",
+          "description": "The status of the Worker Deployment Version."
+        },
         "deploymentVersion": {
           "$ref": "#/definitions/v1WorkerDeploymentVersion",
           "description": "Required."
@@ -7104,7 +7333,37 @@
           "format": "date-time"
         },
         "drainageStatus": {
-          "$ref": "#/definitions/v1VersionDrainageStatus"
+          "$ref": "#/definitions/v1VersionDrainageStatus",
+          "description": "Deprecated. Use `drainage_info` instead."
+        },
+        "drainageInfo": {
+          "$ref": "#/definitions/v1VersionDrainageInfo",
+          "title": "Information about workflow drainage to help the user determine when it is safe\nto decommission a Version. Not present while version is current or ramping"
+        },
+        "currentSinceTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Unset if not current."
+        },
+        "rampingSinceTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Unset if not ramping. Updated when the version first starts ramping, not on each ramp change."
+        },
+        "routingUpdateTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last time `current_since_time`, `ramping_since_time, or `ramp_percentage` of this version changed."
+        },
+        "firstActivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp when this version first became current or ramping."
+        },
+        "lastDeactivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp when this version last stopped being current or ramping."
         }
       }
     },
@@ -7339,6 +7598,22 @@
         }
       }
     },
+    "WorkflowServiceRecordWorkerHeartbeatBody": {
+      "type": "object",
+      "properties": {
+        "identity": {
+          "type": "string",
+          "description": "The identity of the client who initiated this request."
+        },
+        "workerHeartbeat": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/v1WorkerHeartbeat"
+          }
+        }
+      }
+    },
     "WorkflowServiceRequestCancelWorkflowExecutionBody": {
       "type": "object",
       "properties": {
@@ -7407,6 +7682,10 @@
         "jitter": {
           "type": "string",
           "title": "If set, and activity is in backoff, the activity will start at a random time within the specified jitter duration.\n(unless it is paused and keep_paused is set)"
+        },
+        "restoreOriginalOptions": {
+          "type": "boolean",
+          "description": "If set, the activity options will be restored to the defaults.\nDefault options are then options activity was created with.\nThey are part of the first SCHEDULE event."
         }
       }
     },
@@ -7437,7 +7716,7 @@
         },
         "resetReapplyType": {
           "$ref": "#/definitions/v1ResetReapplyType",
-          "title": "Event types to be reapplied (deprecated)\nDefault: RESET_REAPPLY_TYPE_SIGNAL"
+          "title": "Deprecated. Use `options`.\nDefault: RESET_REAPPLY_TYPE_SIGNAL"
         },
         "resetReapplyExcludeTypes": {
           "type": "array",
@@ -7453,6 +7732,10 @@
             "$ref": "#/definitions/v1PostResetOperation"
           },
           "title": "Operations to perform after the workflow has been reset. These operations will be applied\nto the *new* run of the workflow execution in the order they are provided.\nAll operations are applied to the workflow before the first new workflow task is generated"
+        },
+        "identity": {
+          "type": "string",
+          "title": "The identity of the worker/client"
         }
       }
     },
@@ -7764,7 +8047,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "retryPolicy": {
           "$ref": "#/definitions/v1RetryPolicy",
@@ -7835,7 +8118,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "header": {
           "$ref": "#/definitions/v1Header",
@@ -8144,6 +8427,10 @@
         "type": {
           "type": "string",
           "description": "Update all running activities of this type."
+        },
+        "restoreOriginal": {
+          "type": "boolean",
+          "description": "If set, the activity options will be restored to the default.\nDefault options are then options activity was created with.\nThey are part of the first SCHEDULE event.\nThis flag cannot be combined with any other option; if you supply\nrestore_original together with other options, the request will be rejected."
         }
       }
     },
@@ -8221,6 +8508,10 @@
             "type": "string"
           },
           "description": "List of keys to remove from the metadata."
+        },
+        "identity": {
+          "type": "string",
+          "description": "Optional. The identity of the client who initiated this request."
         }
       },
       "description": "Used to update the user-defined metadata of a Worker Deployment Version."
@@ -8917,11 +9208,11 @@
         },
         "resetType": {
           "$ref": "#/definitions/v1ResetType",
-          "description": "Reset type (deprecated, use `options`)."
+          "description": "Deprecated. Use `options`."
         },
         "resetReapplyType": {
           "$ref": "#/definitions/v1ResetReapplyType",
-          "description": "History event reapply options (deprecated, use `options`)."
+          "description": "Deprecated. Use `options`."
         },
         "postResetOperations": {
           "type": "array",
@@ -9220,7 +9511,7 @@
         },
         "operationId": {
           "type": "string",
-          "description": "Operation ID as originally generated by a Handler.\n\nDeprecated: Renamed to operation_token."
+          "description": "Operation ID as originally generated by a Handler.\n\nDeprecated. Renamed to operation_token."
         },
         "operationToken": {
           "type": "string",
@@ -9695,7 +9986,7 @@
         },
         "inheritBuildId": {
           "type": "boolean",
-          "description": "If this is set, the new execution inherits the Build ID of the current execution. Otherwise,\nthe assignment rules will be used to independently assign a Build ID to the new execution."
+          "description": "If this is set, the new execution inherits the Build ID of the current execution. Otherwise,\nthe assignment rules will be used to independently assign a Build ID to the new execution.\nDeprecated. Only considered for versioning v0.2."
         }
       }
     },
@@ -10027,23 +10318,26 @@
           "items": {
             "type": "object",
             "$ref": "#/definitions/v1PollerInfo"
-          },
-          "description": "Deprecated. Use `versions_info.types_info.pollers` with `ENHANCED` mode instead.\nNot set in `ENHANCED` mode."
+          }
+        },
+        "stats": {
+          "$ref": "#/definitions/v1TaskQueueStats",
+          "description": "Statistics for the task queue. Only populated when `report_stats` is set to true in the request."
+        },
+        "versioningInfo": {
+          "$ref": "#/definitions/v1TaskQueueVersioningInfo",
+          "description": "Specifies which Worker Deployment Version(s) Server routes this Task Queue's tasks to.\nWhen not present, it means the tasks are routed to Unversioned workers (workers with\nUNVERSIONED or unspecified WorkerVersioningMode.)\nTask Queue Versioning info is updated indirectly by calling SetWorkerDeploymentCurrentVersion\nand SetWorkerDeploymentRampingVersion on Worker Deployments.\nNote: This information is not relevant to Pinned workflow executions and their activities as\nthey are always routed to their Pinned Deployment Version. However, new workflow executions\nare typically not Pinned until they complete their first task (unless they are started with\na Pinned VersioningOverride or are Child Workflows of a Pinned parent)."
         },
         "taskQueueStatus": {
           "$ref": "#/definitions/v1TaskQueueStatus",
-          "description": "Deprecated. Not set in `ENHANCED` mode."
+          "description": "Deprecated.\nStatus of the task queue. Only populated when `include_task_queue_status` is set to true in the request."
         },
         "versionsInfo": {
           "type": "object",
           "additionalProperties": {
             "$ref": "#/definitions/v1TaskQueueVersionInfo"
           },
-          "description": "This map contains Task Queue information for each Build ID. Empty string as key value means unversioned.\nOnly set in `ENHANCED` mode."
-        },
-        "versioningInfo": {
-          "$ref": "#/definitions/v1TaskQueueVersioningInfo",
-          "description": "Specifies which Worker Deployment Version(s) Server routes this Task Queue's tasks to.\nWhen not present, it means the tasks are routed to Unversioned workers (workers with\nUNVERSIONED or unspecified WorkerVersioningMode.)\nTask Queue Versioning info is updated indirectly by calling SetWorkerDeploymentCurrentVersion\nand SetWorkerDeploymentRampingVersion on Worker Deployments.\nNote: This information is not relevant to Pinned workflow executions and their activities as\nthey are always routed to their Pinned Deployment Version. However, new workflow executions\nare typically not Pinned until they complete their first task (unless they are started with\na Pinned VersioningOverride or are Child Workflows of a Pinned parent)."
+          "description": "Deprecated.\nOnly returned in ENHANCED mode.\nThis map contains Task Queue information for each Build ID. Empty string as key value means unversioned."
         }
       }
     },
@@ -10065,6 +10359,14 @@
       "properties": {
         "workerDeploymentVersionInfo": {
           "$ref": "#/definitions/v1WorkerDeploymentVersionInfo"
+        },
+        "versionTaskQueues": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/DescribeWorkerDeploymentVersionResponseVersionTaskQueue"
+          },
+          "description": "All the Task Queues that have ever polled from this Deployment version."
         }
       }
     },
@@ -10324,7 +10626,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         }
       }
     },
@@ -11113,6 +11415,23 @@
         }
       }
     },
+    "v1ListWorkersResponse": {
+      "type": "object",
+      "properties": {
+        "workersInfo": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/v1WorkerInfo"
+          }
+        },
+        "nextPageToken": {
+          "type": "string",
+          "format": "byte",
+          "title": "Next page token"
+        }
+      }
+    },
     "v1ListWorkflowExecutionsResponse": {
       "type": "object",
       "properties": {
@@ -11642,7 +11961,7 @@
         },
         "operationId": {
           "type": "string",
-          "description": "Operation ID - may be empty if the operation completed synchronously.\n\nDeprecated: Renamed to operation_token."
+          "description": "Operation ID - may be empty if the operation completed synchronously.\n\nDeprecated. Renamed to operation_token."
         },
         "operationToken": {
           "type": "string",
@@ -11850,15 +12169,15 @@
         "useWorkflowBuildId": {
           "type": "object",
           "properties": {},
-          "description": "When present, it means this activity is assigned to the build ID of its workflow."
+          "description": "Deprecated. When present, it means this activity is assigned to the build ID of its workflow."
         },
         "lastIndependentlyAssignedBuildId": {
           "type": "string",
-          "description": "This means the activity is independently versioned and not bound to the build ID of its workflow.\nThe activity will use the build id in this field instead.\nIf the task fails and is scheduled again, the assigned build ID may change according to the latest versioning\nrules."
+          "description": "Deprecated. This means the activity is independently versioned and not bound to the build ID of its workflow.\nThe activity will use the build id in this field instead.\nIf the task fails and is scheduled again, the assigned build ID may change according to the latest versioning\nrules."
         },
         "lastWorkerVersionStamp": {
           "$ref": "#/definitions/v1WorkerVersionStamp",
-          "title": "The version stamp of the worker to whom this activity was most recently dispatched\nDeprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]"
+          "title": "Deprecated. The version stamp of the worker to whom this activity was most recently dispatched\nThis field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]"
         },
         "currentRetryInterval": {
           "type": "string",
@@ -11955,7 +12274,7 @@
         },
         "operationId": {
           "type": "string",
-          "description": "Operation ID. Only set for asynchronous operations after a successful StartOperation call.\n\nDeprecated: Renamed to operation_token."
+          "description": "Operation ID. Only set for asynchronous operations after a successful StartOperation call.\n\nDeprecated. Renamed to operation_token."
         },
         "scheduleToCloseTimeout": {
           "type": "string",
@@ -12446,6 +12765,9 @@
         }
       }
     },
+    "v1RecordWorkerHeartbeatResponse": {
+      "type": "object"
+    },
     "v1RegisterNamespaceRequest": {
       "type": "object",
       "properties": {
@@ -12598,7 +12920,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         }
       }
     },
@@ -12622,7 +12944,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "childWorkflowOnly": {
           "type": "boolean",
@@ -12693,7 +13015,7 @@
         },
         "resetReapplyType": {
           "$ref": "#/definitions/v1ResetReapplyType",
-          "title": "Event types to be reapplied (deprecated)\nDefault: RESET_REAPPLY_TYPE_SIGNAL"
+          "title": "Deprecated. Use `options`.\nDefault: RESET_REAPPLY_TYPE_SIGNAL"
         },
         "currentRunOnly": {
           "type": "boolean",
@@ -12718,7 +13040,7 @@
         },
         "binaryChecksum": {
           "type": "string",
-          "description": "A worker binary version identifier (deprecated)."
+          "description": "Deprecated. A worker binary version identifier."
         },
         "runId": {
           "type": "string",
@@ -12778,7 +13100,7 @@
         "RESET_REAPPLY_TYPE_ALL_ELIGIBLE"
       ],
       "default": "RESET_REAPPLY_TYPE_UNSPECIFIED",
-      "description": "Event types to include when reapplying events. Deprecated: applications\nshould use ResetReapplyExcludeType to specify exclusions from this set, and\nnew event types should be added to ResetReapplyExcludeType instead of here.\n\n - RESET_REAPPLY_TYPE_SIGNAL: Signals are reapplied when workflow is reset.\n - RESET_REAPPLY_TYPE_NONE: No events are reapplied when workflow is reset.\n - RESET_REAPPLY_TYPE_ALL_ELIGIBLE: All eligible events are reapplied when workflow is reset."
+      "description": "Deprecated: applications should use ResetReapplyExcludeType to specify\nexclusions from this set, and new event types should be added to ResetReapplyExcludeType\ninstead of here.\n\n - RESET_REAPPLY_TYPE_SIGNAL: Signals are reapplied when workflow is reset.\n - RESET_REAPPLY_TYPE_NONE: No events are reapplied when workflow is reset.\n - RESET_REAPPLY_TYPE_ALL_ELIGIBLE: All eligible events are reapplied when workflow is reset."
     },
     "v1ResetStickyTaskQueueResponse": {
       "type": "object"
@@ -12791,7 +13113,7 @@
         "RESET_TYPE_LAST_WORKFLOW_TASK"
       ],
       "default": "RESET_TYPE_UNSPECIFIED",
-      "description": "Reset type options. Deprecated, see temporal.api.common.v1.ResetOptions.\n\n - RESET_TYPE_FIRST_WORKFLOW_TASK: Resets to event of the first workflow task completed, or if it does not exist, the event after task scheduled.\n - RESET_TYPE_LAST_WORKFLOW_TASK: Resets to event of the last workflow task completed, or if it does not exist, the event after task scheduled."
+      "description": "Deprecated, see temporal.api.common.v1.ResetOptions.\n\n - RESET_TYPE_FIRST_WORKFLOW_TASK: Resets to event of the first workflow task completed, or if it does not exist, the event after task scheduled.\n - RESET_TYPE_LAST_WORKFLOW_TASK: Resets to event of the last workflow task completed, or if it does not exist, the event after task scheduled."
     },
     "v1ResetWorkflowExecutionResponse": {
       "type": "object",
@@ -13157,7 +13479,8 @@
           "format": "date-time"
         },
         "invalidScheduleError": {
-          "type": "string"
+          "type": "string",
+          "description": "Deprecated."
         }
       }
     },
@@ -13346,7 +13669,7 @@
             "type": "object",
             "$ref": "#/definitions/v1CalendarSpec"
           },
-          "description": "Any timestamps matching any of exclude_* will be skipped.\n\nuse exclude_structured_calendar"
+          "description": "Any timestamps matching any of exclude_* will be skipped.\nDeprecated. Use exclude_structured_calendar."
         },
         "excludeStructuredCalendar": {
           "type": "array",
@@ -13557,7 +13880,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         }
       }
     },
@@ -13589,7 +13912,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "childWorkflowOnly": {
           "type": "boolean",
@@ -13678,7 +14001,7 @@
         },
         "inheritBuildId": {
           "type": "boolean",
-          "description": "If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment\nrules of the child's Task Queue will be used to independently assign a Build ID to it."
+          "description": "If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment\nrules of the child's Task Queue will be used to independently assign a Build ID to it.\nDeprecated. Only considered for versioning v0.2."
         },
         "priority": {
           "$ref": "#/definitions/v1Priority",
@@ -13716,7 +14039,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "initiatedEventId": {
           "type": "string",
@@ -13770,7 +14093,7 @@
         },
         "control": {
           "type": "string",
-          "title": "Deprecated"
+          "description": "Deprecated."
         },
         "workflowTaskCompletedEventId": {
           "type": "string",
@@ -13799,7 +14122,7 @@
         },
         "inheritBuildId": {
           "type": "boolean",
-          "description": "If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment\nrules of the child's Task Queue will be used to independently assign a Build ID to it."
+          "description": "If this is set, the child workflow inherits the Build ID of the parent. Otherwise, the assignment\nrules of the child's Task Queue will be used to independently assign a Build ID to it.\nDeprecated. Only considered for versioning v0.2."
         },
         "priority": {
           "$ref": "#/definitions/v1Priority",
@@ -14466,6 +14789,11 @@
         "overlapPolicy": {
           "$ref": "#/definitions/v1ScheduleOverlapPolicy",
           "description": "If set, override overlap policy for this one request."
+        },
+        "scheduledTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp used for the identity of the target workflow.\nIf not set the default value is the current time."
         }
       }
     },
@@ -14834,7 +15162,7 @@
           "description": "Required if behavior is `PINNED`. Must be absent if behavior is not `PINNED`.\nIdentifies the worker deployment version to pin the workflow to, in the format\n\"<deployment_name>.<build_id>\".\nDeprecated. Use `override.pinned.version`."
         }
       },
-      "description": "Used to override the versioning behavior (and pinned deployment version, if applicable) of a\nspecific workflow execution. If set, takes precedence over the worker-sent values. See\n`WorkflowExecutionInfo.VersioningInfo` for more information. To remove the override, call\n`UpdateWorkflowExecutionOptions` with a null `VersioningOverride`, and use the `update_mask`\nto indicate that it should be mutated."
+      "description": "Used to override the versioning behavior (and pinned deployment version, if applicable) of a\nspecific workflow execution. If set, takes precedence over the worker-sent values. See\n`WorkflowExecutionInfo.VersioningInfo` for more information. To remove the override, call\n`UpdateWorkflowExecutionOptions` with a null `VersioningOverride`, and use the `update_mask`\nto indicate that it should be mutated.\nPinned overrides are automatically inherited by child workflows, continue-as-new workflows,\nworkflow retries, and cron workflows."
     },
     "v1WaitPolicy": {
       "type": "object",
@@ -14914,6 +15242,10 @@
           "type": "string",
           "description": "Deprecated. Use `deployment_version`."
         },
+        "status": {
+          "$ref": "#/definitions/v1WorkerDeploymentVersionStatus",
+          "description": "The status of the Worker Deployment Version."
+        },
         "deploymentVersion": {
           "$ref": "#/definitions/v1WorkerDeploymentVersion",
           "description": "Required."
@@ -14933,12 +15265,22 @@
         "currentSinceTime": {
           "type": "string",
           "format": "date-time",
-          "description": "\nNil if not current."
+          "description": "\nUnset if not current."
         },
         "rampingSinceTime": {
           "type": "string",
           "format": "date-time",
-          "description": "\nNil if not ramping. Updated when the version first starts ramping, not on each ramp change."
+          "description": "\nUnset if not ramping. Updated when the version first starts ramping, not on each ramp change."
+        },
+        "firstActivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp when this version first became current or ramping."
+        },
+        "lastDeactivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp when this version last stopped being current or ramping."
         },
         "rampPercentage": {
           "type": "number",
@@ -14951,7 +15293,7 @@
             "type": "object",
             "$ref": "#/definitions/WorkerDeploymentVersionInfoVersionTaskQueueInfo"
           },
-          "description": "All the Task Queues that have ever polled from this Deployment version."
+          "description": "All the Task Queues that have ever polled from this Deployment version.\nDeprecated. Use `version_task_queues` in DescribeWorkerDeploymentVersionResponse instead."
         },
         "drainageInfo": {
           "$ref": "#/definitions/v1VersionDrainageInfo",
@@ -14964,6 +15306,210 @@
       },
       "description": "A Worker Deployment Version (Version, for short) represents all workers of the same \ncode and config within a Deployment. Workers of the same Version are expected to \nbehave exactly the same so when executions move between them there are no \nnon-determinism issues.\nWorker Deployment Versions are created in Temporal server automatically when \ntheir first poller arrives to the server.\nExperimental. Worker Deployments are experimental and might significantly change in the future."
     },
+    "v1WorkerDeploymentVersionStatus": {
+      "type": "string",
+      "enum": [
+        "WORKER_DEPLOYMENT_VERSION_STATUS_UNSPECIFIED",
+        "WORKER_DEPLOYMENT_VERSION_STATUS_INACTIVE",
+        "WORKER_DEPLOYMENT_VERSION_STATUS_CURRENT",
+        "WORKER_DEPLOYMENT_VERSION_STATUS_RAMPING",
+        "WORKER_DEPLOYMENT_VERSION_STATUS_DRAINING",
+        "WORKER_DEPLOYMENT_VERSION_STATUS_DRAINED"
+      ],
+      "default": "WORKER_DEPLOYMENT_VERSION_STATUS_UNSPECIFIED",
+      "description": "Specify the status of a Worker Deployment Version.\nExperimental. Worker Deployments are experimental and might significantly change in the future.\n\n - WORKER_DEPLOYMENT_VERSION_STATUS_INACTIVE: The Worker Deployment Version has been created inside the Worker Deployment but is not used by any\nworkflow executions. These Versions can still have workflows if they have an explicit Versioning Override targeting\nthis Version. Such Versioning Override could be set at workflow start time, or at a later time via `UpdateWorkflowExecutionOptions`.\n - WORKER_DEPLOYMENT_VERSION_STATUS_CURRENT: The Worker Deployment Version is the current version of the Worker Deployment. All new workflow executions \nand tasks of existing unversioned or AutoUpgrade workflows are routed to this version.\n - WORKER_DEPLOYMENT_VERSION_STATUS_RAMPING: The Worker Deployment Version is the ramping version of the Worker Deployment. A subset of new Pinned workflow executions are \nrouted to this version. Moreover, a portion of existing unversioned or AutoUpgrade workflow executions are also routed to this version.\n - WORKER_DEPLOYMENT_VERSION_STATUS_DRAINING: The Worker Deployment Version is not used by new workflows but is still used by\nopen pinned workflows. The version cannot be decommissioned safely.\n - WORKER_DEPLOYMENT_VERSION_STATUS_DRAINED: The Worker Deployment Version is not used by new or open workflows, but might be still needed by\nQueries sent to closed workflows. The version can be decommissioned safely if user does\nnot query closed workflows. If the user does query closed workflows for some time x after\nworkflows are closed, they should decommission the version after it has been drained for that duration."
+    },
+    "v1WorkerHeartbeat": {
+      "type": "object",
+      "properties": {
+        "workerInstanceKey": {
+          "type": "string",
+          "description": "Worker identifier, should be unique for the namespace.\nIt is distinct from worker identity, which is not necessarily namespace-unique."
+        },
+        "workerIdentity": {
+          "type": "string",
+          "description": "Worker identity, set by the client, may not be unique.\nUsually host_name+(user group name)+process_id, but can be overwritten by the user."
+        },
+        "hostInfo": {
+          "$ref": "#/definitions/v1WorkerHostInfo",
+          "description": "Worker host information."
+        },
+        "taskQueue": {
+          "type": "string",
+          "description": "Task queue this worker is polling for tasks."
+        },
+        "deploymentVersion": {
+          "$ref": "#/definitions/v1WorkerDeploymentVersion"
+        },
+        "sdkName": {
+          "type": "string"
+        },
+        "sdkVersion": {
+          "type": "string"
+        },
+        "status": {
+          "$ref": "#/definitions/v1WorkerStatus",
+          "description": "Worker status. Defined by SDK."
+        },
+        "startTime": {
+          "type": "string",
+          "format": "date-time",
+          "title": "Worker start time.\nIt can be used to determine worker uptime. (current time - start time)"
+        },
+        "heartbeatTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp of this heartbeat, coming from the worker. Worker should set it to \"now\".\nNote that this timestamp comes directly from the worker and is subject to workers' clock skew."
+        },
+        "elapsedSinceLastHeartbeat": {
+          "type": "string",
+          "description": "Elapsed time since the last heartbeat from the worker."
+        },
+        "workflowTaskSlotsInfo": {
+          "$ref": "#/definitions/v1WorkerSlotsInfo"
+        },
+        "activityTaskSlotsInfo": {
+          "$ref": "#/definitions/v1WorkerSlotsInfo"
+        },
+        "nexusTaskSlotsInfo": {
+          "$ref": "#/definitions/v1WorkerSlotsInfo"
+        },
+        "localActivitySlotsInfo": {
+          "$ref": "#/definitions/v1WorkerSlotsInfo"
+        },
+        "workflowPollerInfo": {
+          "$ref": "#/definitions/v1WorkerPollerInfo"
+        },
+        "workflowStickyPollerInfo": {
+          "$ref": "#/definitions/v1WorkerPollerInfo"
+        },
+        "activityPollerInfo": {
+          "$ref": "#/definitions/v1WorkerPollerInfo"
+        },
+        "nexusPollerInfo": {
+          "$ref": "#/definitions/v1WorkerPollerInfo"
+        },
+        "totalStickyCacheHit": {
+          "type": "integer",
+          "format": "int32",
+          "description": "A Workflow Task found a cached Workflow Execution to run against."
+        },
+        "totalStickyCacheMiss": {
+          "type": "integer",
+          "format": "int32",
+          "description": "A Workflow Task did not find a cached Workflow execution to run against."
+        },
+        "currentStickyCacheSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Current cache size, expressed in number of Workflow Executions."
+        }
+      },
+      "description": "Worker info message, contains information about the worker and its current state.\nAll information is provided by the worker itself."
+    },
+    "v1WorkerHostInfo": {
+      "type": "object",
+      "properties": {
+        "hostName": {
+          "type": "string",
+          "description": "Worker host identifier."
+        },
+        "processKey": {
+          "type": "string",
+          "title": "Worker process identifier. This id should be unique for all _processes_\nrunning workers in the namespace, and should be shared by all workers\nin the same process.\nThis will be used to build the worker command nexus task queue name:\n\"temporal-sys/worker-commands/{process_key}\""
+        },
+        "processId": {
+          "type": "string",
+          "description": "Worker process identifier. Unlike process_key, this id only needs to be unique\nwithin one host (so using e.g. a unix pid would be appropriate)."
+        },
+        "currentHostCpuUsage": {
+          "type": "number",
+          "format": "float",
+          "description": "System used CPU as a float in the range [0.0, 1.0] where 1.0 is defined as all\ncores on the host pegged."
+        },
+        "currentHostMemUsage": {
+          "type": "number",
+          "format": "float",
+          "description": "System used memory as a float in the range [0.0, 1.0] where 1.0 is defined as\nall available memory on the host is used."
+        }
+      },
+      "title": "Holds everything needed to identify the worker host/process context"
+    },
+    "v1WorkerInfo": {
+      "type": "object",
+      "properties": {
+        "workerHeartbeat": {
+          "$ref": "#/definitions/v1WorkerHeartbeat"
+        }
+      }
+    },
+    "v1WorkerPollerInfo": {
+      "type": "object",
+      "properties": {
+        "currentPollers": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of polling RPCs that are currently in flight."
+        },
+        "lastSuccessfulPollTime": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "isAutoscaling": {
+          "type": "boolean",
+          "title": "Set true if the number of concurrent pollers is auto-scaled"
+        }
+      }
+    },
+    "v1WorkerSlotsInfo": {
+      "type": "object",
+      "properties": {
+        "currentAvailableSlots": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of slots available for the worker to specific tasks.\nMay be -1 if the upper bound is not known."
+        },
+        "currentUsedSlots": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of slots used by the worker for specific tasks."
+        },
+        "slotSupplierKind": {
+          "type": "string",
+          "title": "Kind of the slot supplier, which is used to determine how the slots are allocated.\nPossible values: \"Fixed | ResourceBased | Custom String\""
+        },
+        "totalProcessedTasks": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Total number of tasks processed (completed both successfully and unsuccesfully, or any other way)\nby the worker since the worker started. This is a cumulative counter."
+        },
+        "totalFailedTasks": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Total number of failed tasks processed by the worker so far."
+        },
+        "lastIntervalProcessedTasks": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of tasks processed in since the last heartbeat from the worker.\nThis is a cumulative counter, and it is reset to 0 each time the worker sends a heartbeat.\nContains both successful and failed tasks."
+        },
+        "lastIntervalFailureTasks": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of failed tasks processed since the last heartbeat from the worker."
+        }
+      }
+    },
+    "v1WorkerStatus": {
+      "type": "string",
+      "enum": [
+        "WORKER_STATUS_UNSPECIFIED",
+        "WORKER_STATUS_RUNNING",
+        "WORKER_STATUS_SHUTTING_DOWN",
+        "WORKER_STATUS_SHUTDOWN"
+      ],
+      "default": "WORKER_STATUS_UNSPECIFIED"
+    },
     "v1WorkerVersionCapabilities": {
       "type": "object",
       "properties": {
@@ -15146,7 +15692,7 @@
         },
         "inheritBuildId": {
           "type": "boolean",
-          "description": "If this is set, the new execution inherits the Build ID of the current execution. Otherwise,\nthe assignment rules will be used to independently assign a Build ID to the new execution."
+          "description": "If this is set, the new execution inherits the Build ID of the current execution. Otherwise,\nthe assignment rules will be used to independently assign a Build ID to the new execution.\nDeprecated. Only considered for versioning v0.2."
         }
       }
     },
@@ -15367,11 +15913,11 @@
         },
         "header": {
           "$ref": "#/definitions/v1Header",
-          "description": "Headers that were passed by the sender of the signal and copied by temporal \nserver into the workflow task."
+          "description": "Headers that were passed by the sender of the signal and copied by temporal\nserver into the workflow task."
         },
         "skipGenerateWorkflowTask": {
           "type": "boolean",
-          "description": "This field is deprecated and never respected. It should always be set to false."
+          "description": "Deprecated. This field is never respected and should always be set to false."
         },
         "externalWorkflowExecution": {
           "$ref": "#/definitions/v1WorkflowExecution",
@@ -15422,7 +15968,7 @@
         },
         "continuedExecutionRunId": {
           "type": "string",
-          "description": "Run id of the previous workflow which continued-as-new or retired or cron executed into this\nworkflow."
+          "description": "Run id of the previous workflow which continued-as-new or retried or cron executed into this\nworkflow."
         },
         "initiator": {
           "$ref": "#/definitions/v1ContinueAsNewInitiator"
@@ -15509,19 +16055,19 @@
         },
         "versioningOverride": {
           "$ref": "#/definitions/v1VersioningOverride",
-          "description": "Versioning override applied to this workflow when it was started."
+          "description": "Versioning override applied to this workflow when it was started.\nChildren, crons, retries, and continue-as-new will inherit source run's override if pinned\nand if the new workflow's Task Queue belongs to the override version."
         },
         "parentPinnedWorkerDeploymentVersion": {
           "type": "string",
-          "description": "When present, it means this is a child workflow of a parent that is Pinned to this Worker\nDeployment Version. In this case, child workflow will start as Pinned to this Version instead\nof starting on the Current Version of its Task Queue.\nThis is set only if the child workflow is starting on a Task Queue belonging to the same\nWorker Deployment Version.\nDeprecated. Use `parent_pinned_deployment_version`."
-        },
-        "parentPinnedDeploymentVersion": {
-          "$ref": "#/definitions/v1WorkerDeploymentVersion",
-          "description": "When present, it means this is a child workflow of a parent that is Pinned to this Worker\nDeployment Version. In this case, child workflow will start as Pinned to this Version instead\nof starting on the Current Version of its Task Queue.\nThis is set only if the child workflow is starting on a Task Queue belonging to the same\nWorker Deployment Version."
+          "description": "When present, it means this is a child workflow of a parent that is Pinned to this Worker\nDeployment Version. In this case, child workflow will start as Pinned to this Version instead\nof starting on the Current Version of its Task Queue.\nThis is set only if the child workflow is starting on a Task Queue belonging to the same\nWorker Deployment Version.\nDeprecated. Use `parent_versioning_info`."
         },
         "priority": {
           "$ref": "#/definitions/v1Priority",
           "title": "Priority metadata"
+        },
+        "inheritedPinnedVersion": {
+          "$ref": "#/definitions/v1WorkerDeploymentVersion",
+          "description": "If present, the new workflow should start on this version with pinned base behavior.\nChild of pinned parent will inherit the parent's version if the Child's Task Queue belongs to that version.\n\nNew run initiated by workflow ContinueAsNew of pinned run, will inherit the previous run's version if the\nnew run's Task Queue belongs to that version.\n\nNew run initiated by workflow Cron will never inherit.\n\nNew run initiated by workflow Retry will only inherit if the retried run is effectively pinned at the time\nof retry, and the retried run inherited a pinned version when it started (ie. it is a child of a pinned\nparent, or a CaN of a pinned run, and is running on a Task Queue in the inherited version).\n\nPinned override is inherited if Task Queue of new run is compatible with the override version.\nOverride is inherited separately and takes precedence over inherited base version."
         }
       },
       "title": "Always the first event in workflow history"
@@ -15653,7 +16199,7 @@
       "properties": {
         "behavior": {
           "$ref": "#/definitions/v1VersioningBehavior",
-          "description": "Versioning behavior determines how the server should treat this execution when workers are\nupgraded. When present it means this workflow execution is versioned; UNSPECIFIED means\nunversioned. See the comments in `VersioningBehavior` enum for more info about different\nbehaviors.\nThis field is first set after an execution completes its first workflow task on a versioned\nworker, and set again on completion of every subsequent workflow task.\nFor child workflows of Pinned parents, this will be set to Pinned (along with `version`) when\nthe the child starts so that child's first workflow task goes to the same Version as the\nparent. After the first workflow task, it depends on the child workflow itself if it wants\nto stay pinned or become unpinned (according to Versioning Behavior set in the worker).\nNote that `behavior` is overridden by `versioning_override` if the latter is present."
+          "description": "Versioning behavior determines how the server should treat this execution when workers are\nupgraded. When present it means this workflow execution is versioned; UNSPECIFIED means\nunversioned. See the comments in `VersioningBehavior` enum for more info about different\nbehaviors.\nThis field is first set after an execution completes its first workflow task on a versioned\nworker, and set again on completion of every subsequent workflow task.\nFor child workflows of Pinned parents, this will be set to Pinned (along with `deployment_version`) when\nthe the child starts so that child's first workflow task goes to the same Version as the\nparent. After the first workflow task, it depends on the child workflow itself if it wants\nto stay pinned or become unpinned (according to Versioning Behavior set in the worker).\nNote that `behavior` is overridden by `versioning_override` if the latter is present."
         },
         "deployment": {
           "$ref": "#/definitions/v1Deployment",
@@ -15669,7 +16215,7 @@
         },
         "versioningOverride": {
           "$ref": "#/definitions/v1VersioningOverride",
-          "description": "Present if user has set an execution-specific versioning override. This override takes\nprecedence over SDK-sent `behavior` (and `version` when override is PINNED). An\noverride can be set when starting a new execution, as well as afterwards by calling the\n`UpdateWorkflowExecutionOptions` API.\nPinned overrides are automatically inherited by child workflows."
+          "description": "Present if user has set an execution-specific versioning override. This override takes\nprecedence over SDK-sent `behavior` (and `version` when override is PINNED). An\noverride can be set when starting a new execution, as well as afterwards by calling the\n`UpdateWorkflowExecutionOptions` API.\nPinned overrides are automatically inherited by child workflows, continue-as-new workflows,\nworkflow retries, and cron workflows."
         },
         "deploymentTransition": {
           "$ref": "#/definitions/v1DeploymentTransition",
@@ -15677,7 +16223,7 @@
         },
         "versionTransition": {
           "$ref": "#/definitions/v1DeploymentVersionTransition",
-          "description": "When present, indicates the workflow is transitioning to a different deployment version\n(which may belong to the same deployment name or another). Can indicate one of the following\ntransitions: unversioned -> versioned, versioned -> versioned\non a different deployment version, or versioned -> unversioned.\nNot applicable to workflows with PINNED behavior.\nWhen a workflow with AUTO_UPGRADE behavior creates a new workflow task, it will automatically\nstart a transition to the task queue's current version if the task queue's current version is\ndifferent from the workflow's current deployment version.\nIf the AUTO_UPGRADE workflow is stuck due to backlogged activity or workflow tasks, those\ntasks will be redirected to the task queue's current version. As soon as a poller from\nthat deployment version is available to receive the task, the workflow will automatically\nstart a transition to that version and continue execution there.\nA version transition can only exist while there is a pending or started workflow task.\nOnce the pending workflow task completes on the transition's target version, the\ntransition completes and the workflow's `behavior`, and `version` fields are updated per the\nworker's task completion response.\nPending activities will not start new attempts during a transition. Once the transition is\ncompleted, pending activities will start their next attempt on the new version."
+          "description": "When present, indicates the workflow is transitioning to a different deployment version\n(which may belong to the same deployment name or another). Can indicate one of the following\ntransitions: unversioned -> versioned, versioned -> versioned\non a different deployment version, or versioned -> unversioned.\nNot applicable to workflows with PINNED behavior.\nWhen a workflow with AUTO_UPGRADE behavior creates a new workflow task, it will automatically\nstart a transition to the task queue's current version if the task queue's current version is\ndifferent from the workflow's current deployment version.\nIf the AUTO_UPGRADE workflow is stuck due to backlogged activity or workflow tasks, those\ntasks will be redirected to the task queue's current version. As soon as a poller from\nthat deployment version is available to receive the task, the workflow will automatically\nstart a transition to that version and continue execution there.\nA version transition can only exist while there is a pending or started workflow task.\nOnce the pending workflow task completes on the transition's target version, the\ntransition completes and the workflow's `behavior`, and `deployment_version` fields are updated per the\nworker's task completion response.\nPending activities will not start new attempts during a transition. Once the transition is\ncompleted, pending activities will start their next attempt on the new version."
         }
       },
       "description": "Holds all the information about worker versioning for a particular workflow execution.\nExperimental. Versioning info is experimental and might change in the future."
@@ -15968,10 +16514,11 @@
         "WORKFLOW_TASK_FAILED_CAUSE_BAD_SCHEDULE_NEXUS_OPERATION_ATTRIBUTES",
         "WORKFLOW_TASK_FAILED_CAUSE_PENDING_NEXUS_OPERATIONS_LIMIT_EXCEEDED",
         "WORKFLOW_TASK_FAILED_CAUSE_BAD_REQUEST_CANCEL_NEXUS_OPERATION_ATTRIBUTES",
-        "WORKFLOW_TASK_FAILED_CAUSE_FEATURE_DISABLED"
+        "WORKFLOW_TASK_FAILED_CAUSE_FEATURE_DISABLED",
+        "WORKFLOW_TASK_FAILED_CAUSE_GRPC_MESSAGE_TOO_LARGE"
       ],
       "default": "WORKFLOW_TASK_FAILED_CAUSE_UNSPECIFIED",
-      "description": "Workflow tasks can fail for various reasons. Note that some of these reasons can only originate\nfrom the server, and some of them can only originate from the SDK/worker.\n\n - WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_COMMAND: Between starting and completing the workflow task (with a workflow completion command), some\nnew command (like a signal) was processed into workflow history. The outstanding task will be\nfailed with this reason, and a worker must pick up a new task.\n - WORKFLOW_TASK_FAILED_CAUSE_RESET_STICKY_TASK_QUEUE: The worker wishes to fail the task and have the next one be generated on a normal, not sticky\nqueue. Generally workers should prefer to use the explicit `ResetStickyTaskQueue` RPC call.\n - WORKFLOW_TASK_FAILED_CAUSE_NON_DETERMINISTIC_ERROR: The worker encountered a mismatch while replaying history between what was expected, and\nwhat the workflow code actually did.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_CHILD_WORKFLOWS_LIMIT_EXCEEDED: We send the below error codes to users when their requests would violate a size constraint\nof their workflow. We do this to ensure that the state of their workflow does not become too\nlarge because that can cause severe performance degradation. You can modify the thresholds for\neach of these errors within your dynamic config.\n\nSpawning a new child workflow would cause this workflow to exceed its limit of pending child\nworkflows.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_ACTIVITIES_LIMIT_EXCEEDED: Starting a new activity would cause this workflow to exceed its limit of pending activities\nthat we track.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_SIGNALS_LIMIT_EXCEEDED: A workflow has a buffer of signals that have not yet reached their destination. We return this\nerror when sending a new signal would exceed the capacity of this buffer.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_REQUEST_CANCEL_LIMIT_EXCEEDED: Similarly, we have a buffer of pending requests to cancel other workflows. We return this error\nwhen our capacity for pending cancel requests is already reached.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_UPDATE_WORKFLOW_EXECUTION_MESSAGE: Workflow execution update message (update.Acceptance, update.Rejection, or update.Response)\nhas wrong format, or missing required fields.\n - WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_UPDATE: Similar to WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_COMMAND, but for updates.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_SCHEDULE_NEXUS_OPERATION_ATTRIBUTES: A workflow task completed with an invalid ScheduleNexusOperation command.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_NEXUS_OPERATIONS_LIMIT_EXCEEDED: A workflow task completed requesting to schedule a Nexus Operation exceeding the server configured limit.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_REQUEST_CANCEL_NEXUS_OPERATION_ATTRIBUTES: A workflow task completed with an invalid RequestCancelNexusOperation command.\n - WORKFLOW_TASK_FAILED_CAUSE_FEATURE_DISABLED: A workflow task completed requesting a feature that's disabled on the server (either system wide or - typically -\nfor the workflow's namespace).\nCheck the workflow task failure message for more information."
+      "description": "Workflow tasks can fail for various reasons. Note that some of these reasons can only originate\nfrom the server, and some of them can only originate from the SDK/worker.\n\n - WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_COMMAND: Between starting and completing the workflow task (with a workflow completion command), some\nnew command (like a signal) was processed into workflow history. The outstanding task will be\nfailed with this reason, and a worker must pick up a new task.\n - WORKFLOW_TASK_FAILED_CAUSE_RESET_STICKY_TASK_QUEUE: The worker wishes to fail the task and have the next one be generated on a normal, not sticky\nqueue. Generally workers should prefer to use the explicit `ResetStickyTaskQueue` RPC call.\n - WORKFLOW_TASK_FAILED_CAUSE_NON_DETERMINISTIC_ERROR: The worker encountered a mismatch while replaying history between what was expected, and\nwhat the workflow code actually did.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_CHILD_WORKFLOWS_LIMIT_EXCEEDED: We send the below error codes to users when their requests would violate a size constraint\nof their workflow. We do this to ensure that the state of their workflow does not become too\nlarge because that can cause severe performance degradation. You can modify the thresholds for\neach of these errors within your dynamic config.\n\nSpawning a new child workflow would cause this workflow to exceed its limit of pending child\nworkflows.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_ACTIVITIES_LIMIT_EXCEEDED: Starting a new activity would cause this workflow to exceed its limit of pending activities\nthat we track.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_SIGNALS_LIMIT_EXCEEDED: A workflow has a buffer of signals that have not yet reached their destination. We return this\nerror when sending a new signal would exceed the capacity of this buffer.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_REQUEST_CANCEL_LIMIT_EXCEEDED: Similarly, we have a buffer of pending requests to cancel other workflows. We return this error\nwhen our capacity for pending cancel requests is already reached.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_UPDATE_WORKFLOW_EXECUTION_MESSAGE: Workflow execution update message (update.Acceptance, update.Rejection, or update.Response)\nhas wrong format, or missing required fields.\n - WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_UPDATE: Similar to WORKFLOW_TASK_FAILED_CAUSE_UNHANDLED_COMMAND, but for updates.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_SCHEDULE_NEXUS_OPERATION_ATTRIBUTES: A workflow task completed with an invalid ScheduleNexusOperation command.\n - WORKFLOW_TASK_FAILED_CAUSE_PENDING_NEXUS_OPERATIONS_LIMIT_EXCEEDED: A workflow task completed requesting to schedule a Nexus Operation exceeding the server configured limit.\n - WORKFLOW_TASK_FAILED_CAUSE_BAD_REQUEST_CANCEL_NEXUS_OPERATION_ATTRIBUTES: A workflow task completed with an invalid RequestCancelNexusOperation command.\n - WORKFLOW_TASK_FAILED_CAUSE_FEATURE_DISABLED: A workflow task completed requesting a feature that's disabled on the server (either system wide or - typically -\nfor the workflow's namespace).\nCheck the workflow task failure message for more information.\n - WORKFLOW_TASK_FAILED_CAUSE_GRPC_MESSAGE_TOO_LARGE: A workflow task failed because a grpc message was too large."
     },
     "v1WorkflowTaskFailedEventAttributes": {
       "type": "object",
@@ -16012,7 +16559,7 @@
         },
         "binaryChecksum": {
           "type": "string",
-          "title": "DEPRECATED since 1.21 - This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]\nIf a worker explicitly failed this task, its binary id"
+          "title": "Deprecated. This field should be cleaned up when versioning-2 API is removed. [cleanup-experimental-wv]\nIf a worker explicitly failed this task, its binary id"
         },
         "workerVersion": {
           "$ref": "#/definitions/v1WorkerVersionStamp",