Clarify run ID may not be current in ResetWorkflowExecutionRequest (#473)

---------

Co-authored-by: Dan Davison <[email protected]>

Author: bergundy

openapi/openapiv2.json

@@ -5504,7 +5504,8 @@
               "type": "string"
             }
           },
-          "description": "Identifies a specific workflow within a namespace. Practically speaking, because run_id is a\nuuid, a workflow execution is globally unique. Note that many commands allow specifying an empty\nrun id as a way of saying \"target the latest run of the workflow\"."
+          "description": "The workflow to reset. If this contains a run ID then the workflow will be reset back to the\nprovided event ID in that run. Otherwise it will be reset to the provided event ID in the\ncurrent run. In all cases the current run will be terminated and a new run started.",
+          "title": "The workflow to reset. If this contains a run ID then the workflow will be reset back to the\nprovided event ID in that run. Otherwise it will be reset to the provided event ID in the\ncurrent run. In all cases the current run will be terminated and a new run started."
         },
         "reason": {
           "type": "string"

openapi/openapiv3.yaml

@@ -7498,7 +7498,12 @@ components:
         namespace:
           type: string
         workflowExecution:
-          $ref: '#/components/schemas/WorkflowExecution'
+          allOf:
+            - $ref: '#/components/schemas/WorkflowExecution'
+          description: |-
+            The workflow to reset. If this contains a run ID then the workflow will be reset back to the
+             provided event ID in that run. Otherwise it will be reset to the provided event ID in the
+             current run. In all cases the current run will be terminated and a new run started.
         reason:
           type: string
         workflowTaskFinishEventId:

temporal/api/workflowservice/v1/request_response.proto

@@ -733,6 +733,9 @@ message SignalWithStartWorkflowExecutionResponse {
 
 message ResetWorkflowExecutionRequest {
     string namespace = 1;
+    // The workflow to reset. If this contains a run ID then the workflow will be reset back to the
+    // provided event ID in that run. Otherwise it will be reset to the provided event ID in the
+    // current run. In all cases the current run will be terminated and a new run started.
     temporal.api.common.v1.WorkflowExecution workflow_execution = 2;
     string reason = 3;
     // The id of a `WORKFLOW_TASK_COMPLETED`,`WORKFLOW_TASK_TIMED_OUT`, `WORKFLOW_TASK_FAILED`, or