coord

Control Fan-out

Control a running fan-out (POST /coord/fanouts/:id/control). pause holds every unclaimed seat and stops the orphan pass from re-firing them; resume releases them again; cancel supersedes every unclaimed task and closes once quiescent; close_barrier drops unsettled or named exclude_seats and forces the synth barrier now instead of waiting for more seats; retry_synth (migration 232) mints a new synth revision from the current synth's own stored inputs, correctly ordered, when every one of its failed runs is input_ref_mismatch -- refused otherwise (not_synthesizing, no_synth_task, no_failed_runs, not_input_ref_mismatch). No amend and no answer in phase 1. Every action mints a signed control-child completion FIRST, as the org's own system worker (coord_fanout_control_receipt) — never coord_dispatcher_action, so a control action can never sign into another org's Chief of Staff identity. idempotency_key replays the prior outcome (replayed:true) and applies nothing twice; a replayed resume after a later pause leaves the fan-out paused. Refused fanout_closed once the roll-up has closed. Requires agent:dispatch:code.

post/coord/fanouts/{id}/control

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/coord/fanouts/{id}/control
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

fanout_idstring required

Fan-out id (UUID) — the T_F root.

action'pause' | 'resume' | 'cancel' | 'close_barrier' | 'retry_synth' required

pause, resume, cancel, close_barrier or retry_synth. No amend, no answer (phase 1).

reasonstring

Optional free-text reason (<= 4000 chars), recorded on the control child's completion.

exclude_seatsinteger[]

close_barrier only: 1-based seat numbers to drop from the barrier instead of waiting for them to settle.

idempotency_keystring

Optional replay key (<= 200 chars). The same key returns the prior outcome (replayed:true) and applies nothing a second time.

Response

Success. JSON body: { data: ... } or an error object { error, message }.

Changes

No recorded changes to this operation across all 1 revision of this API.