npm - @temporalio/core-bridge - Versions diffs - 1.11.2 → 1.11.4 - Mend

@temporalio/core-bridge 1.11.2 → 1.11.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (119) hide show

package/sdk-core/sdk-core-protos/protos/api_upstream/openapi/openapiv3.yaml CHANGED Viewed

@@ -6,7 +6,7 @@ info:
   title: ""
   version: 0.0.1
 paths:
-  /cluster-info:
+  /api/v1/cluster-info:
     get:
       tags:
         - WorkflowService
@@ -25,7 +25,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces:
+  /api/v1/namespaces:
     get:
       tags:
         - WorkflowService
@@ -93,7 +93,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}:
+  /api/v1/namespaces/{namespace}:
     get:
       tags:
         - WorkflowService
@@ -122,7 +122,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/cancel:
+  /api/v1/namespaces/{namespace}/activities/cancel:
     post:
       tags:
         - WorkflowService
@@ -158,7 +158,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/cancel-by-id:
+  /api/v1/namespaces/{namespace}/activities/cancel-by-id:
     post:
       tags:
         - WorkflowService
@@ -195,7 +195,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/complete:
+  /api/v1/namespaces/{namespace}/activities/complete:
     post:
       tags:
         - WorkflowService
@@ -232,7 +232,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/complete-by-id:
+  /api/v1/namespaces/{namespace}/activities/complete-by-id:
     post:
       tags:
         - WorkflowService
@@ -269,7 +269,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/fail:
+  /api/v1/namespaces/{namespace}/activities/fail:
     post:
       tags:
         - WorkflowService
@@ -305,7 +305,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/fail-by-id:
+  /api/v1/namespaces/{namespace}/activities/fail-by-id:
     post:
       tags:
         - WorkflowService
@@ -342,7 +342,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/heartbeat:
+  /api/v1/namespaces/{namespace}/activities/heartbeat:
     post:
       tags:
         - WorkflowService
@@ -379,7 +379,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/heartbeat-by-id:
+  /api/v1/namespaces/{namespace}/activities/heartbeat-by-id:
     post:
       tags:
         - WorkflowService
@@ -416,7 +416,179 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/archived-workflows:
+  /api/v1/namespaces/{namespace}/activities/pause-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        PauseActivityById pauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         Pausing an activity means:
+         - If the activity is currently waiting for a retry or is running and subsequently fails,
+           it will not be rescheduled until it is unpaused.
+         - If the activity is already paused, calling this method will have no effect.
+         - If the activity is running and finishes successfully, the activity will be completed.
+         - If the activity is running and finishes with failure:
+           * if there is no retry left - the activity will be completed.
+           * if there are more retries left - the activity will be paused.
+         For long-running activities:
+         - activities in paused state will send a cancellation with "activity_paused" set to 'true' in response to 'RecordActivityTaskHeartbeat'.
+         - The activity should respond to the cancellation accordingly.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: PauseActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PauseActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PauseActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/activities/reset-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        ResetActivityById unpauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         Resetting an activity means:
+         * number of attempts will be reset to 0.
+         * activity timeouts will be resetted.
+         If the activity currently running:
+         *  if 'no_wait' flag is provided, a new instance of the activity will be scheduled immediately.
+         *  if 'no_wait' flag is not provided, a new instance of the  activity will be scheduled after current instance completes if needed.
+         If 'reset_heartbeats' flag is set, the activity heartbeat timer and heartbeats will be reset.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: ResetActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ResetActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ResetActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/activities/unpause-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        UnpauseActivityById unpauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         There are two 'modes' of unpausing an activity:
+         'resume' - If the activity is paused, it will be resumed and scheduled for execution.
+            * If the activity is currently running Unpause with 'resume' has no effect.
+            * if 'no_wait' flag is set and the activity is waiting, the activity will be scheduled immediately.
+         'reset' - If the activity is paused, it will be reset to its initial state and (depending on parameters) scheduled for execution.
+            * If the activity is currently running, Unpause with 'reset' will reset the number of attempts.
+            * if 'no_wait' flag is set, the activity will be scheduled immediately.
+            * if 'reset_heartbeats' flag is set, the activity heartbeat timer and heartbeats will be reset.
+         If the activity is in waiting for retry and past it retry timeout, it will be scheduled immediately.
+         Once the activity is unpaused, all timeout timers will be regenerated.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: UnpauseActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UnpauseActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnpauseActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/activities/update-options-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        UpdateActivityOptionsById is called by the client to update the options of an activity
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: UpdateActivityOptionsById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateActivityOptionsByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateActivityOptionsByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/archived-workflows:
     get:
       tags:
         - WorkflowService
@@ -455,7 +627,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/batch-operations:
+  /api/v1/namespaces/{namespace}/batch-operations:
     get:
       tags:
         - WorkflowService
@@ -493,7 +665,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/batch-operations/{jobId}:
+  /api/v1/namespaces/{namespace}/batch-operations/{jobId}:
     get:
       tags:
         - WorkflowService
@@ -562,7 +734,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/batch-operations/{jobId}/stop:
+  /api/v1/namespaces/{namespace}/batch-operations/{jobId}/stop:
     post:
       tags:
         - WorkflowService
@@ -600,7 +772,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/schedules:
+  /api/v1/namespaces/{namespace}/schedules:
     get:
       tags:
         - WorkflowService
@@ -643,7 +815,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/schedules/{scheduleId}:
+  /api/v1/namespaces/{namespace}/schedules/{scheduleId}:
     get:
       tags:
         - WorkflowService
@@ -748,7 +920,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/schedules/{scheduleId}/matching-times:
+  /api/v1/namespaces/{namespace}/schedules/{scheduleId}/matching-times:
     get:
       tags:
         - WorkflowService
@@ -791,7 +963,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/schedules/{scheduleId}/patch:
+  /api/v1/namespaces/{namespace}/schedules/{scheduleId}/patch:
     post:
       tags:
         - WorkflowService
@@ -829,7 +1001,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/schedules/{scheduleId}/update:
+  /api/v1/namespaces/{namespace}/schedules/{scheduleId}/update:
     post:
       tags:
         - WorkflowService
@@ -867,7 +1039,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/search-attributes:
+  /api/v1/namespaces/{namespace}/search-attributes:
     get:
       tags:
         - OperatorService
@@ -892,7 +1064,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/task-queues/{taskQueue}/worker-build-id-compatibility:
+  /api/v1/namespaces/{namespace}/task-queues/{taskQueue}/worker-build-id-compatibility:
     get:
       tags:
         - WorkflowService
@@ -933,7 +1105,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/task-queues/{taskQueue}/worker-versioning-rules:
+  /api/v1/namespaces/{namespace}/task-queues/{taskQueue}/worker-versioning-rules:
     get:
       tags:
         - WorkflowService
@@ -965,7 +1137,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/task-queues/{task_queue.name}:
+  /api/v1/namespaces/{namespace}/task-queues/{task_queue.name}:
     get:
       tags:
         - WorkflowService
@@ -1049,8 +1221,8 @@ paths:
         - name: versions.allActive
           in: query
           description: |-
-            Include all active versions. A version is considered active if it has had new
-             tasks or polls recently.
+            Include all active versions. A version is considered active if, in the last few minutes,
+             it has had new tasks or polls, or it has been the subject of certain task queue API calls.
           schema:
             type: boolean
         - name: taskQueueTypes
@@ -1096,7 +1268,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/update:
+  /api/v1/namespaces/{namespace}/update:
     post:
       tags:
         - WorkflowService
@@ -1129,7 +1301,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/worker-task-reachability:
+  /api/v1/namespaces/{namespace}/worker-task-reachability:
     get:
       tags:
         - WorkflowService
@@ -1209,7 +1381,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflow-count:
+  /api/v1/namespaces/{namespace}/workflow-count:
     get:
       tags:
         - WorkflowService
@@ -1238,7 +1410,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows:
+  /api/v1/namespaces/{namespace}/workflows:
     get:
       tags:
         - WorkflowService
@@ -1277,7 +1449,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/execute-multi-operation:
+  /api/v1/namespaces/{namespace}/workflows/execute-multi-operation:
     post:
       tags:
         - WorkflowService
@@ -1317,7 +1489,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{execution.workflow_id}:
+  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}:
     get:
       tags:
         - WorkflowService
@@ -1355,7 +1527,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{execution.workflow_id}/history:
+  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/history:
     get:
       tags:
         - WorkflowService
@@ -1431,7 +1603,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{execution.workflow_id}/history-reverse:
+  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/history-reverse:
     get:
       tags:
         - WorkflowService
@@ -1479,7 +1651,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{execution.workflow_id}/query/{query.query_type}:
+  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/query/{query.query_type}:
     post:
       tags:
         - WorkflowService
@@ -1520,7 +1692,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflowId}:
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}:
     post:
       tags:
         - WorkflowService
@@ -1561,7 +1733,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflowId}/signal-with-start/{signalName}:
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/signal-with-start/{signalName}:
     post:
       tags:
         - WorkflowService
@@ -1615,7 +1787,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/cancel:
+  /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/cancel:
     post:
       tags:
         - WorkflowService
@@ -1657,7 +1829,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/reset:
+  /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/reset:
     post:
       tags:
         - WorkflowService
@@ -1697,7 +1869,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/signal/{signalName}:
+  /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/signal/{signalName}:
     post:
       tags:
         - WorkflowService
@@ -1743,7 +1915,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/terminate:
+  /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/terminate:
     post:
       tags:
         - WorkflowService
@@ -1782,16 +1954,16 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/update/{request.input.name}:
+  /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/update/{request.input.name}:
     post:
       tags:
         - WorkflowService
-      description: Invokes the specified update function on user workflow code.
+      description: Invokes the specified Update function on user Workflow code.
       operationId: UpdateWorkflowExecution
       parameters:
         - name: namespace
           in: path
-          description: The namespace name of the target workflow
+          description: The namespace name of the target Workflow.
           required: true
           schema:
             type: string
@@ -1824,7 +1996,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /nexus/endpoints:
+  /api/v1/nexus/endpoints:
     get:
       tags:
         - OperatorService
@@ -1897,7 +2069,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /nexus/endpoints/{id}:
+  /api/v1/nexus/endpoints/{id}:
     get:
       tags:
         - OperatorService
@@ -1953,7 +2125,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /nexus/endpoints/{id}/update:
+  /api/v1/nexus/endpoints/{id}/update:
     post:
       tags:
         - OperatorService
@@ -1990,7 +2162,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /system-info:
+  /api/v1/system-info:
     get:
       tags:
         - WorkflowService
@@ -2009,33 +2181,2249 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-components:
-  schemas:
-    ActivityFailureInfo:
-      type: object
-      properties:
-        scheduledEventId:
-          type: string
-        startedEventId:
-          type: string
-        identity:
-          type: string
-        activityType:
-          $ref: '#/components/schemas/ActivityType'
-        activityId:
-          type: string
-        retryState:
-          enum:
-            - RETRY_STATE_UNSPECIFIED
-            - RETRY_STATE_IN_PROGRESS
-            - RETRY_STATE_NON_RETRYABLE_FAILURE
-            - RETRY_STATE_TIMEOUT
-            - RETRY_STATE_MAXIMUM_ATTEMPTS_REACHED
-            - RETRY_STATE_RETRY_POLICY_NOT_SET
-            - RETRY_STATE_INTERNAL_SERVER_ERROR
-            - RETRY_STATE_CANCEL_REQUESTED
-          type: string
-          format: enum
+  /cluster:
+    get:
+      tags:
+        - WorkflowService
+      description: GetClusterInfo returns information about temporal cluster
+      operationId: GetClusterInfo
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetClusterInfoResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/namespaces:
+    get:
+      tags:
+        - WorkflowService
+      description: ListNamespaces returns the information and configuration for all namespaces.
+      operationId: ListNamespaces
+      parameters:
+        - name: pageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          schema:
+            type: string
+            format: bytes
+        - name: namespaceFilter.includeDeleted
+          in: query
+          description: |-
+            By default namespaces in NAMESPACE_STATE_DELETED state are not included.
+             Setting include_deleted to true will include deleted namespaces.
+             Note: Namespace is in NAMESPACE_STATE_DELETED state when it was deleted from the system but associated data is not deleted yet.
+          schema:
+            type: boolean
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListNamespacesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RegisterNamespace creates a new namespace which can be used as a container for all resources.
+         A Namespace is a top level entity within Temporal, and is used as a container for resources
+         like workflow executions, task queues, etc. A Namespace acts as a sandbox and provides
+         isolation for all resources within the namespace. All resources belongs to exactly one
+         namespace.
+      operationId: RegisterNamespace
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RegisterNamespaceRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RegisterNamespaceResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/namespaces/{namespace}:
+    get:
+      tags:
+        - WorkflowService
+      description: DescribeNamespace returns the information and configuration for a registered namespace.
+      operationId: DescribeNamespace
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: id
+          in: query
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DescribeNamespaceResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/namespaces/{namespace}/search-attributes:
+    get:
+      tags:
+        - OperatorService
+      description: ListSearchAttributes returns comprehensive information about search attributes.
+      operationId: ListSearchAttributes
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListSearchAttributesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/namespaces/{namespace}/update:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        UpdateNamespace is used to update the information and configuration of a registered
+         namespace.
+      operationId: UpdateNamespace
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateNamespaceRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateNamespaceResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/nexus/endpoints:
+    get:
+      tags:
+        - OperatorService
+      description: |-
+        List all Nexus endpoints for the cluster, sorted by ID in ascending order. Set page_token in the request to the
+         next_page_token field of the previous response to get the next page of results. An empty next_page_token
+         indicates that there are no more results. During pagination, a newly added service with an ID lexicographically
+         earlier than the previous page's last endpoint's ID may be missed.
+      operationId: ListNexusEndpoints
+      parameters:
+        - name: pageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          description: |-
+            To get the next page, pass in `ListNexusEndpointsResponse.next_page_token` from the previous page's
+             response, the token will be empty if there's no other page.
+             Note: the last page may be empty if the total number of endpoints registered is a multiple of the page size.
+          schema:
+            type: string
+            format: bytes
+        - name: name
+          in: query
+          description: |-
+            Name of the incoming endpoint to filter on - optional. Specifying this will result in zero or one results.
+             (-- api-linter: core::203::field-behavior-required=disabled
+                 aip.dev/not-precedent: Not following linter rules. --)
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListNexusEndpointsResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    post:
+      tags:
+        - OperatorService
+      description: |-
+        Create a Nexus endpoint. This will fail if an endpoint with the same name is already registered with a status of
+         ALREADY_EXISTS.
+         Returns the created endpoint with its initial version. You may use this version for subsequent updates.
+      operationId: CreateNexusEndpoint
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateNexusEndpointRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CreateNexusEndpointResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/nexus/endpoints/{id}:
+    get:
+      tags:
+        - OperatorService
+      description: Get a registered Nexus endpoint by ID. The returned version can be used for optimistic updates.
+      operationId: GetNexusEndpoint
+      parameters:
+        - name: id
+          in: path
+          description: Server-generated unique endpoint ID.
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetNexusEndpointResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    delete:
+      tags:
+        - OperatorService
+      description: Delete an incoming Nexus service by ID.
+      operationId: DeleteNexusEndpoint
+      parameters:
+        - name: id
+          in: path
+          description: Server-generated unique endpoint ID.
+          required: true
+          schema:
+            type: string
+        - name: version
+          in: query
+          description: Data version for this endpoint. Must match current version.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DeleteNexusEndpointResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /cluster/nexus/endpoints/{id}/update:
+    post:
+      tags:
+        - OperatorService
+      description: |-
+        Optimistically update a Nexus endpoint based on provided version as obtained via the `GetNexusEndpoint` or
+         `ListNexusEndpointResponse` APIs. This will fail with a status of FAILED_PRECONDITION if the version does not
+         match.
+         Returns the updated endpoint with its updated version. You may use this version for subsequent updates. You don't
+         need to increment the version yourself. The server will increment the version for you after each update.
+      operationId: UpdateNexusEndpoint
+      parameters:
+        - name: id
+          in: path
+          description: Server-generated unique endpoint ID.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateNexusEndpointRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateNexusEndpointResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/cancel:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+         This results in a new `ACTIVITY_TASK_CANCELED` event being written to the workflow history
+         and a new workflow task created for the workflow. Fails with `NotFound` if the task token is
+         no longer valid due to activity timeout, already being completed, or never having existed.
+      operationId: RespondActivityTaskCanceled
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskCanceledRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskCanceledResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/cancel-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RecordActivityTaskCanceled`. This version allows clients to record failures by
+         namespace/workflow id/activity id instead of task token.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: RespondActivityTaskCanceledById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/complete:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RespondActivityTaskCompleted is called by workers when they successfully complete an activity
+         task.
+         This results in a new `ACTIVITY_TASK_COMPLETED` event being written to the workflow history
+         and a new workflow task created for the workflow. Fails with `NotFound` if the task token is
+         no longer valid due to activity timeout, already being completed, or never having existed.
+      operationId: RespondActivityTaskCompleted
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskCompletedRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskCompletedResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/complete-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RecordActivityTaskCompleted`. This version allows clients to record completions by
+         namespace/workflow id/activity id instead of task token.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: RespondActivityTaskCompletedById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskCompletedByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskCompletedByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/fail:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+         This results in a new `ACTIVITY_TASK_FAILED` event being written to the workflow history and
+         a new workflow task created for the workflow. Fails with `NotFound` if the task token is no
+         longer valid due to activity timeout, already being completed, or never having existed.
+      operationId: RespondActivityTaskFailed
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskFailedRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskFailedResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/fail-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RecordActivityTaskFailed`. This version allows clients to record failures by
+         namespace/workflow id/activity id instead of task token.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: RespondActivityTaskFailedById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/heartbeat:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RecordActivityTaskHeartbeat is optionally called by workers while they execute activities.
+         If worker fails to heartbeat within the `heartbeat_timeout` interval for the activity task,
+         then it will be marked as timed out and an `ACTIVITY_TASK_TIMED_OUT` event will be written to
+         the workflow history. Calling `RecordActivityTaskHeartbeat` will fail with `NotFound` in
+         such situations, in that event, the SDK should request cancellation of the activity.
+      operationId: RecordActivityTaskHeartbeat
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/heartbeat-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RecordActivityTaskHeartbeat`. This version allows clients to record heartbeats by
+         namespace/workflow id/activity id instead of task token.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: RecordActivityTaskHeartbeatById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/pause-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        PauseActivityById pauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         Pausing an activity means:
+         - If the activity is currently waiting for a retry or is running and subsequently fails,
+           it will not be rescheduled until it is unpaused.
+         - If the activity is already paused, calling this method will have no effect.
+         - If the activity is running and finishes successfully, the activity will be completed.
+         - If the activity is running and finishes with failure:
+           * if there is no retry left - the activity will be completed.
+           * if there are more retries left - the activity will be paused.
+         For long-running activities:
+         - activities in paused state will send a cancellation with "activity_paused" set to 'true' in response to 'RecordActivityTaskHeartbeat'.
+         - The activity should respond to the cancellation accordingly.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: PauseActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PauseActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PauseActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/reset-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        ResetActivityById unpauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         Resetting an activity means:
+         * number of attempts will be reset to 0.
+         * activity timeouts will be resetted.
+         If the activity currently running:
+         *  if 'no_wait' flag is provided, a new instance of the activity will be scheduled immediately.
+         *  if 'no_wait' flag is not provided, a new instance of the  activity will be scheduled after current instance completes if needed.
+         If 'reset_heartbeats' flag is set, the activity heartbeat timer and heartbeats will be reset.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: ResetActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ResetActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ResetActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/unpause-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        UnpauseActivityById unpauses the execution of an activity specified by its ID.
+         Returns a `NotFound` error if there is no pending activity with the provided ID.
+         There are two 'modes' of unpausing an activity:
+         'resume' - If the activity is paused, it will be resumed and scheduled for execution.
+            * If the activity is currently running Unpause with 'resume' has no effect.
+            * if 'no_wait' flag is set and the activity is waiting, the activity will be scheduled immediately.
+         'reset' - If the activity is paused, it will be reset to its initial state and (depending on parameters) scheduled for execution.
+            * If the activity is currently running, Unpause with 'reset' will reset the number of attempts.
+            * if 'no_wait' flag is set, the activity will be scheduled immediately.
+            * if 'reset_heartbeats' flag is set, the activity heartbeat timer and heartbeats will be reset.
+         If the activity is in waiting for retry and past it retry timeout, it will be scheduled immediately.
+         Once the activity is unpaused, all timeout timers will be regenerated.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: UnpauseActivityById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UnpauseActivityByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnpauseActivityByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/update-options-by-id:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        UpdateActivityOptionsById is called by the client to update the options of an activity
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "By" is used to indicate request type. --)
+      operationId: UpdateActivityOptionsById
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateActivityOptionsByIdRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateActivityOptionsByIdResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/archived-workflows:
+    get:
+      tags:
+        - WorkflowService
+      description: ListArchivedWorkflowExecutions is a visibility API to list archived workflow executions in a specific namespace.
+      operationId: ListArchivedWorkflowExecutions
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: pageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          schema:
+            type: string
+            format: bytes
+        - name: query
+          in: query
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListArchivedWorkflowExecutionsResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/batch-operations:
+    get:
+      tags:
+        - WorkflowService
+      description: ListBatchOperations returns a list of batch operations
+      operationId: ListBatchOperations
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace that contains the batch operation
+          required: true
+          schema:
+            type: string
+        - name: pageSize
+          in: query
+          description: List page size
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          description: Next page token
+          schema:
+            type: string
+            format: bytes
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListBatchOperationsResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/batch-operations/{jobId}:
+    get:
+      tags:
+        - WorkflowService
+      description: DescribeBatchOperation returns the information about a batch operation
+      operationId: DescribeBatchOperation
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace that contains the batch operation
+          required: true
+          schema:
+            type: string
+        - name: jobId
+          in: path
+          description: Batch job id
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DescribeBatchOperationResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    post:
+      tags:
+        - WorkflowService
+      description: StartBatchOperation starts a new batch operation
+      operationId: StartBatchOperation
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace that contains the batch operation
+          required: true
+          schema:
+            type: string
+        - name: jobId
+          in: path
+          description: Job ID defines the unique ID for the batch job
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/StartBatchOperationRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/StartBatchOperationResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/batch-operations/{jobId}/stop:
+    post:
+      tags:
+        - WorkflowService
+      description: StopBatchOperation stops a batch operation
+      operationId: StopBatchOperation
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace that contains the batch operation
+          required: true
+          schema:
+            type: string
+        - name: jobId
+          in: path
+          description: Batch job id
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/StopBatchOperationRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/StopBatchOperationResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedules:
+    get:
+      tags:
+        - WorkflowService
+      description: List all schedules in a namespace.
+      operationId: ListSchedules
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace to list schedules in.
+          required: true
+          schema:
+            type: string
+        - name: maximumPageSize
+          in: query
+          description: How many to return at once.
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          description: Token to get the next page of results.
+          schema:
+            type: string
+            format: bytes
+        - name: query
+          in: query
+          description: Query to filter schedules.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListSchedulesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedules/{scheduleId}:
+    get:
+      tags:
+        - WorkflowService
+      description: Returns the schedule description and current state of an existing schedule.
+      operationId: DescribeSchedule
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace of the schedule to describe.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the schedule to describe.
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DescribeScheduleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    post:
+      tags:
+        - WorkflowService
+      description: Creates a new schedule.
+      operationId: CreateSchedule
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace the schedule should be created in.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the new schedule.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateScheduleRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CreateScheduleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+    delete:
+      tags:
+        - WorkflowService
+      description: Deletes a schedule, removing it from the system.
+      operationId: DeleteSchedule
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace of the schedule to delete.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the schedule to delete.
+          required: true
+          schema:
+            type: string
+        - name: identity
+          in: query
+          description: The identity of the client who initiated this request.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DeleteScheduleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedules/{scheduleId}/matching-times:
+    get:
+      tags:
+        - WorkflowService
+      description: Lists matching times within a range.
+      operationId: ListScheduleMatchingTimes
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace of the schedule to query.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the schedule to query.
+          required: true
+          schema:
+            type: string
+        - name: startTime
+          in: query
+          description: Time range to query.
+          schema:
+            type: string
+            format: date-time
+        - name: endTime
+          in: query
+          schema:
+            type: string
+            format: date-time
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListScheduleMatchingTimesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedules/{scheduleId}/patch:
+    post:
+      tags:
+        - WorkflowService
+      description: Makes a specific change to a schedule or triggers an immediate action.
+      operationId: PatchSchedule
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace of the schedule to patch.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the schedule to patch.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchScheduleRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PatchScheduleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedules/{scheduleId}/update:
+    post:
+      tags:
+        - WorkflowService
+      description: Changes the configuration or state of an existing schedule.
+      operationId: UpdateSchedule
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace of the schedule to update.
+          required: true
+          schema:
+            type: string
+        - name: scheduleId
+          in: path
+          description: The id of the schedule to update.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateScheduleRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateScheduleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/task-queues/{taskQueue}/worker-build-id-compatibility:
+    get:
+      tags:
+        - WorkflowService
+      description: |-
+        Deprecated. Use `GetWorkerVersioningRules`.
+         Fetches the worker build id versioning sets for a task queue.
+      operationId: GetWorkerBuildIdCompatibility
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: taskQueue
+          in: path
+          description: Must be set, the task queue to interrogate about worker id compatibility.
+          required: true
+          schema:
+            type: string
+        - name: maxSets
+          in: query
+          description: |-
+            Limits how many compatible sets will be returned. Specify 1 to only return the current
+             default major version set. 0 returns all sets.
+          schema:
+            type: integer
+            format: int32
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetWorkerBuildIdCompatibilityResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/task-queues/{taskQueue}/worker-versioning-rules:
+    get:
+      tags:
+        - WorkflowService
+      description: |-
+        Fetches the Build ID assignment and redirect rules for a Task Queue.
+         WARNING: Worker Versioning is not yet stable and the API and behavior may change incompatibly.
+      operationId: GetWorkerVersioningRules
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: taskQueue
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetWorkerVersioningRulesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/task-queues/{task_queue.name}:
+    get:
+      tags:
+        - WorkflowService
+      description: |-
+        DescribeTaskQueue returns the following information about the target task queue, broken down by Build ID:
+           - List of pollers
+           - Workflow Reachability status
+           - Backlog info for Workflow and/or Activity tasks
+      operationId: DescribeTaskQueue
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: task_queue.name
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: taskQueue.name
+          in: query
+          schema:
+            type: string
+        - name: taskQueue.kind
+          in: query
+          description: 'Default: TASK_QUEUE_KIND_NORMAL.'
+          schema:
+            enum:
+              - TASK_QUEUE_KIND_UNSPECIFIED
+              - TASK_QUEUE_KIND_NORMAL
+              - TASK_QUEUE_KIND_STICKY
+            type: string
+            format: enum
+        - name: taskQueue.normalName
+          in: query
+          description: |-
+            Iff kind == TASK_QUEUE_KIND_STICKY, then this field contains the name of
+             the normal task queue that the sticky worker is running on.
+          schema:
+            type: string
+        - name: taskQueueType
+          in: query
+          description: |-
+            Deprecated. Use `ENHANCED` mode with `task_queue_types`. Ignored in `ENHANCED` mode.
+             If unspecified (TASK_QUEUE_TYPE_UNSPECIFIED), then default value (TASK_QUEUE_TYPE_WORKFLOW) will be used.
+          schema:
+            enum:
+              - TASK_QUEUE_TYPE_UNSPECIFIED
+              - TASK_QUEUE_TYPE_WORKFLOW
+              - TASK_QUEUE_TYPE_ACTIVITY
+              - TASK_QUEUE_TYPE_NEXUS
+            type: string
+            format: enum
+        - name: includeTaskQueueStatus
+          in: query
+          description: Deprecated. Ignored in `ENHANCED` mode.
+          schema:
+            type: boolean
+        - name: apiMode
+          in: query
+          description: All options except `task_queue_type` and `include_task_queue_status` are only available in the `ENHANCED` mode.
+          schema:
+            enum:
+              - DESCRIBE_TASK_QUEUE_MODE_UNSPECIFIED
+              - DESCRIBE_TASK_QUEUE_MODE_ENHANCED
+            type: string
+            format: enum
+        - name: versions.buildIds
+          in: query
+          description: Include specific Build IDs.
+          schema:
+            type: array
+            items:
+              type: string
+        - name: versions.unversioned
+          in: query
+          description: Include the unversioned queue.
+          schema:
+            type: boolean
+        - name: versions.allActive
+          in: query
+          description: |-
+            Include all active versions. A version is considered active if, in the last few minutes,
+             it has had new tasks or polls, or it has been the subject of certain task queue API calls.
+          schema:
+            type: boolean
+        - name: taskQueueTypes
+          in: query
+          description: Task queue types to report info about. If not specified, all types are considered.
+          schema:
+            type: array
+            items:
+              enum:
+                - TASK_QUEUE_TYPE_UNSPECIFIED
+                - TASK_QUEUE_TYPE_WORKFLOW
+                - TASK_QUEUE_TYPE_ACTIVITY
+                - TASK_QUEUE_TYPE_NEXUS
+              type: string
+              format: enum
+        - name: reportStats
+          in: query
+          description: Report stats for the requested task queue types and versions
+          schema:
+            type: boolean
+        - name: reportPollers
+          in: query
+          description: Report list of pollers for requested task queue types and versions
+          schema:
+            type: boolean
+        - name: reportTaskReachability
+          in: query
+          description: |-
+            Report task reachability for the requested versions and all task types (task reachability is not reported
+             per task type).
+          schema:
+            type: boolean
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DescribeTaskQueueResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/worker-task-reachability:
+    get:
+      tags:
+        - WorkflowService
+      description: |-
+        Deprecated. Use `DescribeTaskQueue`.
+         Fetches task reachability to determine whether a worker may be retired.
+         The request may specify task queues to query for or let the server fetch all task queues mapped to the given
+         build IDs.
+         When requesting a large number of task queues or all task queues associated with the given build ids in a
+         namespace, all task queues will be listed in the response but some of them may not contain reachability
+         information due to a server enforced limit. When reaching the limit, task queues that reachability information
+         could not be retrieved for will be marked with a single TASK_REACHABILITY_UNSPECIFIED entry. The caller may issue
+         another call to get the reachability for those task queues.
+         Open source users can adjust this limit by setting the server's dynamic config value for
+         `limit.reachabilityTaskQueueScan` with the caveat that this call can strain the visibility store.
+      operationId: GetWorkerTaskReachability
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: buildIds
+          in: query
+          description: |-
+            Build ids to retrieve reachability for. An empty string will be interpreted as an unversioned worker.
+             The number of build ids that can be queried in a single API call is limited.
+             Open source users can adjust this limit by setting the server's dynamic config value for
+             `limit.reachabilityQueryBuildIds` with the caveat that this call can strain the visibility store.
+          schema:
+            type: array
+            items:
+              type: string
+        - name: taskQueues
+          in: query
+          description: |-
+            Task queues to retrieve reachability for. Leave this empty to query for all task queues associated with given
+             build ids in the namespace.
+             Must specify at least one task queue if querying for an unversioned worker.
+             The number of task queues that the server will fetch reachability information for is limited.
+             See the `GetWorkerTaskReachabilityResponse` documentation for more information.
+          schema:
+            type: array
+            items:
+              type: string
+        - name: reachability
+          in: query
+          description: |-
+            Type of reachability to query for.
+             `TASK_REACHABILITY_NEW_WORKFLOWS` is always returned in the response.
+             Use `TASK_REACHABILITY_EXISTING_WORKFLOWS` if your application needs to respond to queries on closed workflows.
+             Otherwise, use `TASK_REACHABILITY_OPEN_WORKFLOWS`. Default is `TASK_REACHABILITY_EXISTING_WORKFLOWS` if left
+             unspecified.
+             See the TaskReachability docstring for information about each enum variant.
+          schema:
+            enum:
+              - TASK_REACHABILITY_UNSPECIFIED
+              - TASK_REACHABILITY_NEW_WORKFLOWS
+              - TASK_REACHABILITY_EXISTING_WORKFLOWS
+              - TASK_REACHABILITY_OPEN_WORKFLOWS
+              - TASK_REACHABILITY_CLOSED_WORKFLOWS
+            type: string
+            format: enum
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetWorkerTaskReachabilityResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflow-count:
+    get:
+      tags:
+        - WorkflowService
+      description: CountWorkflowExecutions is a visibility API to count of workflow executions in a specific namespace.
+      operationId: CountWorkflowExecutions
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: query
+          in: query
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CountWorkflowExecutionsResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows:
+    get:
+      tags:
+        - WorkflowService
+      description: ListWorkflowExecutions is a visibility API to list workflow executions in a specific namespace.
+      operationId: ListWorkflowExecutions
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: pageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          schema:
+            type: string
+            format: bytes
+        - name: query
+          in: query
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListWorkflowExecutionsResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/execute-multi-operation:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        ExecuteMultiOperation executes multiple operations within a single workflow.
+         Operations are started atomically, meaning if *any* operation fails to be started, none are,
+         and the request fails. Upon start, the API returns only when *all* operations have a response.
+         Upon failure, it returns `MultiOperationExecutionFailure` where the status code
+         equals the status code of the *first* operation that failed to be started.
+         NOTE: Experimental API.
+      operationId: ExecuteMultiOperation
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ExecuteMultiOperationRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ExecuteMultiOperationResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{execution.workflow_id}:
+    get:
+      tags:
+        - WorkflowService
+      description: DescribeWorkflowExecution returns information about the specified workflow execution.
+      operationId: DescribeWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflowId
+          in: query
+          schema:
+            type: string
+        - name: execution.runId
+          in: query
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DescribeWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{execution.workflow_id}/history:
+    get:
+      tags:
+        - WorkflowService
+      description: |-
+        GetWorkflowExecutionHistory returns the history of specified workflow execution. Fails with
+         `NotFound` if the specified workflow execution is unknown to the service.
+      operationId: GetWorkflowExecutionHistory
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflowId
+          in: query
+          schema:
+            type: string
+        - name: execution.runId
+          in: query
+          schema:
+            type: string
+        - name: maximumPageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          description: |-
+            If a `GetWorkflowExecutionHistoryResponse` or a `PollWorkflowTaskQueueResponse` had one of
+             these, it should be passed here to fetch the next page.
+          schema:
+            type: string
+            format: bytes
+        - name: waitNewEvent
+          in: query
+          description: |-
+            If set to true, the RPC call will not resolve until there is a new event which matches
+             the `history_event_filter_type`, or a timeout is hit.
+          schema:
+            type: boolean
+        - name: historyEventFilterType
+          in: query
+          description: |-
+            Filter returned events such that they match the specified filter type.
+             Default: HISTORY_EVENT_FILTER_TYPE_ALL_EVENT.
+          schema:
+            enum:
+              - HISTORY_EVENT_FILTER_TYPE_UNSPECIFIED
+              - HISTORY_EVENT_FILTER_TYPE_ALL_EVENT
+              - HISTORY_EVENT_FILTER_TYPE_CLOSE_EVENT
+            type: string
+            format: enum
+        - name: skipArchival
+          in: query
+          schema:
+            type: boolean
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetWorkflowExecutionHistoryResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{execution.workflow_id}/history-reverse:
+    get:
+      tags:
+        - WorkflowService
+      description: "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse \n order (starting from last event). Fails with`NotFound` if the specified workflow execution is \n unknown to the service."
+      operationId: GetWorkflowExecutionHistoryReverse
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflowId
+          in: query
+          schema:
+            type: string
+        - name: execution.runId
+          in: query
+          schema:
+            type: string
+        - name: maximumPageSize
+          in: query
+          schema:
+            type: integer
+            format: int32
+        - name: nextPageToken
+          in: query
+          schema:
+            type: string
+            format: bytes
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetWorkflowExecutionHistoryReverseResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{execution.workflow_id}/query/{query.query_type}:
+    post:
+      tags:
+        - WorkflowService
+      description: QueryWorkflow requests a query be executed for a specified workflow execution.
+      operationId: QueryWorkflow
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: query.query_type
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/QueryWorkflowRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/QueryWorkflowResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflowId}:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        StartWorkflowExecution starts a new workflow execution.
+         It will create the execution with a `WORKFLOW_EXECUTION_STARTED` event in its history and
+         also schedule the first workflow task. Returns `WorkflowExecutionAlreadyStarted`, if an
+         instance already exists with same workflow id.
+      operationId: StartWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflowId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/StartWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/StartWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflowId}/signal-with-start/{signalName}:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        SignalWithStartWorkflowExecution is used to ensure a signal is sent to a workflow, even if
+         it isn't yet started.
+         If the workflow is running, a `WORKFLOW_EXECUTION_SIGNALED` event is recorded in the history
+         and a workflow task is generated.
+         If the workflow is not running or not found, then the workflow is created with
+         `WORKFLOW_EXECUTION_STARTED` and `WORKFLOW_EXECUTION_SIGNALED` events in its history, and a
+         workflow task is generated.
+         (-- api-linter: core::0136::prepositions=disabled
+             aip.dev/not-precedent: "With" is used to indicate combined operation. --)
+      operationId: SignalWithStartWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflowId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: signalName
+          in: path
+          description: The workflow author-defined name of the signal to send to the workflow
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SignalWithStartWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SignalWithStartWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/cancel:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RequestCancelWorkflowExecution is called by workers when they want to request cancellation of
+         a workflow execution.
+         This results in a new `WORKFLOW_EXECUTION_CANCEL_REQUESTED` event being written to the
+         workflow history and a new workflow task created for the workflow. It returns success if the requested
+         workflow is already closed. It fails with 'NotFound' if the requested workflow doesn't exist.
+      operationId: RequestCancelWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflow_execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RequestCancelWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RequestCancelWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/reset:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        ResetWorkflowExecution will reset an existing workflow execution to a specified
+         `WORKFLOW_TASK_COMPLETED` event (exclusive). It will immediately terminate the current
+         execution instance.
+         TODO: Does exclusive here mean *just* the completed event, or also WFT started? Otherwise the task is doomed to time out?
+      operationId: ResetWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflow_execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ResetWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ResetWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/signal/{signalName}:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        SignalWorkflowExecution is used to send a signal to a running workflow execution.
+         This results in a `WORKFLOW_EXECUTION_SIGNALED` event recorded in the history and a workflow
+         task being created for the execution.
+      operationId: SignalWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflow_execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: signalName
+          in: path
+          description: The workflow author-defined name of the signal to send to the workflow
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SignalWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SignalWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/terminate:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        TerminateWorkflowExecution terminates an existing workflow execution by recording a
+         `WORKFLOW_EXECUTION_TERMINATED` event in the history and immediately terminating the
+         execution instance.
+      operationId: TerminateWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: workflow_execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TerminateWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TerminateWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/update/{request.input.name}:
+    post:
+      tags:
+        - WorkflowService
+      description: Invokes the specified Update function on user Workflow code.
+      operationId: UpdateWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          description: The namespace name of the target Workflow.
+          required: true
+          schema:
+            type: string
+        - name: workflow_execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: request.input.name
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /system-info:
+    get:
+      tags:
+        - WorkflowService
+      description: GetSystemInfo returns information about the system.
+      operationId: GetSystemInfo
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetSystemInfoResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+components:
+  schemas:
+    ActivityFailureInfo:
+      type: object
+      properties:
+        scheduledEventId:
+          type: string
+        startedEventId:
+          type: string
+        identity:
+          type: string
+        activityType:
+          $ref: '#/components/schemas/ActivityType'
+        activityId:
+          type: string
+        retryState:
+          enum:
+            - RETRY_STATE_UNSPECIFIED
+            - RETRY_STATE_IN_PROGRESS
+            - RETRY_STATE_NON_RETRYABLE_FAILURE
+            - RETRY_STATE_TIMEOUT
+            - RETRY_STATE_MAXIMUM_ATTEMPTS_REACHED
+            - RETRY_STATE_RETRY_POLICY_NOT_SET
+            - RETRY_STATE_INTERNAL_SERVER_ERROR
+            - RETRY_STATE_CANCEL_REQUESTED
+          type: string
+          format: enum
+    ActivityOptions:
+      type: object
+      properties:
+        taskQueue:
+          $ref: '#/components/schemas/TaskQueue'
+        scheduleToCloseTimeout:
+          pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
+          type: string
+          description: |-
+            Indicates how long the caller is willing to wait for an activity completion. Limits how long
+             retries will be attempted. Either this or `start_to_close_timeout` must be specified.
+             (-- api-linter: core::0140::prepositions=disabled
+                 aip.dev/not-precedent: "to" is used to indicate interval. --)
+        scheduleToStartTimeout:
+          pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
+          type: string
+          description: |-
+            Limits time an activity task can stay in a task queue before a worker picks it up. This
+             timeout is always non retryable, as all a retry would achieve is to put it back into the same
+             queue. Defaults to `schedule_to_close_timeout` or workflow execution timeout if not
+             specified.
+             (-- api-linter: core::0140::prepositions=disabled
+                 aip.dev/not-precedent: "to" is used to indicate interval. --)
+        startToCloseTimeout:
+          pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
+          type: string
+          description: |-
+            Maximum time an activity is allowed to execute after being picked up by a worker. This
+             timeout is always retryable. Either this or `schedule_to_close_timeout` must be
+             specified.
+             (-- api-linter: core::0140::prepositions=disabled
+                 aip.dev/not-precedent: "to" is used to indicate interval. --)
+        heartbeatTimeout:
+          pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
+          type: string
+          description: Maximum permitted time between successful worker heartbeats.
+        retryPolicy:
+          $ref: '#/components/schemas/RetryPolicy'
     ActivityPropertiesModifiedExternallyEventAttributes:
       type: object
       properties:
@@ -2300,8 +4688,6 @@ components:
              retry interval calculated by the retry policy. Retry attempts will
              still be subject to the maximum retries limit and total time limit
              defined by the policy.
-             ATTENTION: this value will be ignored if set for failures produced by
-             the workflow.
     BackfillRequest:
       type: object
       properties:
@@ -2571,6 +4957,8 @@ components:
       properties:
         nexus:
           $ref: '#/components/schemas/Callback_Nexus'
+        internal:
+          $ref: '#/components/schemas/Callback_Internal'
       description: Callback to attach to various events in the system, e.g. workflow run completion.
     CallbackInfo:
       type: object
@@ -2625,6 +5013,18 @@ components:
       type: object
       properties: {}
       description: Trigger for when the workflow is closed.
+    Callback_Internal:
+      type: object
+      properties:
+        data:
+          type: string
+          description: Opaque internal data.
+          format: bytes
+      description: |-
+        Callbacks to be delivered internally within the system.
+         This variant is not settable in the API and will be rejected by the service with an INVALID_ARGUMENT error.
+         The only reason that this is exposed is because callbacks are replicated across clusters via the
+         WorkflowExecutionStarted event, which is defined in the public API.
     Callback_Nexus:
       type: object
       properties:
@@ -3151,8 +5551,13 @@ components:
           description: |-
             Endpoint name, unique for this cluster. Must match `[a-zA-Z_][a-zA-Z0-9_]*`.
              Renaming an endpoint breaks all workflow callers that reference this endpoint, causing operations to fail.
-        metadata:
-          $ref: '#/components/schemas/UserMetadata'
+        description:
+          allOf:
+            - $ref: '#/components/schemas/Payload'
+          description: |-
+            Markdown description serialized as a single JSON string.
+             If the Payload is encrypted, the UI and CLI may decrypt with the configured codec server endpoint.
+             By default, the server enforces a limit of 20,000 bytes for this entire payload.
         target:
           allOf:
             - $ref: '#/components/schemas/EndpointTarget'
@@ -3214,8 +5619,14 @@ components:
             Additional restrictions:
              - setting `cron_schedule` is invalid
              - setting `request_eager_execution` is invalid
+             - setting `workflow_start_delay` is invalid
         updateWorkflow:
-          $ref: '#/components/schemas/UpdateWorkflowExecutionRequest'
+          allOf:
+            - $ref: '#/components/schemas/UpdateWorkflowExecutionRequest'
+          description: |-
+            Additional restrictions:
+             - setting `first_execution_run_id` is invalid
+             - setting `workflow_execution.run_id` is invalid
     ExecuteMultiOperationResponse:
       type: object
       properties:
@@ -3290,7 +5701,21 @@ components:
         encodedAttributes:
           allOf:
             - $ref: '#/components/schemas/Payload'
-          description: "Alternative way to supply `message` and `stack_trace` and possibly other attributes, used for encryption of\n errors originating in user code which might contain sensitive information.\n The `encoded_attributes` Payload could represent any serializable object, e.g. JSON object or a `Failure` proto\n message.\n\n SDK authors: \n - The SDK should provide a default `encodeFailureAttributes` and `decodeFailureAttributes` implementation that:\n   - Uses a JSON object to represent `{ message, stack_trace }`.\n   - Overwrites the original message with \"Encoded failure\" to indicate that more information could be extracted.\n   - Overwrites the original stack_trace with an empty string.\n   - The resulting JSON object is converted to Payload using the default PayloadConverter and should be processed\n     by the user-provided PayloadCodec\n\n - If there's demand, we could allow overriding the default SDK implementation to encode other opaque Failure attributes."
+          description: |-
+            Alternative way to supply `message` and `stack_trace` and possibly other attributes, used for encryption of
+             errors originating in user code which might contain sensitive information.
+             The `encoded_attributes` Payload could represent any serializable object, e.g. JSON object or a `Failure` proto
+             message.
+             SDK authors:
+             - The SDK should provide a default `encodeFailureAttributes` and `decodeFailureAttributes` implementation that:
+               - Uses a JSON object to represent `{ message, stack_trace }`.
+               - Overwrites the original message with "Encoded failure" to indicate that more information could be extracted.
+               - Overwrites the original stack_trace with an empty string.
+               - The resulting JSON object is converted to Payload using the default PayloadConverter and should be processed
+                 by the user-provided PayloadCodec
+             - If there's demand, we could allow overriding the default SDK implementation to encode other opaque Failure attributes.
         cause:
           $ref: '#/components/schemas/Failure'
         applicationFailureInfo:
@@ -3395,6 +5820,11 @@ components:
         countGroupByExecutionStatus:
           type: boolean
           description: True if the server supports count group by execution status
+        nexus:
+          type: boolean
+          description: |-
+            True if the server supports Nexus operations.
+             This flag is dependent both on server version and for Nexus to be enabled via server configuration.
       description: System capability details.
     GetWorkerBuildIdCompatibilityResponse:
       type: object
@@ -3549,13 +5979,13 @@ components:
             - EVENT_TYPE_SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_FAILED
             - EVENT_TYPE_EXTERNAL_WORKFLOW_EXECUTION_SIGNALED
             - EVENT_TYPE_UPSERT_WORKFLOW_SEARCH_ATTRIBUTES
+            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_ADMITTED
             - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_ACCEPTED
             - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_REJECTED
             - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_COMPLETED
             - EVENT_TYPE_WORKFLOW_PROPERTIES_MODIFIED_EXTERNALLY
             - EVENT_TYPE_ACTIVITY_PROPERTIES_MODIFIED_EXTERNALLY
             - EVENT_TYPE_WORKFLOW_PROPERTIES_MODIFIED
-            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_ADMITTED
             - EVENT_TYPE_NEXUS_OPERATION_SCHEDULED
             - EVENT_TYPE_NEXUS_OPERATION_STARTED
             - EVENT_TYPE_NEXUS_OPERATION_COMPLETED
@@ -3590,6 +6020,11 @@ components:
               * workflow_execution_started_event_attributes - summary and details from start workflow.
               * timer_started_event_attributes - summary represents an identifier for the timer for use by
                 user interfaces.
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links associated with the event.
         workflowExecutionStartedEventAttributes:
           $ref: '#/components/schemas/WorkflowExecutionStartedEventAttributes'
         workflowExecutionCompletedEventAttributes:
@@ -3708,15 +6143,15 @@ components:
           allOf:
             - $ref: '#/components/schemas/Header'
           description: |-
-            Headers that are passed with the update from the requesting entity.
+            Headers that are passed with the Update from the requesting entity.
              These can include things like auth or tracing tokens.
         name:
           type: string
-          description: The name of the input handler to invoke on the target workflow
+          description: The name of the Update handler to invoke on the target Workflow.
         args:
           allOf:
             - $ref: '#/components/schemas/Payloads'
-          description: The arguments to pass to the named handler.
+          description: The arguments to pass to the named Update handler.
     IntervalSpec:
       type: object
       properties:
@@ -3738,6 +6173,38 @@ components:
          xx:19:00. An interval of 28 days with phase zero would match
          2022-02-17T00:00:00Z (among other times). The same interval with a phase of 3
          days, 5 hours, and 23 minutes would match 2022-02-20T05:23:00Z instead.
+    Link:
+      type: object
+      properties:
+        workflowEvent:
+          $ref: '#/components/schemas/Link_WorkflowEvent'
+        batchJob:
+          $ref: '#/components/schemas/Link_BatchJob'
+      description: |-
+        Link can be associated with history events. It might contain information about an external entity
+         related to the history event. For example, workflow A makes a Nexus call that starts workflow B:
+         in this case, a history event in workflow A could contain a Link to the workflow started event in
+         workflow B, and vice-versa.
+    Link_BatchJob:
+      type: object
+      properties:
+        jobId:
+          type: string
+      description: |-
+        A link to a built-in batch job.
+         Batch jobs can be used to perform operations on a set of workflows (e.g. terminate, signal, cancel, etc).
+         This link can be put on workflow history events generated by actions taken by a batch job.
+    Link_WorkflowEvent:
+      type: object
+      properties:
+        namespace:
+          type: string
+        workflowId:
+          type: string
+        runId:
+          type: string
+        eventRef:
+          $ref: '#/components/schemas/WorkflowEvent_EventReference'
     ListArchivedWorkflowExecutionsResponse:
       type: object
       properties:
@@ -3903,11 +6370,11 @@ components:
       properties:
         updateId:
           type: string
-          description: An ID with workflow-scoped uniqueness for this update
+          description: An ID with workflow-scoped uniqueness for this Update.
         identity:
           type: string
-          description: A string identifying the agent that requested this update.
-      description: Metadata about a workflow execution update.
+          description: A string identifying the agent that requested this Update.
+      description: Metadata about a Workflow Update.
     MeteringMetadata:
       type: object
       properties:
@@ -4096,6 +6563,9 @@ components:
           allOf:
             - $ref: '#/components/schemas/Failure'
           description: Cancellation details.
+        requestId:
+          type: string
+          description: The request ID allocated at schedule time.
       description: Nexus operation completed as canceled. May or may not have been due to a cancellation request by the workflow.
     NexusOperationCancellationInfo:
       type: object
@@ -4145,6 +6615,9 @@ components:
           description: |-
             Serialized result of the Nexus operation. The response of the Nexus handler.
              Delivered either via a completion callback or as a response to a synchronous operation.
+        requestId:
+          type: string
+          description: The request ID allocated at schedule time.
       description: Nexus operation completed successfully.
     NexusOperationFailedEventAttributes:
       type: object
@@ -4156,6 +6629,9 @@ components:
           allOf:
             - $ref: '#/components/schemas/Failure'
           description: Failure details. A NexusOperationFailureInfo wrapping an ApplicationFailureInfo.
+        requestId:
+          type: string
+          description: The request ID allocated at schedule time.
       description: Nexus operation failed.
     NexusOperationFailureInfo:
       type: object
@@ -4219,6 +6695,12 @@ components:
           description: |-
             A unique ID generated by the history service upon creation of this event.
              The ID will be transmitted with all nexus StartOperation requests and is used as an idempotentency key.
+        endpointId:
+          type: string
+          description: |-
+            Endpoint ID as resolved in the endpoint registry at the time this event was generated.
+             This is stored on the event and used internally by the server in case the endpoint is renamed from the time the
+             event was originally scheduled.
       description: Event marking that an operation was scheduled by a workflow via the ScheduleNexusOperation command.
     NexusOperationStartedEventAttributes:
       type: object
@@ -4231,6 +6713,9 @@ components:
           description: |-
             The operation ID returned by the Nexus handler in the response to the StartOperation request.
              This ID is used when canceling the operation.
+        requestId:
+          type: string
+          description: The request ID allocated at schedule time.
       description: |-
         Event marking an asynchronous operation was started by the responding Nexus handler.
          If the operation completes synchronously, this event is not generated.
@@ -4246,6 +6731,9 @@ components:
           allOf:
             - $ref: '#/components/schemas/Failure'
           description: Failure details. A NexusOperationFailureInfo wrapping a CanceledFailureInfo.
+        requestId:
+          type: string
+          description: The request ID allocated at schedule time.
       description: Nexus operation timed out.
     Outcome:
       type: object
@@ -4254,7 +6742,7 @@ components:
           $ref: '#/components/schemas/Payloads'
         failure:
           $ref: '#/components/schemas/Failure'
-      description: The outcome of a workflow update - success or failure.
+      description: 'The outcome of a Workflow Update: success or failure.'
     PatchScheduleRequest:
       type: object
       properties:
@@ -4275,6 +6763,32 @@ components:
     PatchScheduleResponse:
       type: object
       properties: {}
+    PauseActivityByIdRequest:
+      type: object
+      properties:
+        namespace:
+          type: string
+          description: Namespace of the workflow which scheduled this activity.
+        workflowId:
+          type: string
+          description: ID of the workflow which scheduled this activity.
+        runId:
+          type: string
+          description: |-
+            Run ID of the workflow which scheduled this activity.
+             If empty - latest workflow is used.
+        activityId:
+          type: string
+          description: ID of the activity we're updating.
+        identity:
+          type: string
+          description: The identity of the client who initiated this request.
+        requestId:
+          type: string
+          description: Used to de-dupe requests.
+    PauseActivityByIdResponse:
+      type: object
+      properties: {}
     Payload:
       description: |-
         Represents some binary (byte array) data (ex: activity input parameters or workflow result) with
@@ -4338,6 +6852,27 @@ components:
           allOf:
             - $ref: '#/components/schemas/WorkerVersionStamp'
           description: The version stamp of the worker to whom this activity was most recently dispatched
+        currentRetryInterval:
+          pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
+          type: string
+          description: |-
+            The time activity will wait until the next retry.
+             If activity is currently running it will be next retry interval if activity failed.
+             If activity is currently waiting it will be current retry interval.
+             If there will be no retry it will be null.
+        lastAttemptCompleteTime:
+          type: string
+          description: The time when the last activity attempt was completed. If activity has not been completed yet then it will be null.
+          format: date-time
+        nextAttemptScheduleTime:
+          type: string
+          description: |-
+            Next time when activity will be scheduled.
+             If activity is currently scheduled or started it will be null.
+          format: date-time
+        paused:
+          type: boolean
+          description: Indicates if activity is paused.
     PendingChildExecutionInfo:
       type: object
       properties:
@@ -4415,6 +6950,11 @@ components:
           format: date-time
         cancellationInfo:
           $ref: '#/components/schemas/NexusOperationCancellationInfo'
+        scheduledEventId:
+          type: string
+          description: |-
+            The event ID of the NexusOperationScheduled event. Can be used to correlate an operation in the
+             DescribeWorkflowExecution response with workflow history.
       description: PendingNexusOperationInfo contains the state of a pending Nexus operation.
     PendingWorkflowTaskInfo:
       type: object
@@ -4660,6 +7200,9 @@ components:
           description: |-
             Will be set to true if the activity has been asked to cancel itself. The SDK should then
              notify the activity of cancellation if it is still running.
+        activityPaused:
+          type: boolean
+          description: Will be set to true if the activity is paused.
     RegisterNamespaceRequest:
       type: object
       properties:
@@ -4728,7 +7271,7 @@ components:
           $ref: '#/components/schemas/Meta'
         input:
           $ref: '#/components/schemas/Input'
-      description: The client request that triggers a workflow execution update
+      description: The client request that triggers a Workflow Update.
     RequestCancelExternalWorkflowExecutionFailedEventAttributes:
       type: object
       properties:
@@ -4807,9 +7350,50 @@ components:
         reason:
           type: string
           description: Reason for requesting the cancellation
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links to be associated with the WorkflowExecutionCanceled event.
     RequestCancelWorkflowExecutionResponse:
       type: object
       properties: {}
+    ResetActivityByIdRequest:
+      type: object
+      properties:
+        namespace:
+          type: string
+          description: Namespace of the workflow which scheduled this activity.
+        workflowId:
+          type: string
+          description: ID of the workflow which scheduled this activity.
+        runId:
+          type: string
+          description: |-
+            Run ID of the workflow which scheduled this activity.
+             If empty - latest workflow is used.
+        activityId:
+          type: string
+          description: ID of the activity we're updating.
+        identity:
+          type: string
+          description: The identity of the client who initiated this request.
+        requestId:
+          type: string
+          description: Used to de-dupe requests.
+        noWait:
+          type: boolean
+          description: |-
+            Indicates that activity should be scheduled immediately.
+             If this flag doesn't set, and activity currently running - temporal will wait until activity is completed.
+        resetHeartbeat:
+          type: boolean
+          description: |-
+            Indicates that activity should reset heartbeat details.
+             This flag will be applied only to the new instance of the activity.
+    ResetActivityByIdResponse:
+      type: object
+      properties: {}
     ResetOptions:
       type: object
       properties:
@@ -4850,6 +7434,7 @@ components:
               - RESET_REAPPLY_EXCLUDE_TYPE_UNSPECIFIED
               - RESET_REAPPLY_EXCLUDE_TYPE_SIGNAL
               - RESET_REAPPLY_EXCLUDE_TYPE_UPDATE
+              - RESET_REAPPLY_EXCLUDE_TYPE_NEXUS
             type: string
             format: enum
           description: Event types not to be reapplied
@@ -4930,6 +7515,7 @@ components:
               - RESET_REAPPLY_EXCLUDE_TYPE_UNSPECIFIED
               - RESET_REAPPLY_EXCLUDE_TYPE_SIGNAL
               - RESET_REAPPLY_EXCLUDE_TYPE_UPDATE
+              - RESET_REAPPLY_EXCLUDE_TYPE_NEXUS
             type: string
             format: enum
           description: Event types not to be reapplied
@@ -5190,6 +7776,21 @@ components:
           allOf:
             - $ref: '#/components/schemas/WorkflowExecution'
           description: 'If action was start_workflow:'
+        startWorkflowStatus:
+          enum:
+            - WORKFLOW_EXECUTION_STATUS_UNSPECIFIED
+            - WORKFLOW_EXECUTION_STATUS_RUNNING
+            - WORKFLOW_EXECUTION_STATUS_COMPLETED
+            - WORKFLOW_EXECUTION_STATUS_FAILED
+            - WORKFLOW_EXECUTION_STATUS_CANCELED
+            - WORKFLOW_EXECUTION_STATUS_TERMINATED
+            - WORKFLOW_EXECUTION_STATUS_CONTINUED_AS_NEW
+            - WORKFLOW_EXECUTION_STATUS_TIMED_OUT
+          type: string
+          description: |-
+            If the action was start_workflow, this field will reflect an
+             eventually-consistent view of the started workflow's status.
+          format: enum
     ScheduleInfo:
       type: object
       properties:
@@ -5668,6 +8269,11 @@ components:
             Metadata on the workflow if it is started. This is carried over to the WorkflowExecutionInfo
              for use by user interfaces to display the fixed as-of-start summary and details of the
              workflow.
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links to be associated with the WorkflowExecutionStarted and WorkflowExecutionSignaled events.
     SignalWithStartWorkflowExecutionResponse:
       type: object
       properties:
@@ -5709,6 +8315,11 @@ components:
         skipGenerateWorkflowTask:
           type: boolean
           description: Indicates that a new workflow task should not be generated when this signal is received.
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links to be associated with the WorkflowExecutionSignaled event.
     SignalWorkflowExecutionResponse:
       type: object
       properties: {}
@@ -5972,6 +8583,11 @@ components:
             Metadata on the workflow if it is started. This is carried over to the WorkflowExecutionInfo
              for use by user interfaces to display the fixed as-of-start summary and details of the
              workflow.
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links to be associated with the workflow.
     StartWorkflowExecutionResponse:
       type: object
       properties:
@@ -6129,28 +8745,63 @@ components:
         approximateBacklogCount:
           type: string
           description: |-
-            The approximate number of tasks backlogged in this task queue. May count expired tasks but eventually converges
-             to the right value.
+            The approximate number of tasks backlogged in this task queue. May count expired tasks but eventually
+             converges to the right value. Can be relied upon for scaling decisions.
+             Special note for workflow task queue type: this metric does not count sticky queue tasks. However, because
+             those tasks only remain valid for a few seconds, the inaccuracy becomes less significant as the backlog size
+             grows.
         approximateBacklogAge:
           pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
           type: string
-          description: Approximate age of the oldest task in the backlog based on the create timestamp of the task at the head of the queue.
+          description: |-
+            Approximate age of the oldest task in the backlog based on the creation time of the task at the head of
+             the queue. Can be relied upon for scaling decisions.
+             Special note for workflow task queue type: this metric does not count sticky queue tasks. However, because
+             those tasks only remain valid for a few seconds, they should not affect the result when backlog is older than
+             few seconds.
         tasksAddRate:
           type: number
           description: |-
-            Approximate tasks per second added to the task queue based on activity within a fixed window. This includes both backlogged and
-             sync-matched tasks.
+            The approximate tasks per second added to the task queue, averaging the last 30 seconds. These includes tasks
+             whether or not they were added to/dispatched from the backlog or they were dispatched immediately without going
+             to the backlog (sync-matched).
+             The difference between `tasks_add_rate` and `tasks_dispatch_rate` is a reliable metric for the rate at which
+             backlog grows/shrinks.
+             Note: the actual tasks delivered to the workers may significantly be higher than the numbers reported by
+             tasks_add_rate, because:
+             - Tasks can be sent to workers without going to the task queue. This is called Eager dispatch. Eager dispatch is
+               enable for activities by default in the latest SDKs.
+             - Tasks going to Sticky queue are not accounted for. Note that, typically, only the first workflow task of each
+               workflow goes to a normal queue, and the rest workflow tasks go to the Sticky queue associated with a specific
+               worker instance.
           format: float
         tasksDispatchRate:
           type: number
           description: |-
-            Approximate tasks per second dispatched to workers based on activity within a fixed window. This includes both backlogged and
-             sync-matched tasks.
+            The approximate tasks per second dispatched from the task queue, averaging the last 30 seconds. These includes
+             tasks whether or not they were added to/dispatched from the backlog or they were dispatched immediately without
+             going to the backlog (sync-matched).
+             The difference between `tasks_add_rate` and `tasks_dispatch_rate` is a reliable metric for the rate at which
+             backlog grows/shrinks.
+             Note: the actual tasks delivered to the workers may significantly be higher than the numbers reported by
+             tasks_dispatch_rate, because:
+             - Tasks can be sent to workers without going to the task queue. This is called Eager dispatch. Eager dispatch is
+               enable for activities by default in the latest SDKs.
+             - Tasks going to Sticky queue are not accounted for. Note that, typically, only the first workflow task of each
+               workflow goes to a normal queue, and the rest workflow tasks go to the Sticky queue associated with a specific
+               worker instance.
           format: float
       description: |-
-        For workflow task queues, we only report the normal queue stats, not sticky queues. This means the stats
-         reported here do not count all workflow tasks. However, because the tasks queued in sticky queues only remain
-         valid for a few seconds, the inaccuracy becomes less significant as the backlog age grows.
+        TaskQueueStats contains statistics about task queue backlog and activity.
+         For workflow task queue type, this result is partial because tasks sent to sticky queues are not included. Read
+         comments above each metric to understand the impact of sticky queue exclusion on that metric accuracy.
     TaskQueueStatus:
       type: object
       properties:
@@ -6224,6 +8875,11 @@ components:
             If set, this call will error if the most recent (if no run id is set on
              `workflow_execution`), or specified (if it is) workflow execution is not part of the same
              execution chain as this id.
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/Link'
+          description: Links to be associated with the WorkflowExecutionTerminated event.
     TerminateWorkflowExecutionResponse:
       type: object
       properties: {}
@@ -6316,6 +8972,91 @@ components:
           type: string
           description: If set, override overlap policy for this one request.
           format: enum
+    UnpauseActivityByIdRequest:
+      type: object
+      properties:
+        namespace:
+          type: string
+          description: Namespace of the workflow which scheduled this activity.
+        workflowId:
+          type: string
+          description: ID of the workflow which scheduled this activity.
+        runId:
+          type: string
+          description: |-
+            Run ID of the workflow which scheduled this activity.
+             If empty - latest workflow is used.
+        activityId:
+          type: string
+          description: ID of the activity we're updating.
+        identity:
+          type: string
+          description: The identity of the client who initiated this request.
+        requestId:
+          type: string
+          description: Used to de-dupe requests.
+        resume:
+          $ref: '#/components/schemas/UnpauseActivityByIdRequest_ResumeOperation'
+        reset:
+          $ref: '#/components/schemas/UnpauseActivityByIdRequest_ResetOperation'
+    UnpauseActivityByIdRequest_ResetOperation:
+      type: object
+      properties:
+        noWait:
+          type: boolean
+          description: |-
+            Indicates that the activity should be scheduled immediately.
+             Note that this may run simultaneously with any existing executions of the activity.
+        resetHeartbeat:
+          type: boolean
+          description: If set, the Heartbeat Details will be cleared out to make the Activity start over from the beginning
+    UnpauseActivityByIdRequest_ResumeOperation:
+      type: object
+      properties:
+        noWait:
+          type: boolean
+          description: Indicates that if the activity is waiting to retry, it will  be scheduled immediately.
+    UnpauseActivityByIdResponse:
+      type: object
+      properties: {}
+    UpdateActivityOptionsByIdRequest:
+      type: object
+      properties:
+        namespace:
+          type: string
+          description: Namespace of the workflow which scheduled this activity
+        workflowId:
+          type: string
+          description: ID of the workflow which scheduled this activity
+        runId:
+          type: string
+          description: |-
+            Run ID of the workflow which scheduled this activity
+             if empty - latest workflow is used
+        activityId:
+          type: string
+          description: ID of the activity we're updating
+        identity:
+          type: string
+          description: The identity of the client who initiated this request
+        activityOptions:
+          allOf:
+            - $ref: '#/components/schemas/ActivityOptions'
+          description: Activity options. Partial updates are accepted and controlled by update_mask
+        updateMask:
+          type: string
+          description: Controls which fields from `activity_options` will be applied
+          format: field-mask
+        requestId:
+          type: string
+          description: Used to de-dupe requests
+    UpdateActivityOptionsByIdResponse:
+      type: object
+      properties:
+        activityOptions:
+          allOf:
+            - $ref: '#/components/schemas/ActivityOptions'
+          description: Activity options after an update
     UpdateNamespaceInfo:
       type: object
       properties:
@@ -6398,9 +9139,7 @@ components:
           $ref: '#/components/schemas/WorkflowExecution'
         updateId:
           type: string
-      description: |-
-        The data needed by a client to refer to a previously invoked workflow
-         execution update process.
+      description: The data needed by a client to refer to a previously invoked Workflow Update.
     UpdateScheduleRequest:
       type: object
       properties:
@@ -6447,32 +9186,35 @@ components:
       properties:
         namespace:
           type: string
-          description: The namespace name of the target workflow
+          description: The namespace name of the target Workflow.
         workflowExecution:
           allOf:
             - $ref: '#/components/schemas/WorkflowExecution'
           description: |-
-            The target workflow id and (optionally) a specific run thereof
+            The target Workflow Id and (optionally) a specific Run Id thereof.
              (-- api-linter: core::0203::optional=disabled
                  aip.dev/not-precedent: false positive triggered by the word "optional" --)
         firstExecutionRunId:
           type: string
           description: |-
-            If set, this call will error if the most recent (if no run id is set on
-             `workflow_execution`), or specified (if it is) workflow execution is not
-             part of the same execution chain as this id.
+            If set, this call will error if the most recent (if no Run Id is set on
+             `workflow_execution`), or specified (if it is) Workflow Execution is not
+             part of the same execution chain as this Id.
         waitPolicy:
           allOf:
             - $ref: '#/components/schemas/WaitPolicy'
           description: |-
-            Describes when this request should return - basically whether the
-             update is synchronous, asynchronous, or somewhere in between.
+            Specifies client's intent to wait for Update results.
+             NOTE: This field works together with API call timeout which is limited by
+             server timeout (maximum wait time). If server timeout is expired before
+             user specified timeout, API call returns even if specified stage is not reached.
+             Actual reached stage will be included in the response.
         request:
           allOf:
             - $ref: '#/components/schemas/Request'
           description: |-
             The request information that will be delivered all the way down to the
-             workflow execution.
+             Workflow Execution.
       description: |-
         (-- api-linter: core::0134=disabled
              aip.dev/not-precedent: Update RPCs don't follow Google API format. --)
@@ -6487,8 +9229,8 @@ components:
           allOf:
             - $ref: '#/components/schemas/Outcome'
           description: |-
-            The outcome of the update if and only if the workflow execution update
-             has completed. If this response is being returned before the update has
+            The outcome of the Update if and only if the Workflow Update
+             has completed. If this response is being returned before the Update has
              completed then this field will not be set.
         stage:
           enum:
@@ -6564,12 +9306,13 @@ components:
             - UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED
           type: string
           description: |-
-            Indicates the update lifecycle stage that the gRPC call should wait for
-             before returning.
+            Indicates the Update lifecycle stage that the Update must reach before
+             API call is returned.
+             NOTE: This field works together with API call timeout which is limited by
+             server timeout (maximum wait time). If server timeout is expired before
+             user specified timeout, API call returns even if specified stage is not reached.
           format: enum
-      description: |-
-        Specifies to the gRPC server how long the client wants the an update-related
-         RPC call to wait before returning control to the caller.
+      description: Specifies client's intent to wait for Update results.
     WorkerVersionCapabilities:
       type: object
       properties:
@@ -6599,6 +9342,70 @@ components:
             If set, the worker is opting in to worker versioning. Otherwise, this is used only as a
              marker for workflow reset points and the BuildIDs search attribute.
       description: Identifies the version(s) of a worker that processed a task
+    WorkflowEvent_EventReference:
+      type: object
+      properties:
+        eventId:
+          type: string
+        eventType:
+          enum:
+            - EVENT_TYPE_UNSPECIFIED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_STARTED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_COMPLETED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_FAILED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_TIMED_OUT
+            - EVENT_TYPE_WORKFLOW_TASK_SCHEDULED
+            - EVENT_TYPE_WORKFLOW_TASK_STARTED
+            - EVENT_TYPE_WORKFLOW_TASK_COMPLETED
+            - EVENT_TYPE_WORKFLOW_TASK_TIMED_OUT
+            - EVENT_TYPE_WORKFLOW_TASK_FAILED
+            - EVENT_TYPE_ACTIVITY_TASK_SCHEDULED
+            - EVENT_TYPE_ACTIVITY_TASK_STARTED
+            - EVENT_TYPE_ACTIVITY_TASK_COMPLETED
+            - EVENT_TYPE_ACTIVITY_TASK_FAILED
+            - EVENT_TYPE_ACTIVITY_TASK_TIMED_OUT
+            - EVENT_TYPE_ACTIVITY_TASK_CANCEL_REQUESTED
+            - EVENT_TYPE_ACTIVITY_TASK_CANCELED
+            - EVENT_TYPE_TIMER_STARTED
+            - EVENT_TYPE_TIMER_FIRED
+            - EVENT_TYPE_TIMER_CANCELED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_CANCEL_REQUESTED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_CANCELED
+            - EVENT_TYPE_REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_INITIATED
+            - EVENT_TYPE_REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_FAILED
+            - EVENT_TYPE_EXTERNAL_WORKFLOW_EXECUTION_CANCEL_REQUESTED
+            - EVENT_TYPE_MARKER_RECORDED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_SIGNALED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_TERMINATED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_CONTINUED_AS_NEW
+            - EVENT_TYPE_START_CHILD_WORKFLOW_EXECUTION_INITIATED
+            - EVENT_TYPE_START_CHILD_WORKFLOW_EXECUTION_FAILED
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_STARTED
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_COMPLETED
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_FAILED
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_CANCELED
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_TIMED_OUT
+            - EVENT_TYPE_CHILD_WORKFLOW_EXECUTION_TERMINATED
+            - EVENT_TYPE_SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_INITIATED
+            - EVENT_TYPE_SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_FAILED
+            - EVENT_TYPE_EXTERNAL_WORKFLOW_EXECUTION_SIGNALED
+            - EVENT_TYPE_UPSERT_WORKFLOW_SEARCH_ATTRIBUTES
+            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_ADMITTED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_ACCEPTED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_REJECTED
+            - EVENT_TYPE_WORKFLOW_EXECUTION_UPDATE_COMPLETED
+            - EVENT_TYPE_WORKFLOW_PROPERTIES_MODIFIED_EXTERNALLY
+            - EVENT_TYPE_ACTIVITY_PROPERTIES_MODIFIED_EXTERNALLY
+            - EVENT_TYPE_WORKFLOW_PROPERTIES_MODIFIED
+            - EVENT_TYPE_NEXUS_OPERATION_SCHEDULED
+            - EVENT_TYPE_NEXUS_OPERATION_STARTED
+            - EVENT_TYPE_NEXUS_OPERATION_COMPLETED
+            - EVENT_TYPE_NEXUS_OPERATION_FAILED
+            - EVENT_TYPE_NEXUS_OPERATION_CANCELED
+            - EVENT_TYPE_NEXUS_OPERATION_TIMED_OUT
+            - EVENT_TYPE_NEXUS_OPERATION_CANCEL_REQUESTED
+          type: string
+          format: enum
     WorkflowExecution:
       type: object
       properties:
@@ -6839,6 +9646,15 @@ components:
           description: |-
             Build ID inherited from a previous/parent execution. If present, assigned_build_id will be set to this, instead
              of using the assignment rules.
+        firstRunId:
+          type: string
+          description: |-
+            The first run ID in the execution chain.
+             Executions created via the following operations are considered to be in the same chain
+             - ContinueAsNew
+             - Workflow Retry
+             - Workflow Reset
+             - Cron Schedule
     WorkflowExecutionSignaledEventAttributes:
       type: object
       properties: