1# Cloudflare Workflows
2 
3Durable multi-step applications with automatic retries, state persistence, and long-running execution.
4 
5## What It Does
6 
7- Chain steps with automatic retry logic
8- Persist state between steps (minutes → weeks)
9- Handle failures without losing progress
10- Wait for external events/approvals
11- Sleep without consuming resources
12 
13**Available:** Free & Paid Workers plans
14 
15## Core Concepts
16 
17**Workflow**: Class extending `WorkflowEntrypoint` with `run` method
18**Instance**: Single execution with unique ID & independent state
19**Steps**: Independently retriable units via `step.do()` - API calls, DB queries, AI invocations
20**State**: Persisted from step returns; step name = cache key
21 
22## Quick Start
23 
24```typescript
25import { WorkflowEntrypoint, WorkflowStep, WorkflowEvent } from 'cloudflare:workers';
26 
27type Env = { MY_WORKFLOW: Workflow; DB: D1Database };
28type Params = { userId: string };
29 
30export class MyWorkflow extends WorkflowEntrypoint<Env, Params> {
31  async run(event: WorkflowEvent<Params>, step: WorkflowStep) {
32    const user = await step.do('fetch user', async () => {
33      return await this.env.DB.prepare('SELECT * FROM users WHERE id = ?')
34        .bind(event.payload.userId).first();
35    });
36    
37    await step.sleep('wait 7 days', '7 days');
38    
39    await step.do('send reminder', async () => {
40      await sendEmail(user.email, 'Reminder!');
41    });
42  }
43}
44```
45 
46## Key Features
47 
48- **Durability**: Failed steps don't re-run successful ones
49- **Retries**: Configurable backoff (constant/linear/exponential)
50- **Events**: `waitForEvent()` for webhooks/approvals (configurable timeout)
51- **Sleep**: `sleep()` / `sleepUntil()` for scheduling
52- **Parallel**: `Promise.all()` for concurrent steps
53- **Idempotency**: Check-then-execute patterns
54 
55## Retrieval
56 
57These reference files cover API shapes, code patterns, and debugging — things that are stable. For **limits, pricing, and other values that change**, always fetch the latest from the official docs:
58 
59- **Limits:** https://developers.cloudflare.com/workflows/reference/limits/
60- **Pricing:** https://developers.cloudflare.com/workflows/reference/pricing/
61- **Workers API:** https://developers.cloudflare.com/workflows/build/workers-api/
62 
63## Reading Order
64 
65**Getting Started:** configuration.md → api.md → patterns.md  
66**Troubleshooting:** gotchas.md
67 
68## In This Reference
69- [configuration.md](./configuration.md) - wrangler.jsonc setup, step config, bindings
70- [api.md](./api.md) - Step APIs, instance management, sleep/parameters
71- [patterns.md](./patterns.md) - Common workflows, testing, orchestration
72- [gotchas.md](./gotchas.md) - Timeouts, limits, debugging strategies
73 
74## See Also
75- [durable-objects](../durable-objects/) - Alternative stateful approach
76- [queues](../queues/) - Message-driven workflows
77- [workers](../workers/) - Entry point for workflow instances
78