@temporalio/core-bridge 1.15.0 → 1.16.1

package/sdk-core/crates/common/protos/api_upstream/openapi/openapiv3.yaml

@@ -164,20 +164,34 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/cancel:
+  /api/v1/namespaces/{namespace}/activities-deprecated/pause:
     post:
       tags:
         - WorkflowService
       description: |-
-        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+        PauseActivity pauses the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be paused
 
-         For workflow activities, 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
+         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.
+
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type
+         This API will be deprecated soon and replaced with a newer PauseActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: PauseActivity
       parameters:
         - name: namespace
           in: path
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -185,7 +199,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCanceledRequest'
+              $ref: '#/components/schemas/PauseActivityRequest'
         required: true
       responses:
         "200":
@@ -193,28 +207,42 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCanceledResponse'
+                $ref: '#/components/schemas/PauseActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/cancel-by-id:
+  /api/v1/namespaces/{namespace}/activities-deprecated/reset:
     post:
       tags:
         - WorkflowService
       description: |-
-        See `RespondActivityTaskCanceled`. This version allows clients to record failures by
-         namespace/workflow id/activity id instead of task token.
+        ResetActivity resets the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be reset.
 
-         (-- api-linter: core::0136::prepositions=disabled
-             aip.dev/not-precedent: "By" is used to indicate request type. --)
-      operationId: RespondActivityTaskCanceledById
+         Resetting an activity means:
+         * number of attempts will be reset to 0.
+         * activity timeouts will be reset.
+         * if the activity is waiting for retry, and it is not paused or 'keep_paused' is not provided:
+            it will be scheduled immediately (* see 'jitter' flag),
+
+         Flags:
+
+         'jitter': the activity will be scheduled at a random time within the jitter duration.
+         If the activity currently paused it will be unpaused, unless 'keep_paused' flag is provided.
+         'reset_heartbeats': the activity heartbeat timer and heartbeats will be reset.
+         'keep_paused': if the activity is paused, it will remain paused.
+
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type.
+         This API will be deprecated soon and replaced with a newer ResetActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: ResetActivity
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -222,7 +250,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
+              $ref: '#/components/schemas/ResetActivityRequest'
         required: true
       responses:
         "200":
@@ -230,28 +258,38 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
+                $ref: '#/components/schemas/ResetActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/complete:
+  /api/v1/namespaces/{namespace}/activities-deprecated/unpause:
     post:
       tags:
         - WorkflowService
       description: |-
-        RespondActivityTaskCompleted is called by workers when they successfully complete an activity
-         task.
+        UnpauseActivity unpauses the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be unpaused.
 
-         For workflow activities, 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
+         If activity is not paused, this call will have no effect.
+         If the activity was paused while waiting for retry, it will be scheduled immediately (* see 'jitter' flag).
+         Once the activity is unpaused, all timeout timers will be regenerated.
+
+         Flags:
+         'jitter': the activity will be scheduled at a random time within the jitter duration.
+         'reset_attempts': the number of attempts will be reset.
+         'reset_heartbeat': the activity heartbeat timer and heartbeats will be reset.
+
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type
+         This API will be deprecated soon and replaced with a newer UnpauseActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: UnpauseActivity
       parameters:
         - name: namespace
           in: path
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -259,7 +297,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCompletedRequest'
+              $ref: '#/components/schemas/UnpauseActivityRequest'
         required: true
       responses:
         "200":
@@ -267,24 +305,23 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCompletedResponse'
+                $ref: '#/components/schemas/UnpauseActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/complete-by-id:
+  /api/v1/namespaces/{namespace}/activities-deprecated/update-options:
     post:
       tags:
         - WorkflowService
       description: |-
-        See `RespondActivityTaskCompleted`. 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
+        UpdateActivityOptions is called by the client to update the options of an activity by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be updated.
+         This API will be deprecated soon and replaced with a newer UpdateActivityExecutionOptions that is better named and
+         structured to work well for standalone activities.
+      operationId: UpdateActivityOptions
       parameters:
         - name: namespace
           in: path
@@ -296,7 +333,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCompletedByIdRequest'
+              $ref: '#/components/schemas/UpdateActivityOptionsRequest'
         required: true
       responses:
         "200":
@@ -304,64 +341,96 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCompletedByIdResponse'
+                $ref: '#/components/schemas/UpdateActivityOptionsResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/fail:
-    post:
+  /api/v1/namespaces/{namespace}/activities/{activityId}:
+    get:
       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
+        DescribeActivityExecution returns information about an activity execution.
+         It can be used to:
+         - Get current activity info without waiting
+         - Long-poll for next state change and return new activity info
+         Response can optionally include activity input or outcome (if the activity has completed).
+      operationId: DescribeActivityExecution
       parameters:
         - name: namespace
           in: path
           required: true
           schema:
             type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/RespondActivityTaskFailedRequest'
-        required: true
+        - name: activityId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: runId
+          in: query
+          description: Activity run ID. If empty the request targets the latest run.
+          schema:
+            type: string
+        - name: includeInput
+          in: query
+          description: Include the input field in the response.
+          schema:
+            type: boolean
+        - name: includeOutcome
+          in: query
+          description: Include the outcome (result/failure) in the response if the activity has completed.
+          schema:
+            type: boolean
+        - name: longPollToken
+          in: query
+          description: |-
+            Token from a previous DescribeActivityExecutionResponse. If present, long-poll until activity
+             state changes from the state encoded in this token. If absent, return current state immediately.
+             If present, run_id must also be present.
+             Note that activity state may change multiple times between requests, therefore it is not
+             guaranteed that a client making a sequence of long-poll requests will see a complete
+             sequence of state changes.
+          schema:
+            type: string
+            format: bytes
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskFailedResponse'
+                $ref: '#/components/schemas/DescribeActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/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.
+        StartActivityExecution starts a new activity execution.
 
-         (-- api-linter: core::0136::prepositions=disabled
-             aip.dev/not-precedent: "By" is used to indicate request type. --)
-      operationId: RespondActivityTaskFailedById
+         Returns an `ActivityExecutionAlreadyStarted` error if an instance already exists with same activity ID in this namespace
+         unless permitted by the specified ID conflict policy.
+      operationId: StartActivityExecution
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: |-
+            Identifier for this activity. Required. This identifier should be meaningful in the user's
+             own system. It must be unique among activities in the same namespace, subject to the rules
+             imposed by id_reuse_policy and id_conflict_policy.
           required: true
           schema:
             type: string
@@ -369,7 +438,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
+              $ref: '#/components/schemas/StartActivityExecutionRequest'
         required: true
       responses:
         "200":
@@ -377,43 +446,41 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
+                $ref: '#/components/schemas/StartActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/heartbeat:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/cancel:
     post:
       tags:
         - WorkflowService
       description: |-
-        RecordActivityTaskHeartbeat is optionally called by workers while they execute activities.
-
-         If a worker fails to heartbeat within the `heartbeat_timeout` interval for the activity task,
-         then the current attempt times out. Depending on RetryPolicy, this may trigger a retry or
-         time out the activity.
-
-         For workflow activities, 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.
+        RequestCancelActivityExecution requests cancellation of an activity execution.
 
-         The request may contain response `details` which will be persisted by the server and may be
-         used by the activity to checkpoint progress. The `cancel_requested` field in the response
-         indicates whether cancellation has been requested for the activity.
-      operationId: RecordActivityTaskHeartbeat
+         Cancellation is cooperative: this call records the request, but the activity must detect and
+         acknowledge it for the activity to reach CANCELED status. The cancellation signal is
+         delivered via `cancel_requested` in the heartbeat response; SDKs surface this via
+         language-idiomatic mechanisms (context cancellation, exceptions, abort signals).
+      operationId: RequestCancelActivityExecution
       parameters:
         - name: namespace
           in: path
           required: true
           schema:
             type: string
+        - name: activityId
+          in: path
+          required: true
+          schema:
+            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RecordActivityTaskHeartbeatRequest'
+              $ref: '#/components/schemas/RequestCancelActivityExecutionRequest'
         required: true
       responses:
         "200":
@@ -421,24 +488,24 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RecordActivityTaskHeartbeatResponse'
+                $ref: '#/components/schemas/RequestCancelActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/heartbeat-by-id:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/complete:
     post:
       tags:
         - WorkflowService
       description: |-
-        See `RecordActivityTaskHeartbeat`. This version allows clients to record heartbeats by
+        See `RespondActivityTaskCompleted`. 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: RecordActivityTaskHeartbeatById
+      operationId: RespondActivityTaskCompletedById
       parameters:
         - name: namespace
           in: path
@@ -446,11 +513,17 @@ paths:
           required: true
           schema:
             type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to complete
+          required: true
+          schema:
+            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCompletedByIdRequest'
         required: true
       responses:
         "200":
@@ -458,41 +531,34 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCompletedByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/pause:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/fail:
     post:
       tags:
         - WorkflowService
       description: |-
-        PauseActivity pauses the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be paused
-
-         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.
+        See `RecordActivityTaskFailed`. This version allows clients to record failures by
+         namespace/workflow id/activity id instead of task token.
 
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type
-         This API will be deprecated soon and replaced with a newer PauseActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: PauseActivity
+         (-- 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.
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to fail
           required: true
           schema:
             type: string
@@ -500,7 +566,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/PauseActivityRequest'
+              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
         required: true
       responses:
         "200":
@@ -508,42 +574,34 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/PauseActivityResponse'
+                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/reset:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/heartbeat:
     post:
       tags:
         - WorkflowService
       description: |-
-        ResetActivity resets the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be reset.
-
-         Resetting an activity means:
-         * number of attempts will be reset to 0.
-         * activity timeouts will be reset.
-         * if the activity is waiting for retry, and it is not paused or 'keep_paused' is not provided:
-            it will be scheduled immediately (* see 'jitter' flag),
-
-         Flags:
-
-         'jitter': the activity will be scheduled at a random time within the jitter duration.
-         If the activity currently paused it will be unpaused, unless 'keep_paused' flag is provided.
-         'reset_heartbeats': the activity heartbeat timer and heartbeats will be reset.
-         'keep_paused': if the activity is paused, it will remain paused.
+        See `RecordActivityTaskHeartbeat`. This version allows clients to record heartbeats by
+         namespace/workflow id/activity id instead of task token.
 
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type.
-         This API will be deprecated soon and replaced with a newer ResetActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: ResetActivity
+         (-- 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.
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity we're heartbeating
           required: true
           schema:
             type: string
@@ -551,7 +609,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ResetActivityRequest'
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
         required: true
       responses:
         "200":
@@ -559,70 +617,61 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ResetActivityResponse'
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/unpause:
-    post:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/outcome:
+    get:
       tags:
         - WorkflowService
       description: |-
-        UnpauseActivity unpauses the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be unpaused.
-
-         If activity is not paused, this call will have no effect.
-         If the activity was paused while waiting for retry, it will be scheduled immediately (* see 'jitter' flag).
-         Once the activity is unpaused, all timeout timers will be regenerated.
-
-         Flags:
-         'jitter': the activity will be scheduled at a random time within the jitter duration.
-         'reset_attempts': the number of attempts will be reset.
-         'reset_heartbeat': the activity heartbeat timer and heartbeats will be reset.
-
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type
-         This API will be deprecated soon and replaced with a newer UnpauseActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: UnpauseActivity
+        PollActivityExecution long-polls for an activity execution to complete and returns the
+         outcome (result or failure).
+      operationId: PollActivityExecution
       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/UnpauseActivityRequest'
-        required: true
+        - name: activityId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: runId
+          in: query
+          description: Activity run ID. If empty the request targets the latest run.
+          schema:
+            type: string
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UnpauseActivityResponse'
+                $ref: '#/components/schemas/PollActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/update-options:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/resolve-as-canceled:
     post:
       tags:
         - WorkflowService
       description: |-
-        UpdateActivityOptions is called by the client to update the options of an activity by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be updated.
-         This API will be deprecated soon and replaced with a newer UpdateActivityExecutionOptions that is better named and
-         structured to work well for standalone activities.
-      operationId: UpdateActivityOptions
+        See `RespondActivityTaskCanceled`. 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
@@ -630,11 +679,17 @@ paths:
           required: true
           schema:
             type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to confirm is cancelled
+          required: true
+          schema:
+            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/UpdateActivityOptionsRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
         required: true
       responses:
         "200":
@@ -642,24 +697,23 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UpdateActivityOptionsResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/{activityId}:
-    get:
+  /api/v1/namespaces/{namespace}/activities/{activityId}/terminate:
+    post:
       tags:
         - WorkflowService
       description: |-
-        DescribeActivityExecution returns information about an activity execution.
-         It can be used to:
-         - Get current activity info without waiting
-         - Long-poll for next state change and return new activity info
-         Response can optionally include activity input or outcome (if the activity has completed).
-      operationId: DescribeActivityExecution
+        TerminateActivityExecution terminates an existing activity execution immediately.
+
+         Termination does not reach the worker and the activity code cannot react to it. A terminated activity may have a
+         running attempt.
+      operationId: TerminateActivityExecution
       parameters:
         - name: namespace
           in: path
@@ -671,75 +725,48 @@ paths:
           required: true
           schema:
             type: string
-        - name: runId
-          in: query
-          description: Activity run ID. If empty the request targets the latest run.
-          schema:
-            type: string
-        - name: includeInput
-          in: query
-          description: Include the input field in the response.
-          schema:
-            type: boolean
-        - name: includeOutcome
-          in: query
-          description: Include the outcome (result/failure) in the response if the activity has completed.
-          schema:
-            type: boolean
-        - name: longPollToken
-          in: query
-          description: |-
-            Token from a previous DescribeActivityExecutionResponse. If present, long-poll until activity
-             state changes from the state encoded in this token. If absent, return current state immediately.
-             If present, run_id must also be present.
-             Note that activity state may change multiple times between requests, therefore it is not
-             guaranteed that a client making a sequence of long-poll requests will see a complete
-             sequence of state changes.
-          schema:
-            type: string
-            format: bytes
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TerminateActivityExecutionRequest'
+        required: true
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DescribeActivityExecutionResponse'
+                $ref: '#/components/schemas/TerminateActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/activity-complete:
     post:
       tags:
         - WorkflowService
       description: |-
-        StartActivityExecution starts a new activity execution.
+        RespondActivityTaskCompleted is called by workers when they successfully complete an activity
+         task.
 
-         Returns an `ActivityExecutionAlreadyStarted` error if an instance already exists with same activity ID in this namespace
-         unless permitted by the specified ID conflict policy.
-      operationId: StartActivityExecution
+         For workflow activities, 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
-        - name: activityId
-          in: path
-          description: |-
-            Identifier for this activity. Required. This identifier should be meaningful in the user's
-             own system. It must be unique among activities in the same namespace, subject to the rules
-             imposed by id_reuse_policy and id_conflict_policy.
-          required: true
-          schema:
-            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/StartActivityExecutionRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCompletedRequest'
         required: true
       responses:
         "200":
@@ -747,118 +774,109 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/StartActivityExecutionResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCompletedResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/{activityId}/cancel:
-    post:
+  /api/v1/namespaces/{namespace}/activity-count:
+    get:
       tags:
         - WorkflowService
-      description: |-
-        RequestCancelActivityExecution requests cancellation of an activity execution.
-
-         Cancellation is cooperative: this call records the request, but the activity must detect and
-         acknowledge it for the activity to reach CANCELED status. The cancellation signal is
-         delivered via `cancel_requested` in the heartbeat response; SDKs surface this via
-         language-idiomatic mechanisms (context cancellation, exceptions, abort signals).
-      operationId: RequestCancelActivityExecution
+      description: CountActivityExecutions is a visibility API to count activity executions in a specific namespace.
+      operationId: CountActivityExecutions
       parameters:
         - name: namespace
           in: path
           required: true
           schema:
             type: string
-        - name: activityId
-          in: path
-          required: true
+        - name: query
+          in: query
+          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
           schema:
             type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/RequestCancelActivityExecutionRequest'
-        required: true
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RequestCancelActivityExecutionResponse'
+                $ref: '#/components/schemas/CountActivityExecutionsResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/{activityId}/outcome:
-    get:
+  /api/v1/namespaces/{namespace}/activity-fail:
+    post:
       tags:
         - WorkflowService
       description: |-
-        PollActivityExecution long-polls for an activity execution to complete and returns the
-         outcome (result or failure).
-      operationId: PollActivityExecution
+        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
-        - name: activityId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: runId
-          in: query
-          description: Activity run ID. If empty the request targets the latest run.
-          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/PollActivityExecutionResponse'
+                $ref: '#/components/schemas/RespondActivityTaskFailedResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activities/{activityId}/terminate:
+  /api/v1/namespaces/{namespace}/activity-heartbeat:
     post:
       tags:
         - WorkflowService
       description: |-
-        TerminateActivityExecution terminates an existing activity execution immediately.
+        RecordActivityTaskHeartbeat is optionally called by workers while they execute activities.
 
-         Termination does not reach the worker and the activity code cannot react to it. A terminated activity may have a
-         running attempt.
-      operationId: TerminateActivityExecution
+         If a worker fails to heartbeat within the `heartbeat_timeout` interval for the activity task,
+         then the current attempt times out. Depending on RetryPolicy, this may trigger a retry or
+         time out the activity.
+
+         For workflow activities, 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.
+
+         The request may contain response `details` which will be persisted by the server and may be
+         used by the activity to checkpoint progress. The `cancel_requested` field in the response
+         indicates whether cancellation has been requested for the activity.
+      operationId: RecordActivityTaskHeartbeat
       parameters:
         - name: namespace
           in: path
           required: true
           schema:
             type: string
-        - name: activityId
-          in: path
-          required: true
-          schema:
-            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TerminateActivityExecutionRequest'
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatRequest'
         required: true
       responses:
         "200":
@@ -866,37 +884,43 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TerminateActivityExecutionResponse'
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/activity-count:
-    get:
+  /api/v1/namespaces/{namespace}/activity-resolve-as-canceled:
+    post:
       tags:
         - WorkflowService
-      description: CountActivityExecutions is a visibility API to count activity executions in a specific namespace.
-      operationId: CountActivityExecutions
+      description: |-
+        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+
+         For workflow activities, 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
-        - name: query
-          in: query
-          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
-          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/CountActivityExecutionsResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCanceledResponse'
         default:
           description: Default error response
           content:
@@ -1289,21 +1313,51 @@ paths:
           required: true
           schema:
             type: string
-        - name: deployment.seriesName
-          in: query
-          description: |-
-            Different versions of the same worker service/application are related together by having a
-             shared series name.
-             Out of all deployments of a series, one can be designated as the current deployment, which
-             receives new workflow executions and new tasks of workflows with
-             `VERSIONING_BEHAVIOR_AUTO_UPGRADE` versioning behavior.
-          schema:
-            type: string
-        - name: deployment.buildId
+        - name: deployment.seriesName
+          in: query
+          description: |-
+            Different versions of the same worker service/application are related together by having a
+             shared series name.
+             Out of all deployments of a series, one can be designated as the current deployment, which
+             receives new workflow executions and new tasks of workflows with
+             `VERSIONING_BEHAVIOR_AUTO_UPGRADE` versioning behavior.
+          schema:
+            type: string
+        - name: deployment.buildId
+          in: query
+          description: |-
+            Build ID changes with each version of the worker when the worker program code and/or config
+             changes.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetDeploymentReachabilityResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/schedule-count:
+    get:
+      tags:
+        - WorkflowService
+      description: CountSchedules is a visibility API to count schedules in a specific namespace.
+      operationId: CountSchedules
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: query
           in: query
-          description: |-
-            Build ID changes with each version of the worker when the worker program code and/or config
-             changes.
+          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
           schema:
             type: string
       responses:
@@ -1312,7 +1366,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GetDeploymentReachabilityResponse'
+                $ref: '#/components/schemas/CountSchedulesResponse'
         default:
           description: Default error response
           content:
@@ -2763,46 +2817,6 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/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'
   /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}:
     get:
       tags:
@@ -2945,48 +2959,276 @@ paths:
           in: query
           schema:
             type: string
-        - name: maximumPageSize
-          in: query
+        - 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'
+  /api/v1/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'
+  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/trigger-rule:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        TriggerWorkflowRule allows to:
+          * trigger existing rule for a specific workflow execution;
+          * trigger rule for a specific workflow execution without creating a rule;
+         This is useful for one-off operations.
+      operationId: TriggerWorkflowRule
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: execution.workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TriggerWorkflowRuleRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TriggerWorkflowRuleResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
+  /api/v1/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'
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/activities/{activityId}/complete:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RespondActivityTaskCompleted`. 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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to complete
+          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'
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/activities/{activityId}/fail:
+    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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
           schema:
-            type: integer
-            format: int32
-        - name: nextPageToken
-          in: query
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to fail
+          required: true
           schema:
             type: string
-            format: bytes
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
+        required: true
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GetWorkflowExecutionHistoryReverseResponse'
+                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/query/{query.query_type}:
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/activities/{activityId}/heartbeat:
     post:
       tags:
         - WorkflowService
-      description: QueryWorkflow requests a query be executed for a specified workflow execution.
-      operationId: QueryWorkflow
+      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
-        - name: execution.workflow_id
+        - name: workflowId
           in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
           required: true
           schema:
             type: string
-        - name: query.query_type
+        - name: activityId
           in: path
+          description: Id of the activity we're heartbeating
           required: true
           schema:
             type: string
@@ -2994,7 +3236,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/QueryWorkflowRequest'
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
         required: true
       responses:
         "200":
@@ -3002,31 +3244,40 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/QueryWorkflowResponse'
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/workflows/{execution.workflow_id}/trigger-rule:
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/activities/{activityId}/resolve-as-canceled:
     post:
       tags:
         - WorkflowService
       description: |-
-        TriggerWorkflowRule allows to:
-          * trigger existing rule for a specific workflow execution;
-          * trigger rule for a specific workflow execution without creating a rule;
-         This is useful for one-off operations.
-      operationId: TriggerWorkflowRule
+        See `RespondActivityTaskCanceled`. 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
-        - name: execution.workflow_id
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
           in: path
+          description: Id of the activity to confirm is cancelled
           required: true
           schema:
             type: string
@@ -3034,7 +3285,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TriggerWorkflowRuleRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
         required: true
       responses:
         "200":
@@ -3042,32 +3293,37 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TriggerWorkflowRuleResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /api/v1/namespaces/{namespace}/workflows/{workflowId}:
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/pause:
     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
+        Note: This is an experimental API and the behavior may change in a future release.
+         PauseWorkflowExecution pauses the workflow execution specified in the request. Pausing a workflow execution results in
+         - The workflow execution status changes to `PAUSED` and a new WORKFLOW_EXECUTION_PAUSED event is added to the history
+         - No new workflow tasks or activity tasks are dispatched.
+           - Any workflow task currently executing on the worker will be allowed to complete.
+           - Any activity task currently executing will be paused.
+         - All server-side events will continue to be processed by the server.
+         - Queries & Updates on a paused workflow will be rejected.
+      operationId: PauseWorkflowExecution
       parameters:
         - name: namespace
           in: path
+          description: Namespace of the workflow to pause.
           required: true
           schema:
             type: string
         - name: workflowId
           in: path
+          description: ID of the workflow execution to be paused. Required.
           required: true
           schema:
             type: string
@@ -3075,7 +3331,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/StartWorkflowExecutionRequest'
+              $ref: '#/components/schemas/PauseWorkflowExecutionRequest'
         required: true
       responses:
         "200":
@@ -3083,7 +3339,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/StartWorkflowExecutionResponse'
+                $ref: '#/components/schemas/PauseWorkflowExecutionResponse'
         default:
           description: Default error response
           content:
@@ -3144,6 +3400,49 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
+  /api/v1/namespaces/{namespace}/workflows/{workflowId}/unpause:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        Note: This is an experimental API and the behavior may change in a future release.
+         UnpauseWorkflowExecution unpauses a previously paused workflow execution specified in the request.
+         Unpausing a workflow execution results in
+         - The workflow execution status changes to `RUNNING` and a new WORKFLOW_EXECUTION_UNPAUSED event is added to the history
+         - Workflow tasks and activity tasks are resumed.
+      operationId: UnpauseWorkflowExecution
+      parameters:
+        - name: namespace
+          in: path
+          description: Namespace of the workflow to unpause.
+          required: true
+          schema:
+            type: string
+        - name: workflowId
+          in: path
+          description: ID of the workflow execution to be paused. Required.
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UnpauseWorkflowExecutionRequest'
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnpauseWorkflowExecutionResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
   /api/v1/namespaces/{namespace}/workflows/{workflow_execution.workflow_id}/cancel:
     post:
       tags:
@@ -3958,57 +4257,34 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/cancel:
+  /namespaces/{namespace}/activities-deprecated/pause:
     post:
       tags:
         - WorkflowService
       description: |-
-        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+        PauseActivity pauses the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be paused
 
-         For workflow activities, 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 `RespondActivityTaskCanceled`. This version allows clients to record failures by
-         namespace/workflow id/activity id instead of task token.
+         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: RespondActivityTaskCanceledById
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type
+         This API will be deprecated soon and replaced with a newer PauseActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: PauseActivity
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -4016,7 +4292,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
+              $ref: '#/components/schemas/PauseActivityRequest'
         required: true
       responses:
         "200":
@@ -4024,65 +4300,42 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
+                $ref: '#/components/schemas/PauseActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/complete:
+  /namespaces/{namespace}/activities-deprecated/reset:
     post:
       tags:
         - WorkflowService
       description: |-
-        RespondActivityTaskCompleted is called by workers when they successfully complete an activity
-         task.
+        ResetActivity resets the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be reset.
 
-         For workflow activities, 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 `RespondActivityTaskCompleted`. This version allows clients to record completions by
-         namespace/workflow id/activity id instead of task token.
+         Resetting an activity means:
+         * number of attempts will be reset to 0.
+         * activity timeouts will be reset.
+         * if the activity is waiting for retry, and it is not paused or 'keep_paused' is not provided:
+            it will be scheduled immediately (* see 'jitter' flag),
 
-         (-- api-linter: core::0136::prepositions=disabled
-             aip.dev/not-precedent: "By" is used to indicate request type. --)
-      operationId: RespondActivityTaskCompletedById
+         Flags:
+
+         'jitter': the activity will be scheduled at a random time within the jitter duration.
+         If the activity currently paused it will be unpaused, unless 'keep_paused' flag is provided.
+         'reset_heartbeats': the activity heartbeat timer and heartbeats will be reset.
+         'keep_paused': if the activity is paused, it will remain paused.
+
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type.
+         This API will be deprecated soon and replaced with a newer ResetActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: ResetActivity
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -4090,7 +4343,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskCompletedByIdRequest'
+              $ref: '#/components/schemas/ResetActivityRequest'
         required: true
       responses:
         "200":
@@ -4098,27 +4351,38 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskCompletedByIdResponse'
+                $ref: '#/components/schemas/ResetActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/fail:
+  /namespaces/{namespace}/activities-deprecated/unpause:
     post:
       tags:
         - WorkflowService
       description: |-
-        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+        UnpauseActivity unpauses the execution of an activity specified by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be unpaused.
 
-         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
+         If activity is not paused, this call will have no effect.
+         If the activity was paused while waiting for retry, it will be scheduled immediately (* see 'jitter' flag).
+         Once the activity is unpaused, all timeout timers will be regenerated.
+
+         Flags:
+         'jitter': the activity will be scheduled at a random time within the jitter duration.
+         'reset_attempts': the number of attempts will be reset.
+         'reset_heartbeat': the activity heartbeat timer and heartbeats will be reset.
+
+         Returns a `NotFound` error if there is no pending activity with the provided ID or type
+         This API will be deprecated soon and replaced with a newer UnpauseActivityExecution that is better named and
+         structured to work well for standalone activities.
+      operationId: UnpauseActivity
       parameters:
         - name: namespace
           in: path
+          description: Namespace of the workflow which scheduled this activity.
           required: true
           schema:
             type: string
@@ -4126,7 +4390,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskFailedRequest'
+              $ref: '#/components/schemas/UnpauseActivityRequest'
         required: true
       responses:
         "200":
@@ -4134,24 +4398,23 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskFailedResponse'
+                $ref: '#/components/schemas/UnpauseActivityResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/fail-by-id:
+  /namespaces/{namespace}/activities-deprecated/update-options:
     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
+        UpdateActivityOptions is called by the client to update the options of an activity by its ID or type.
+         If there are multiple pending activities of the provided type - all of them will be updated.
+         This API will be deprecated soon and replaced with a newer UpdateActivityExecutionOptions that is better named and
+         structured to work well for standalone activities.
+      operationId: UpdateActivityOptions
       parameters:
         - name: namespace
           in: path
@@ -4163,7 +4426,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
+              $ref: '#/components/schemas/UpdateActivityOptionsRequest'
         required: true
       responses:
         "200":
@@ -4171,72 +4434,96 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
+                $ref: '#/components/schemas/UpdateActivityOptionsResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/heartbeat:
-    post:
+  /namespaces/{namespace}/activities/{activityId}:
+    get:
       tags:
         - WorkflowService
       description: |-
-        RecordActivityTaskHeartbeat is optionally called by workers while they execute activities.
-
-         If a worker fails to heartbeat within the `heartbeat_timeout` interval for the activity task,
-         then the current attempt times out. Depending on RetryPolicy, this may trigger a retry or
-         time out the activity.
-
-         For workflow activities, 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.
-
-         The request may contain response `details` which will be persisted by the server and may be
-         used by the activity to checkpoint progress. The `cancel_requested` field in the response
-         indicates whether cancellation has been requested for the activity.
-      operationId: RecordActivityTaskHeartbeat
+        DescribeActivityExecution returns information about an activity execution.
+         It can be used to:
+         - Get current activity info without waiting
+         - Long-poll for next state change and return new activity info
+         Response can optionally include activity input or outcome (if the activity has completed).
+      operationId: DescribeActivityExecution
       parameters:
         - name: namespace
           in: path
           required: true
           schema:
             type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/RecordActivityTaskHeartbeatRequest'
-        required: true
+        - name: activityId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: runId
+          in: query
+          description: Activity run ID. If empty the request targets the latest run.
+          schema:
+            type: string
+        - name: includeInput
+          in: query
+          description: Include the input field in the response.
+          schema:
+            type: boolean
+        - name: includeOutcome
+          in: query
+          description: Include the outcome (result/failure) in the response if the activity has completed.
+          schema:
+            type: boolean
+        - name: longPollToken
+          in: query
+          description: |-
+            Token from a previous DescribeActivityExecutionResponse. If present, long-poll until activity
+             state changes from the state encoded in this token. If absent, return current state immediately.
+             If present, run_id must also be present.
+             Note that activity state may change multiple times between requests, therefore it is not
+             guaranteed that a client making a sequence of long-poll requests will see a complete
+             sequence of state changes.
+          schema:
+            type: string
+            format: bytes
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RecordActivityTaskHeartbeatResponse'
+                $ref: '#/components/schemas/DescribeActivityExecutionResponse'
         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.
+        StartActivityExecution starts a new activity execution.
 
-         (-- api-linter: core::0136::prepositions=disabled
-             aip.dev/not-precedent: "By" is used to indicate request type. --)
-      operationId: RecordActivityTaskHeartbeatById
+         Returns an `ActivityExecutionAlreadyStarted` error if an instance already exists with same activity ID in this namespace
+         unless permitted by the specified ID conflict policy.
+      operationId: StartActivityExecution
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: |-
+            Identifier for this activity. Required. This identifier should be meaningful in the user's
+             own system. It must be unique among activities in the same namespace, subject to the rules
+             imposed by id_reuse_policy and id_conflict_policy.
           required: true
           schema:
             type: string
@@ -4244,7 +4531,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
+              $ref: '#/components/schemas/StartActivityExecutionRequest'
         required: true
       responses:
         "200":
@@ -4252,41 +4539,33 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
+                $ref: '#/components/schemas/StartActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/pause:
+  /namespaces/{namespace}/activities/{activityId}/cancel:
     post:
       tags:
         - WorkflowService
       description: |-
-        PauseActivity pauses the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be paused
-
-         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.
+        RequestCancelActivityExecution requests cancellation of an activity execution.
 
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type
-         This API will be deprecated soon and replaced with a newer PauseActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: PauseActivity
+         Cancellation is cooperative: this call records the request, but the activity must detect and
+         acknowledge it for the activity to reach CANCELED status. The cancellation signal is
+         delivered via `cancel_requested` in the heartbeat response; SDKs surface this via
+         language-idiomatic mechanisms (context cancellation, exceptions, abort signals).
+      operationId: RequestCancelActivityExecution
       parameters:
         - name: namespace
           in: path
-          description: Namespace of the workflow which scheduled this activity.
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
           required: true
           schema:
             type: string
@@ -4294,7 +4573,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/PauseActivityRequest'
+              $ref: '#/components/schemas/RequestCancelActivityExecutionRequest'
         required: true
       responses:
         "200":
@@ -4302,42 +4581,34 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/PauseActivityResponse'
+                $ref: '#/components/schemas/RequestCancelActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/reset:
+  /namespaces/{namespace}/activities/{activityId}/complete:
     post:
       tags:
         - WorkflowService
       description: |-
-        ResetActivity resets the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be reset.
-
-         Resetting an activity means:
-         * number of attempts will be reset to 0.
-         * activity timeouts will be reset.
-         * if the activity is waiting for retry, and it is not paused or 'keep_paused' is not provided:
-            it will be scheduled immediately (* see 'jitter' flag),
-
-         Flags:
-
-         'jitter': the activity will be scheduled at a random time within the jitter duration.
-         If the activity currently paused it will be unpaused, unless 'keep_paused' flag is provided.
-         'reset_heartbeats': the activity heartbeat timer and heartbeats will be reset.
-         'keep_paused': if the activity is paused, it will remain paused.
+        See `RespondActivityTaskCompleted`. This version allows clients to record completions by
+         namespace/workflow id/activity id instead of task token.
 
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type.
-         This API will be deprecated soon and replaced with a newer ResetActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: ResetActivity
+         (-- 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.
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to complete
           required: true
           schema:
             type: string
@@ -4345,7 +4616,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ResetActivityRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCompletedByIdRequest'
         required: true
       responses:
         "200":
@@ -4353,38 +4624,34 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ResetActivityResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCompletedByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/unpause:
+  /namespaces/{namespace}/activities/{activityId}/fail:
     post:
       tags:
         - WorkflowService
       description: |-
-        UnpauseActivity unpauses the execution of an activity specified by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be unpaused.
-
-         If activity is not paused, this call will have no effect.
-         If the activity was paused while waiting for retry, it will be scheduled immediately (* see 'jitter' flag).
-         Once the activity is unpaused, all timeout timers will be regenerated.
-
-         Flags:
-         'jitter': the activity will be scheduled at a random time within the jitter duration.
-         'reset_attempts': the number of attempts will be reset.
-         'reset_heartbeat': the activity heartbeat timer and heartbeats will be reset.
+        See `RecordActivityTaskFailed`. This version allows clients to record failures by
+         namespace/workflow id/activity id instead of task token.
 
-         Returns a `NotFound` error if there is no pending activity with the provided ID or type
-         This API will be deprecated soon and replaced with a newer UnpauseActivityExecution that is better named and
-         structured to work well for standalone activities.
-      operationId: UnpauseActivity
+         (-- 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.
+          description: Namespace of the workflow which scheduled this activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to fail
           required: true
           schema:
             type: string
@@ -4392,7 +4659,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/UnpauseActivityRequest'
+              $ref: '#/components/schemas/RespondActivityTaskFailedByIdRequest'
         required: true
       responses:
         "200":
@@ -4400,23 +4667,24 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UnpauseActivityResponse'
+                $ref: '#/components/schemas/RespondActivityTaskFailedByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/update-options:
+  /namespaces/{namespace}/activities/{activityId}/heartbeat:
     post:
       tags:
         - WorkflowService
       description: |-
-        UpdateActivityOptions is called by the client to update the options of an activity by its ID or type.
-         If there are multiple pending activities of the provided type - all of them will be updated.
-         This API will be deprecated soon and replaced with a newer UpdateActivityExecutionOptions that is better named and
-         structured to work well for standalone activities.
-      operationId: UpdateActivityOptions
+        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
@@ -4424,11 +4692,17 @@ paths:
           required: true
           schema:
             type: string
+        - name: activityId
+          in: path
+          description: Id of the activity we're heartbeating
+          required: true
+          schema:
+            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/UpdateActivityOptionsRequest'
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdRequest'
         required: true
       responses:
         "200":
@@ -4436,24 +4710,21 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UpdateActivityOptionsResponse'
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/{activityId}:
+  /namespaces/{namespace}/activities/{activityId}/outcome:
     get:
       tags:
         - WorkflowService
       description: |-
-        DescribeActivityExecution returns information about an activity execution.
-         It can be used to:
-         - Get current activity info without waiting
-         - Long-poll for next state change and return new activity info
-         Response can optionally include activity input or outcome (if the activity has completed).
-      operationId: DescribeActivityExecution
+        PollActivityExecution long-polls for an activity execution to complete and returns the
+         outcome (result or failure).
+      operationId: PollActivityExecution
       parameters:
         - name: namespace
           in: path
@@ -4470,62 +4741,40 @@ paths:
           description: Activity run ID. If empty the request targets the latest run.
           schema:
             type: string
-        - name: includeInput
-          in: query
-          description: Include the input field in the response.
-          schema:
-            type: boolean
-        - name: includeOutcome
-          in: query
-          description: Include the outcome (result/failure) in the response if the activity has completed.
-          schema:
-            type: boolean
-        - name: longPollToken
-          in: query
-          description: |-
-            Token from a previous DescribeActivityExecutionResponse. If present, long-poll until activity
-             state changes from the state encoded in this token. If absent, return current state immediately.
-             If present, run_id must also be present.
-             Note that activity state may change multiple times between requests, therefore it is not
-             guaranteed that a client making a sequence of long-poll requests will see a complete
-             sequence of state changes.
-          schema:
-            type: string
-            format: bytes
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DescribeActivityExecutionResponse'
+                $ref: '#/components/schemas/PollActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/activities/{activityId}/resolve-as-canceled:
     post:
       tags:
         - WorkflowService
       description: |-
-        StartActivityExecution starts a new activity execution.
+        See `RespondActivityTaskCanceled`. This version allows clients to record failures by
+         namespace/workflow id/activity id instead of task token.
 
-         Returns an `ActivityExecutionAlreadyStarted` error if an instance already exists with same activity ID in this namespace
-         unless permitted by the specified ID conflict policy.
-      operationId: StartActivityExecution
+         (-- 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
         - name: activityId
           in: path
-          description: |-
-            Identifier for this activity. Required. This identifier should be meaningful in the user's
-             own system. It must be unique among activities in the same namespace, subject to the rules
-             imposed by id_reuse_policy and id_conflict_policy.
+          description: Id of the activity to confirm is cancelled
           required: true
           schema:
             type: string
@@ -4533,7 +4782,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/StartActivityExecutionRequest'
+              $ref: '#/components/schemas/RespondActivityTaskCanceledByIdRequest'
         required: true
       responses:
         "200":
@@ -4541,25 +4790,23 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/StartActivityExecutionResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCanceledByIdResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/{activityId}/cancel:
+  /namespaces/{namespace}/activities/{activityId}/terminate:
     post:
       tags:
         - WorkflowService
       description: |-
-        RequestCancelActivityExecution requests cancellation of an activity execution.
+        TerminateActivityExecution terminates an existing activity execution immediately.
 
-         Cancellation is cooperative: this call records the request, but the activity must detect and
-         acknowledge it for the activity to reach CANCELED status. The cancellation signal is
-         delivered via `cancel_requested` in the heartbeat response; SDKs surface this via
-         language-idiomatic mechanisms (context cancellation, exceptions, abort signals).
-      operationId: RequestCancelActivityExecution
+         Termination does not reach the worker and the activity code cannot react to it. A terminated activity may have a
+         running attempt.
+      operationId: TerminateActivityExecution
       parameters:
         - name: namespace
           in: path
@@ -4575,7 +4822,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/RequestCancelActivityExecutionRequest'
+              $ref: '#/components/schemas/TerminateActivityExecutionRequest'
         required: true
       responses:
         "200":
@@ -4583,35 +4830,65 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/RequestCancelActivityExecutionResponse'
+                $ref: '#/components/schemas/TerminateActivityExecutionResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/{activityId}/outcome:
-    get:
+  /namespaces/{namespace}/activity-complete:
+    post:
       tags:
         - WorkflowService
       description: |-
-        PollActivityExecution long-polls for an activity execution to complete and returns the
-         outcome (result or failure).
-      operationId: PollActivityExecution
+        RespondActivityTaskCompleted is called by workers when they successfully complete an activity
+         task.
+
+         For workflow activities, 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
-        - name: activityId
+      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}/activity-count:
+    get:
+      tags:
+        - WorkflowService
+      description: CountActivityExecutions is a visibility API to count activity executions in a specific namespace.
+      operationId: CountActivityExecutions
+      parameters:
+        - name: namespace
           in: path
           required: true
           schema:
             type: string
-        - name: runId
+        - name: query
           in: query
-          description: Activity run ID. If empty the request targets the latest run.
+          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
           schema:
             type: string
       responses:
@@ -4620,30 +4897,70 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/PollActivityExecutionResponse'
+                $ref: '#/components/schemas/CountActivityExecutionsResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activities/{activityId}/terminate:
+  /namespaces/{namespace}/activity-fail:
     post:
       tags:
         - WorkflowService
       description: |-
-        TerminateActivityExecution terminates an existing activity execution immediately.
+        RespondActivityTaskFailed is called by workers when processing an activity task fails.
 
-         Termination does not reach the worker and the activity code cannot react to it. A terminated activity may have a
-         running attempt.
-      operationId: TerminateActivityExecution
+         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
-        - name: activityId
+      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}/activity-heartbeat:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        RecordActivityTaskHeartbeat is optionally called by workers while they execute activities.
+
+         If a worker fails to heartbeat within the `heartbeat_timeout` interval for the activity task,
+         then the current attempt times out. Depending on RetryPolicy, this may trigger a retry or
+         time out the activity.
+
+         For workflow activities, 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.
+
+         The request may contain response `details` which will be persisted by the server and may be
+         used by the activity to checkpoint progress. The `cancel_requested` field in the response
+         indicates whether cancellation has been requested for the activity.
+      operationId: RecordActivityTaskHeartbeat
+      parameters:
+        - name: namespace
           in: path
           required: true
           schema:
@@ -4652,7 +4969,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TerminateActivityExecutionRequest'
+              $ref: '#/components/schemas/RecordActivityTaskHeartbeatRequest'
         required: true
       responses:
         "200":
@@ -4660,37 +4977,43 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TerminateActivityExecutionResponse'
+                $ref: '#/components/schemas/RecordActivityTaskHeartbeatResponse'
         default:
           description: Default error response
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
-  /namespaces/{namespace}/activity-count:
-    get:
+  /namespaces/{namespace}/activity-resolve-as-canceled:
+    post:
       tags:
         - WorkflowService
-      description: CountActivityExecutions is a visibility API to count activity executions in a specific namespace.
-      operationId: CountActivityExecutions
+      description: |-
+        RespondActivityTaskFailed is called by workers when processing an activity task fails.
+
+         For workflow activities, 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
-        - name: query
-          in: query
-          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
-          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/CountActivityExecutionsResponse'
+                $ref: '#/components/schemas/RespondActivityTaskCanceledResponse'
         default:
           description: Default error response
           content:
@@ -5113,6 +5436,36 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/schedule-count:
+    get:
+      tags:
+        - WorkflowService
+      description: CountSchedules is a visibility API to count schedules in a specific namespace.
+      operationId: CountSchedules
+      parameters:
+        - name: namespace
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: query
+          in: query
+          description: Visibility query, see https://docs.temporal.io/list-filter for the syntax.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CountSchedulesResponse'
+        default:
+          description: Default error response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Status'
   /namespaces/{namespace}/schedules:
     get:
       tags:
@@ -6476,63 +6829,23 @@ paths:
           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
+            format: int32
+        - name: nextPageToken
+          in: query
+          schema:
+            type: string
+            format: bytes
+        - name: query
+          in: query
           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'
+                $ref: '#/components/schemas/ListWorkflowExecutionsResponse'
         default:
           description: Default error response
           content:
@@ -6826,6 +7139,202 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Status'
+  /namespaces/{namespace}/workflows/{workflowId}/activities/{activityId}/complete:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RespondActivityTaskCompleted`. 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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to complete
+          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}/workflows/{workflowId}/activities/{activityId}/fail:
+    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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to fail
+          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}/workflows/{workflowId}/activities/{activityId}/heartbeat:
+    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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity we're heartbeating
+          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}/workflows/{workflowId}/activities/{activityId}/resolve-as-canceled:
+    post:
+      tags:
+        - WorkflowService
+      description: |-
+        See `RespondActivityTaskCanceled`. 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
+        - name: workflowId
+          in: path
+          description: Id of the workflow which scheduled this activity, leave empty to target a standalone activity
+          required: true
+          schema:
+            type: string
+        - name: activityId
+          in: path
+          description: Id of the activity to confirm is cancelled
+          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}/workflows/{workflowId}/pause:
     post:
       tags:
@@ -8568,6 +9077,33 @@ components:
             $ref: '#/components/schemas/Payload'
         count:
           type: string
+    CountSchedulesResponse:
+      type: object
+      properties:
+        count:
+          type: string
+          description: |-
+            If `query` is not grouping by any field, the count is an approximate number
+             of schedules that match the query.
+             If `query` is grouping by a field, the count is simply the sum of the counts
+             of the groups returned in the response. This number can be smaller than the
+             total number of schedules matching the query.
+        groups:
+          type: array
+          items:
+            $ref: '#/components/schemas/CountSchedulesResponse_AggregationGroup'
+          description: |-
+            Contains the groups if the request is grouping by a field.
+             The list might not be complete, and the counts of each group is approximate.
+    CountSchedulesResponse_AggregationGroup:
+      type: object
+      properties:
+        groupValues:
+          type: array
+          items:
+            $ref: '#/components/schemas/Payload'
+        count:
+          type: string
     CountWorkflowExecutionsResponse:
       type: object
       properties:
@@ -9196,63 +9732,6 @@ components:
           type: string
           description: Nexus task queue to route requests to.
       description: Target a worker polling on a Nexus task queue in a specific namespace.
-    ExecuteMultiOperationRequest:
-      type: object
-      properties:
-        namespace:
-          type: string
-        operations:
-          type: array
-          items:
-            $ref: '#/components/schemas/ExecuteMultiOperationRequest_Operation'
-          description: |-
-            List of operations to execute within a single workflow.
-
-             Preconditions:
-             - The list of operations must not be empty.
-             - The workflow ids must match across operations.
-             - The only valid list of operations at this time is [StartWorkflow, UpdateWorkflow], in this order.
-
-             Note that additional operation-specific restrictions have to be considered.
-    ExecuteMultiOperationRequest_Operation:
-      type: object
-      properties:
-        startWorkflow:
-          allOf:
-            - $ref: '#/components/schemas/StartWorkflowExecutionRequest'
-          description: |-
-            Additional restrictions:
-             - setting `cron_schedule` is invalid
-             - setting `request_eager_execution` is invalid
-             - setting `workflow_start_delay` is invalid
-        updateWorkflow:
-          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:
-        responses:
-          type: array
-          items:
-            $ref: '#/components/schemas/ExecuteMultiOperationResponse_Response'
-      description: |-
-        IMPORTANT: For [StartWorkflow, UpdateWorkflow] combination ("Update-with-Start") when both
-           1. the workflow update for the requested update ID has already completed, and
-           2. the workflow for the requested workflow ID has already been closed,
-         then you'll receive
-           - an update response containing the update's outcome, and
-           - a start response with a `status` field that reflects the workflow's current state.
-    ExecuteMultiOperationResponse_Response:
-      type: object
-      properties:
-        startWorkflow:
-          $ref: '#/components/schemas/StartWorkflowExecutionResponse'
-        updateWorkflow:
-          $ref: '#/components/schemas/UpdateWorkflowExecutionResponse'
     ExternalWorkflowExecutionCancelRequestedEventAttributes:
       type: object
       properties:
@@ -10265,6 +10744,14 @@ components:
         standaloneActivities:
           type: boolean
           description: True if the namespace supports standalone activities
+        workerPollCompleteOnShutdown:
+          type: boolean
+          description: |-
+            True if the namespace supports server-side completion of outstanding worker polls on shutdown.
+             When enabled, the server will complete polls for workers that send WorkerInstanceKey in their
+             poll requests and call ShutdownWorker with the same WorkerInstanceKey. The poll will return
+             an empty response. When this flag is true, workers should allow polls to return gracefully
+             rather than terminating any open polls on shutdown.
       description: Namespace capability details. Should contain what features are enabled in a namespace.
     NamespaceInfo_Limits:
       type: object
@@ -10529,6 +11016,7 @@ components:
         operationToken:
           type: string
           description: Operation token - may be empty if the operation completed synchronously.
+      description: Representation of the Temporal SDK NexusOperationError object that is returned to workflow callers.
     NexusOperationScheduledEventAttributes:
       type: object
       properties:
@@ -14796,7 +15284,7 @@ components:
       properties:
         deploymentName:
           type: string
-          description: Required. Worker Deployment name.
+          description: Required when `worker_versioning_mode==VERSIONED`.
         buildId:
           type: string
           description: |-
@@ -16571,12 +17059,17 @@ components:
               - SUGGEST_CONTINUE_AS_NEW_REASON_HISTORY_SIZE_TOO_LARGE
               - SUGGEST_CONTINUE_AS_NEW_REASON_TOO_MANY_HISTORY_EVENTS
               - SUGGEST_CONTINUE_AS_NEW_REASON_TOO_MANY_UPDATES
-              - SUGGEST_CONTINUE_AS_NEW_REASON_TARGET_WORKER_DEPLOYMENT_VERSION_CHANGED
             type: string
             format: enum
           description: |-
             The reason(s) that suggest_continue_as_new is true, if it is.
              Unset if suggest_continue_as_new is false.
+        targetWorkerDeploymentVersionChanged:
+          type: boolean
+          description: |-
+            True if Workflow's Target Worker Deployment Version is different from its Pinned Version and
+             the workflow is Pinned.
+             Experimental.
         historySizeBytes:
           type: string
           description: |-