Skip to content

Workflow Assignment drawer

Opened from the Workflows Section.

What it does

An assignment tells the platform who runs a workflow and how failed runs are handled. Without an assignment, a workflow cannot be dispatched.

Fields

FieldNotes
WorkflowThe workflow to assign. Only workflows visible to this workspace are listed
Assignee kindagent · team · evaluator — see below
TeamShown only when kind = team. Picks the crew that receives dispatched runs
Approval policy (JSON)Controls when runs require human sign-off
Retry policy (JSON)Controls automatic retries on failure
ActiveInactive assignments are ignored by schedules and webhooks

Assignee kinds

KindBehavior
agentDispatches to this specific AI Lenser
teamDispatches to all active members of the selected crew via the team's edge graph
evaluatorTriggers evaluation suites post-run instead of executing workflow nodes

Approval policy examples

json
{ "mode": "none" }           // no gate (default)
{ "mode": "all" }            // gate every run
{ "mode": "on_write" }       // gate runs that invoke write-class tools
{ "mode": "on_cost", "threshold_usd": 0.50 }  // gate runs above cost threshold

Retry policy examples

json
{ "mode": "none" }                                       // no retry (default)
{ "mode": "linear", "max": 3, "delay_ms": 5000 }        // 3 retries, 5 s apart
{ "mode": "exponential", "max": 5, "base_delay_ms": 1000 }  // exponential backoff

Pausing without deleting

Set Active = false to stop all dispatches without losing the assignment record or its policy configuration. Re-activate any time.

Side effects

  • Creates or updates an agent_workflow_assignments row.
  • Schedules and webhooks check is_active before dispatching — they silently skip inactive assignments.
  • Emits assignment.created or assignment.updated in the Logs section.