Skip to content

Clarify Standalone Activity start Action counting#4704

Draft
tekkaya wants to merge 2 commits into
mainfrom
gokhan/standalone-activity-already-started-not-billed
Draft

Clarify Standalone Activity start Action counting#4704
tekkaya wants to merge 2 commits into
mainfrom
gokhan/standalone-activity-already-started-not-billed

Conversation

@tekkaya

@tekkaya tekkaya commented Jun 11, 2026

Copy link
Copy Markdown

What does this PR do?

Clarifies in the Temporal Cloud Actions reference (docs/evaluate/temporal-cloud/actions.mdx, Activity section) that a Start Standalone Activity request which returns an already-running Activity (de-duplicated by Activity ID) does not count as an Action — unless the start request tries to attach a callback to the running Activity, for example within a Nexus handler using the USE_EXISTING conflict policy.

Notes to reviewers

⚠️ Please hold merge until the behavior is live. This documents a billing behavior change that is still rolling out to Temporal Cloud — don't merge until it is fully live in production. I'll follow up on this PR when it's ready.

@CLAassistant

CLAassistant commented Jun 11, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jun 12, 2026 8:00pm

Request Review

@github-actions

github-actions Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

@tekkaya tekkaya force-pushed the gokhan/standalone-activity-already-started-not-billed branch from a39e883 to d7c3ca4 Compare June 11, 2026 21:11
@tekkaya tekkaya force-pushed the gokhan/standalone-activity-already-started-not-billed branch from d7c3ca4 to 9681f3f Compare June 11, 2026 21:17
@tekkaya tekkaya requested a review from nikki-dag June 11, 2026 21:18
@tekkaya tekkaya force-pushed the gokhan/standalone-activity-already-started-not-billed branch from 9681f3f to 35257ac Compare June 11, 2026 21:44
- **Activity started or retried**. Occurs each time an Activity is started or retried.
- **Standalone Activity started**. Occurs when a [Standalone Activity](/standalone-activity) is started.
- De-duplicated Standalone Activity starts that return an already-running Activity (sharing an Activity ID) do _not_
count as an Action, unless the start request attaches conflict options to the running Activity.

@bergundy bergundy Jun 12, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Conflict options" isn't a concept that is exposed to users. It'd be better to phrase it as "unless the start request tries to attach a callback to a running execution, for example when used within a Nexus handler with USE_EXISTING conflict policy".

tekkaya and others added 2 commits June 12, 2026 12:59
Document that a Start Standalone Activity request which returns an
already-running Activity (de-duplicated by Activity ID) is not counted as an
Action, unless the start request attaches conflict options to the running
Activity. This mirrors the existing de-dup wording for Workflow starts.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Per review, "conflict options" is not a user-facing concept. Describe the
billable case as attaching a callback to the running Activity (e.g. within a
Nexus handler using the USE_EXISTING conflict policy).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tekkaya tekkaya force-pushed the gokhan/standalone-activity-already-started-not-billed branch from ae62196 to 45727f0 Compare June 12, 2026 19:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants