Skip to content

Conversation

@bergundy
Copy link
Member

@bergundy bergundy commented Feb 11, 2026

💥 BREAKING CHANGE 💥

What changed?

  • Redefined the experimental activity HTTP API paths.
  • The activity operator APIs were explicitly marked as deprecated, they will be redone when we add support for standalone activities.
  • All verbs that didn't have an identifier in the path (e.g. APIs that take a token), were renamed activity-$VERB.
  • All APIs that take identifiers (either within a workflow or for standalone) were restructured to include the identifiers in the path.
  • Chose the name resolve-as-canceled for RespondActivityTaskCanceledById to prevent the collision with cancel with maps to RequestCancelActivityExecution, which matches the path verb for RequestCancelWorkflowExecution.

Why?

The existing API paths have conflicts and aren't usable. Consistency and future proofing.

Breaking changes

Yes, but the HTTP API is experimental.

Server PR

Not needed.

@bergundy bergundy requested review from a team as code owners February 11, 2026 19:36
Copy link
Member

@cretz cretz left a comment

Choose a reason for hiding this comment

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

Can we add a 💥 to PR description and make sure to update release notes with a big compat note in this repo and in api-go?

Copy link

@harani-mukkala harani-mukkala left a comment

Choose a reason for hiding this comment

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

Since this introduces a breaking change to the experimental API, do we have a way to verify that these endpoints haven’t received significant traffic in the past few days?

@bergundy
Copy link
Member Author

These endpoints are not available in Temporal cloud and we can't tell what self-hosted users are doing.

@bergundy bergundy merged commit ad1f87c into temporalio:master Feb 11, 2026
4 checks passed
@bergundy bergundy deleted the redo-activity-http-api-paths branch February 11, 2026 19:57
bergundy added a commit that referenced this pull request Feb 11, 2026
💥 **BREAKING CHANGE** 💥 

**What changed?**

- Redefined the experimental activity HTTP API paths.
- The activity operator APIs were explicitly marked as deprecated, they
will be redone when we add support for standalone activities.
- All verbs that didn't have an identifier in the path (e.g. APIs that
take a token), were renamed `activity-$VERB`.
- All APIs that take identifiers (either within a workflow or for
standalone) were restructured to include the identifiers in the path.
- Chose the name `resolve-as-canceled` for
`RespondActivityTaskCanceledById` to prevent the collision with `cancel`
with maps to `RequestCancelActivityExecution`, which matches the path
verb for `RequestCancelWorkflowExecution`.

**Why?**

The existing API paths have conflicts and aren't usable. Consistency and
future proofing.

**Breaking changes**

Yes, but the HTTP API is experimental.

**Server PR**

Not needed.
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