From a14037052df0703a5793216118690ca0f46cffee Mon Sep 17 00:00:00 2001 From: Duncan Mackenzie Date: Thu, 10 Sep 2026 08:42:30 -0700 Subject: [PATCH] Fix Standalone Activities/Operations doc bugs: RunID optionality and List Filter status field The Go Standalone Activities guide said GetActivityHandle requires both ActivityID and RunID, but RunID is optional in the SDK: an empty RunID targets the latest Activity Execution with that Activity Id. The Go guide's List Filter example also used the visibility attribute `Status`, which isn't registered; the correct attribute is `ExecutionStatus` (per go.temporal.io/sdk and the Temporal Server's search attribute definitions). The same `Status` mistake was copied into the Standalone Activities guides for Python, TypeScript, Java, .NET, and Ruby, the Celery migration guide, and the Standalone Operations (Nexus) guides for Go, Python, TypeScript, and .NET. --- docs/develop/dotnet/activities/standalone-activities.mdx | 2 +- docs/develop/dotnet/nexus/standalone-operations.mdx | 2 +- docs/develop/go/activities/standalone-activities.mdx | 5 +++-- docs/develop/go/nexus/standalone-operations.mdx | 2 +- docs/develop/java/activities/standalone-activities.mdx | 2 +- docs/develop/python/activities/standalone-activities.mdx | 2 +- docs/develop/python/nexus/standalone-operations.mdx | 2 +- docs/develop/ruby/activities/standalone-activities.mdx | 2 +- docs/develop/typescript/activities/standalone-activities.mdx | 2 +- docs/develop/typescript/nexus/standalone-operations.mdx | 2 +- docs/guides/celery-to-standalone-activity.mdx | 2 +- 11 files changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/develop/dotnet/activities/standalone-activities.mdx b/docs/develop/dotnet/activities/standalone-activities.mdx index da70f9028d..9620f43695 100644 --- a/docs/develop/dotnet/activities/standalone-activities.mdx +++ b/docs/develop/dotnet/activities/standalone-activities.mdx @@ -163,7 +163,7 @@ temporal activity list ``` The query parameter accepts the same [List Filter](/list-filter) syntax used for [Workflow -Visibility](/visibility). For example, `"ActivityType = 'ComposeGreeting' AND Status = 'Running'"`. +Visibility](/visibility). For example, `"ActivityType = 'ComposeGreeting' AND ExecutionStatus = 'Running'"`. ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/dotnet/nexus/standalone-operations.mdx b/docs/develop/dotnet/nexus/standalone-operations.mdx index 7b3aaf5944..81178fc523 100644 --- a/docs/develop/dotnet/nexus/standalone-operations.mdx +++ b/docs/develop/dotnet/nexus/standalone-operations.mdx @@ -195,7 +195,7 @@ await foreach (var execution in client.ListNexusOperationsAsync( ``` The query string accepts [List Filter](/list-filter) syntax. For example, -`"Endpoint = 'my-endpoint' AND Status = 'Running'"`. +`"Endpoint = 'my-endpoint' AND ExecutionStatus = 'Running'"`. Or use the Temporal CLI: diff --git a/docs/develop/go/activities/standalone-activities.mdx b/docs/develop/go/activities/standalone-activities.mdx index 62fbbb662c..5e4b583b2a 100644 --- a/docs/develop/go/activities/standalone-activities.mdx +++ b/docs/develop/go/activities/standalone-activities.mdx @@ -73,7 +73,8 @@ temporal activity result --activity-id standalone_activity_helloworld_ActivityID Use `client.GetActivityHandle()` to create a handle to a previously started Standalone Activity. This is analogous to `client.GetWorkflow()` for Workflow Executions. -Both `ActivityID` and `RunID` are required. +`ActivityID` is required. `RunID` is optional. Leave it empty to target the latest Activity Execution with +the given Activity Id. ```go handle := c.GetActivityHandle(client.GetActivityHandleOptions{ @@ -121,7 +122,7 @@ temporal activity list ``` The `Query` field accepts the same [List Filter](/list-filter) syntax used for Workflow Visibility. For example, -`"ActivityType = 'Activity' AND Status = 'Running'"`. +`"ActivityType = 'Activity' AND ExecutionStatus = 'Running'"`. ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/go/nexus/standalone-operations.mdx b/docs/develop/go/nexus/standalone-operations.mdx index fd75833089..c60c81e9c9 100644 --- a/docs/develop/go/nexus/standalone-operations.mdx +++ b/docs/develop/go/nexus/standalone-operations.mdx @@ -186,7 +186,7 @@ for metadata, err := range resp.Results { ``` The `Query` field accepts [List Filter](/list-filter) syntax. For example, -`"Endpoint = 'my-endpoint' AND Status = 'Running'"`. +`"Endpoint = 'my-endpoint' AND ExecutionStatus = 'Running'"`. Or use the Temporal CLI: diff --git a/docs/develop/java/activities/standalone-activities.mdx b/docs/develop/java/activities/standalone-activities.mdx index 24d316b4f8..8f62cef7e7 100644 --- a/docs/develop/java/activities/standalone-activities.mdx +++ b/docs/develop/java/activities/standalone-activities.mdx @@ -164,7 +164,7 @@ Or use the Temporal CLI: ``` The query parameter accepts the same [List Filter](/list-filter) syntax used for [Workflow -Visibility](/visibility). For example, `ActivityType = 'composeGreeting' AND Status = 'Running'`. +Visibility](/visibility). For example, `ActivityType = 'composeGreeting' AND ExecutionStatus = 'Running'`. ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/python/activities/standalone-activities.mdx b/docs/develop/python/activities/standalone-activities.mdx index 5f06dffdd1..2c78bfa5ea 100644 --- a/docs/develop/python/activities/standalone-activities.mdx +++ b/docs/develop/python/activities/standalone-activities.mdx @@ -162,7 +162,7 @@ temporal activity list ``` The query parameter accepts the same [List Filter](/list-filter) syntax used for [Workflow -Visibility](/visibility). For example, "ActivityType = 'MyActivity' AND Status = 'Running'". +Visibility](/visibility). For example, "ActivityType = 'MyActivity' AND ExecutionStatus = 'Running'". ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/python/nexus/standalone-operations.mdx b/docs/develop/python/nexus/standalone-operations.mdx index c31f80ce79..2dc6da2937 100644 --- a/docs/develop/python/nexus/standalone-operations.mdx +++ b/docs/develop/python/nexus/standalone-operations.mdx @@ -186,7 +186,7 @@ async for op in client.list_nexus_operations(query): ``` The `query` parameter accepts [List Filter](/list-filter) syntax. For example, -`"Endpoint = 'my-endpoint' AND Status = 'Running'"`. +`"Endpoint = 'my-endpoint' AND ExecutionStatus = 'Running'"`. Or use the Temporal CLI: diff --git a/docs/develop/ruby/activities/standalone-activities.mdx b/docs/develop/ruby/activities/standalone-activities.mdx index 8ff5fe3b5e..3cde5c53ea 100644 --- a/docs/develop/ruby/activities/standalone-activities.mdx +++ b/docs/develop/ruby/activities/standalone-activities.mdx @@ -155,7 +155,7 @@ temporal activity list ``` The query parameter accepts the same [List Filter](/list-filter) syntax used for [Workflow -Visibility](/visibility). For example, `ActivityType = 'ComposeGreeting' AND Status = 'Running'`. +Visibility](/visibility). For example, `ActivityType = 'ComposeGreeting' AND ExecutionStatus = 'Running'`. ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/typescript/activities/standalone-activities.mdx b/docs/develop/typescript/activities/standalone-activities.mdx index 330be0cc20..1b29a8c68d 100644 --- a/docs/develop/typescript/activities/standalone-activities.mdx +++ b/docs/develop/typescript/activities/standalone-activities.mdx @@ -151,7 +151,7 @@ temporal activity list ``` The query parameter accepts the same [List Filter](/list-filter) syntax used for [Workflow -Visibility](/visibility). For example, "ActivityType = 'MyActivity' AND Status = 'Running'". +Visibility](/visibility). For example, "ActivityType = 'MyActivity' AND ExecutionStatus = 'Running'". ## Count Standalone Activities {/* #count-activities */} diff --git a/docs/develop/typescript/nexus/standalone-operations.mdx b/docs/develop/typescript/nexus/standalone-operations.mdx index ae4c5199bf..00468b1290 100644 --- a/docs/develop/typescript/nexus/standalone-operations.mdx +++ b/docs/develop/typescript/nexus/standalone-operations.mdx @@ -188,7 +188,7 @@ for await (const op of client.nexus.list({ query })) { ``` The `query` parameter accepts [List Filter](/list-filter) syntax. For example, -`"Endpoint = 'my-endpoint' AND Status = 'Running'"`. +`"Endpoint = 'my-endpoint' AND ExecutionStatus = 'Running'"`. Or use the Temporal CLI: diff --git a/docs/guides/celery-to-standalone-activity.mdx b/docs/guides/celery-to-standalone-activity.mdx index 79f9d6149d..47db20eb25 100644 --- a/docs/guides/celery-to-standalone-activity.mdx +++ b/docs/guides/celery-to-standalone-activity.mdx @@ -428,7 +428,7 @@ welcome-email-42 | send_welcome_email | Completed Total activities: 1 ``` -The `query` uses the same [List Filter](/list-filter) syntax as Workflow visibility, so you can filter by attributes such as `ActivityType` and `Status` — for example, `"ActivityType = 'send_welcome_email' AND Status = 'Running'"`. These calls return only Standalone Activities; Activities running inside Workflows are excluded. The Temporal CLI offers the same views with `temporal activity list` and `temporal activity count`. +The `query` uses the same [List Filter](/list-filter) syntax as Workflow visibility, so you can filter by attributes such as `ActivityType` and `ExecutionStatus` — for example, `"ActivityType = 'send_welcome_email' AND ExecutionStatus = 'Running'"`. These calls return only Standalone Activities; Activities running inside Workflows are excluded. The Temporal CLI offers the same views with `temporal activity list` and `temporal activity count`. ## Step 10: When to use a Workflow