Sign in

v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01485121699.8 KB

Post Task Steer

Record a steering receipt for a running worker and apply its effect.

The receipt is bound into the audit chain before the effect executes; the steer.* mailbox message and any process signal reference the receipt hash returned here. An effect can never precede its receipt.

post/tasks/{task_id}/steer

Path parameters

task_idstring required

Request body

kindstring required
principalstring
guidancestring
redirect_targetstring
reasonstring
session_idstring
adapterstring
worktreestring
displayed_payload_hashstring nullable

Response

Successful Response

kindstring required
task_idstring required
principalstring required
scopestring required
payload_hashstring required
receipt_hashstring required
timestampnumber required
mailbox_seqinteger required
mailbox_entry_hashstring required
checkpoint_event_hashstring
abort_signal_writtenboolean