Orchestrations

Orchestrations manage durable, long-running batch processes with pause, resume, and cancel support. Use orchestrations for large-scale AI operations that need state management and error recovery.

What is an orchestration?

An orchestration is a coordinated execution of multiple operations with checkpointing and lifecycle management. Orchestrations track progress across batches and can be paused or resumed without losing state.

This makes them ideal for operations that process large volumes of data, where you need visibility into progress and the ability to intervene if something goes wrong.

Viewing orchestrations

Navigate to Orchestrations in the dashboard sidebar. The list shows each orchestration’s status, creation time, and batch count.

Each row provides a quick summary so you can monitor all active orchestrations at a glance.

Orchestration detail

Click an orchestration to view its batches, progress, and results. The detail view shows:

• Overall progress as a percentage of completed batches
• Individual batch status and timing
• Error details for any failed batches
• Lifecycle controls for managing the orchestration

Lifecycle management

You can control a running orchestration using the lifecycle actions available in the detail view.

Action	Description
Pause	Temporarily halt processing. The orchestration stops at the next safe checkpoint and can be resumed later.
Resume	Continue a paused orchestration from where it stopped.
Cancel	Stop the orchestration permanently. Cancelled orchestrations cannot be resumed.

Caution

Cancelling an orchestration is irreversible. If you are unsure whether you want to stop processing, use Pause instead so you can resume later.

Status values

Orchestrations move through the following statuses during their lifecycle.

Status	Description
pending	Queued, not yet started
running	Actively processing batches
paused	Temporarily halted, can be resumed
completed	All batches finished successfully
failed	Encountered an unrecoverable error
cancelled	Permanently stopped by user

Status monitoring

Poll the orchestration status via the dashboard or API to track progress. The dashboard updates automatically, or you can use the GET /orchestrations/{id} endpoint to check status programmatically.

Tip

For automated workflows, combine orchestrations with the API to start, monitor, and respond to orchestration events without manual intervention.

Next steps

• Tasks — manage AI operations with the Kanban-style task board
• API Reference — access orchestration endpoints programmatically