diff --git a/openapi/openapiv2.json b/openapi/openapiv2.json index ed8583797..2e5342ec8 100644 --- a/openapi/openapiv2.json +++ b/openapi/openapiv2.json @@ -11731,7 +11731,7 @@ "properties": { "runId": { "type": "string", - "description": "Run ID of the workflow or standalone activity." + "description": "Run ID of the workflow or standalone activity. If empty, targets the latest run." }, "identity": { "type": "string", @@ -11873,7 +11873,7 @@ "properties": { "runId": { "type": "string", - "description": "Activity run ID, targets the latest run if run_id is empty." + "description": "Activity run ID. If empty, targets the latest run." }, "identity": { "type": "string", @@ -11995,7 +11995,7 @@ "properties": { "runId": { "type": "string", - "description": "Run ID of the workflow or standalone activity." + "description": "Run ID of the workflow or standalone activity. If empty, targets the latest run." }, "identity": { "type": "string", @@ -12016,6 +12016,10 @@ "resourceId": { "type": "string", "description": "Resource ID for routing. Contains \"workflow:{workflow_id}\" for workflow activities or \"activity:{activity_id}\" for standalone activities." + }, + "requestId": { + "type": "string", + "description": "Used to de-dupe reset requests." } } }, @@ -12859,7 +12863,7 @@ "properties": { "runId": { "type": "string", - "description": "Activity run ID, targets the latest run if run_id is empty." + "description": "Activity run ID. If empty, targets the latest run." }, "identity": { "type": "string", @@ -13001,7 +13005,7 @@ "properties": { "runId": { "type": "string", - "description": "Run ID of the workflow or standalone activity." + "description": "Run ID of the workflow or standalone activity. If empty, targets the latest run." }, "identity": { "type": "string", @@ -13026,6 +13030,10 @@ "resourceId": { "type": "string", "description": "Resource ID for routing. Contains \"workflow:{workflow_id}\" for workflow activities or \"activity:{activity_id}\" for standalone activities." + }, + "requestId": { + "type": "string", + "description": "Used to de-dupe unpause requests." } } }, @@ -13055,7 +13063,7 @@ "properties": { "runId": { "type": "string", - "description": "Run ID of the workflow or standalone activity." + "description": "Run ID of the workflow or standalone activity. If empty, targets the latest run." }, "identity": { "type": "string", @@ -13076,6 +13084,10 @@ "resourceId": { "type": "string", "description": "Resource ID for routing. Contains \"workflow:{workflow_id}\" for workflow activities or \"activity:{activity_id}\" for standalone activities." + }, + "requestId": { + "type": "string", + "description": "Used to de-dupe update requests." } } }, diff --git a/openapi/openapiv3.yaml b/openapi/openapiv3.yaml index c7c3f9e87..91989fbf1 100644 --- a/openapi/openapiv3.yaml +++ b/openapi/openapiv3.yaml @@ -14228,7 +14228,7 @@ components: description: The ID of the activity to target. runId: type: string - description: Run ID of the workflow or standalone activity. + description: Run ID of the workflow or standalone activity. If empty, targets the latest run. identity: type: string description: The identity of the client who initiated this request. @@ -15269,7 +15269,7 @@ components: type: string runId: type: string - description: Activity run ID, targets the latest run if run_id is empty. + description: Activity run ID. If empty, targets the latest run. identity: type: string description: The identity of the worker/client. @@ -15489,7 +15489,7 @@ components: description: The ID of the activity to target. runId: type: string - description: Run ID of the workflow or standalone activity. + description: Run ID of the workflow or standalone activity. If empty, targets the latest run. identity: type: string description: The identity of the client who initiated this request. @@ -15511,6 +15511,9 @@ components: resourceId: type: string description: Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. + requestId: + type: string + description: Used to de-dupe reset requests. ResetActivityExecutionResponse: type: object properties: {} @@ -17849,7 +17852,7 @@ components: type: string runId: type: string - description: Activity run ID, targets the latest run if run_id is empty. + description: Activity run ID. If empty, targets the latest run. identity: type: string description: The identity of the worker/client. @@ -18165,7 +18168,7 @@ components: description: The ID of the activity to target. runId: type: string - description: Run ID of the workflow or standalone activity. + description: Run ID of the workflow or standalone activity. If empty, targets the latest run. identity: type: string description: The identity of the client who initiated this request. @@ -18185,6 +18188,9 @@ components: resourceId: type: string description: Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. + requestId: + type: string + description: Used to de-dupe unpause requests. UnpauseActivityExecutionResponse: type: object properties: {} @@ -18266,7 +18272,7 @@ components: description: The ID of the activity to target. runId: type: string - description: Run ID of the workflow or standalone activity. + description: Run ID of the workflow or standalone activity. If empty, targets the latest run. identity: type: string description: The identity of the client who initiated this request @@ -18289,6 +18295,9 @@ components: resourceId: type: string description: Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. + requestId: + type: string + description: Used to de-dupe update requests. UpdateActivityExecutionOptionsResponse: type: object properties: diff --git a/temporal/api/workflowservice/v1/request_response.proto b/temporal/api/workflowservice/v1/request_response.proto index 1c02fd570..871ea71f2 100644 --- a/temporal/api/workflowservice/v1/request_response.proto +++ b/temporal/api/workflowservice/v1/request_response.proto @@ -2186,7 +2186,7 @@ message UpdateActivityExecutionOptionsRequest { string workflow_id = 2; // The ID of the activity to target. string activity_id = 3; - // Run ID of the workflow or standalone activity. + // Run ID of the workflow or standalone activity. If empty, targets the latest run. string run_id = 4; // The identity of the client who initiated this request @@ -2207,6 +2207,9 @@ message UpdateActivityExecutionOptionsRequest { // Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. string resource_id = 9; + + // Used to de-dupe update requests. + string request_id = 10; } // Deprecated. Use `UpdateActivityExecutionOptionsResponse`. @@ -2256,7 +2259,7 @@ message PauseActivityExecutionRequest { string workflow_id = 2; // The ID of the activity to target. string activity_id = 3; - // Run ID of the workflow or standalone activity. + // Run ID of the workflow or standalone activity. If empty, targets the latest run. string run_id = 4; // The identity of the client who initiated this request. @@ -2318,7 +2321,7 @@ message UnpauseActivityExecutionRequest { string workflow_id = 2; // The ID of the activity to target. string activity_id = 3; - // Run ID of the workflow or standalone activity. + // Run ID of the workflow or standalone activity. If empty, targets the latest run. string run_id = 4; // The identity of the client who initiated this request. @@ -2338,6 +2341,9 @@ message UnpauseActivityExecutionRequest { // Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. string resource_id = 10; + + // Used to de-dupe unpause requests. + string request_id = 11; } // Deprecated. Use `UnpauseActivityExecutionResponse`. @@ -2394,7 +2400,7 @@ message ResetActivityExecutionRequest { string workflow_id = 2; // The ID of the activity to target. string activity_id = 3; - // Run ID of the workflow or standalone activity. + // Run ID of the workflow or standalone activity. If empty, targets the latest run. string run_id = 4; // The identity of the client who initiated this request. @@ -2414,6 +2420,9 @@ message ResetActivityExecutionRequest { // Resource ID for routing. Contains "workflow:{workflow_id}" for workflow activities or "activity:{activity_id}" for standalone activities. string resource_id = 9; + + // Used to de-dupe reset requests. + string request_id = 10; } // Deprecated. Use `ResetActivityExecutionRequest`. @@ -3559,7 +3568,7 @@ message CountNexusOperationExecutionsResponse { message RequestCancelActivityExecutionRequest { string namespace = 1; string activity_id = 2; - // Activity run ID, targets the latest run if run_id is empty. + // Activity run ID. If empty, targets the latest run. string run_id = 3; // The identity of the worker/client. string identity = 4; @@ -3576,7 +3585,7 @@ message RequestCancelActivityExecutionResponse { message TerminateActivityExecutionRequest { string namespace = 1; string activity_id = 2; - // Activity run ID, targets the latest run if run_id is empty. + // Activity run ID. If empty, targets the latest run. string run_id = 3; // The identity of the worker/client. string identity = 4;