Ephemeral Workflows

Workflows include an isEphemeral flag, which defaults to false if the key is not present in the workflow.

id: 00000000-0000-4000-A000-000000000015
name: Transcribe Audio (Speakers)
isEphemeral: true
createdAt: 2026-06-11T00:00:00Z
updatedAt: 2026-06-27T00:00:00Z
steps:
- id: 00000000-0000-4000-B000-000000000077
  templateId: diarised_transcription
  outputRoleOverride: finalDocument

A very simple, one step workflow that will leave no files on the system.

An ephemeral workflow will be processed and leave no trace behind. An ephemeral workflow will complete, push the final output into any enabled output adapters, and remove inputs, steps and outputs from the file system.

This flag is mostly used in local HTTP Server mode, where the operator of the Tanuki machine is not performing workflows.

Ephemeral mode does experience a very slight but consistent performance hit, but even at scale it is imperceptible.