Versions & Checkpoints

Checkpoints

A checkpoint is a block-level snapshot of a prompt. Use checkpoints to:

• Save your work before making changes
• Track prompt iterations
• Compare different versions of a prompt

Checkpoints are lightweight — create as many as you need during development.

Versions

A version is a flow-level immutable snapshot. When you publish a version:

• The entire tree structure is frozen
• All block prompts, schemas, and configs are captured
• The version gets a unique ID

Versions cannot be modified after publishing.

Production Version

The production version is the version that executes when the slug API is called.

Flow: "classify-intent"
  ├── Version 1 (initial)
  ├── Version 2 (improved prompt)
  └── Version 3 (added block) ← PRODUCTION

Setting Production

After publishing a version, set it as production to make it live:

publish_version(flow_id, note="v3: added validation block")
  → version_id: "ver-xyz789"

set_production_version(flow_id, version_id="ver-xyz789")
  → Now live at /seq/{org}/{project}/{flow}/execute

Versioned URLs

Call a specific version directly (bypassing the production setting):

POST /seq/{org}/{project}/{flow}/v2/execute

Workflow

Edit prompt → Checkpoint → Edit more → Publish version → Set production

1. Edit: Modify block prompts and configuration
2. Checkpoint: Save block-level snapshots during development
3. Publish: Freeze the entire flow as an immutable version
4. Deploy: Set the published version as production