For the complete documentation index, see /llms.txt. This page is also available as raw Markdown at /activity-operations/delete.md. Append .md to any page URL to fetch its Markdown.

Delete an Activity

View Markdown

Delete terminates the Activity Execution if it's running, then deletes it asynchronously.

When to Delete

• You need an Execution and its result removed before the Namespace Retention Period elapses.
• You want to free an Activity Id for reuse without waiting out retention. See Activity Id Reuse Policy.

Delete isn't available for Workflow Activities.

What happens when you Delete an Activity

If the Execution is still running, it's terminated first, with the same semantics as Terminate: no cleanup runs and progress is discarded. The Execution record is then removed asynchronously, so it may remain visible briefly after the command returns.

Once deleted, the Execution no longer appears in temporal activity describe or temporal activity list, and its Activity Id becomes available for reuse.

CLI usage

temporal activity delete \
  --activity-id my-activity

See the CLI reference for temporal activity for all options.

Important considerations

• Delete is irreversible. The Execution, its inputs, and its result are gone; there's no recovery.
• Deletion is asynchronous. A successful response means the request was accepted, not that the record is already removed.