Workflow
The Dapr.Workflow package provides typed workflows and activities, a hosted worker, and DaprWorkflowClient
for managing durable instances. These guides describe SDK 1.19.0 or later; use Dapr runtime 1.19 for the full
feature set. Installing the package does not configure a workflow state store or start the required runtime services.
dotnet add package Dapr.Workflow
| Task | Guide |
|---|---|
| Register the worker/client, discover types, and configure transport or history caching | Client registration |
| Write deterministic orchestration, activities, retries, timers/events, fan-out, children, and continuation | Author workflows |
| Schedule, wait, signal, suspend/resume, terminate, purge, list, inspect history, or rerun | Management operations |
| Customize JSON or use another serializer | Serialization |
| Route activities, children, and detached workflows to another app | Multi-app workflows |
| Share ancestor history with child workflows | History propagation |
| Evolve deployed workflows using patches or versioned names | Versioning |
| Offload large payloads or pass explicit binary references (alpha) | Data references |
| Explore end-to-end examples | Examples |
Workflow code must remain deterministic during replay. Keep I/O and other nondeterministic work in activities, make external side effects idempotent, and preserve compatible code and payloads for retained workflow histories.
DaprWorkflowClient registration
Configure workflow hosting, discovery, client lifetime, transport limits, and history caching
Learn more →
Author workflows
Use deterministic workflow APIs, activities, retries, timers, events, parallelism, and continuation
Learn more →
Workflow serialization
Configure workflow serialization for the Dapr .NET SDK
Learn more →
Data references (alpha)
Offload large workflow payloads to a binary store and defer reading them with explicit data references
Learn more →
Multi-app workflows
Call activities, children, and detached workflows hosted in another Dapr application
Learn more →
History propagation
Share ancestor workflow execution history with child workflows and activities using the .NET SDK
Learn more →
Workflow management operations
Schedule, inspect, wait for, signal, rerun, and manage workflow instances
Learn more →
Workflow versioning
Learn how to use patch-based and name-based workflow versioning in the Dapr .NET SDK
Learn more →
Workflow examples on GitHub
Explore Dapr Workflow code examples on GitHub
Learn more →