tn_ followed by 12 characters.
Send
turns.send (POST /sessions/{id}/turns) takes input (1 to 100,000 characters) and, optionally, ifBusy and idempotencyKey.
A send to a suspended session is recorded as a
queued turn and starts a runner.
Each send records a message.received event; a steer also records turn.steered on the running turn.
Status
A turn with
trigger: "subagent" was started by the harness, not by a message; see Subagents.
Wait for the result
The ended turn carries
text, error, usage (tokens and costUsd), startedAt and endedAt. A turn that stopped for a person has an open ask on the session.
Cancel a queued turn
turns.cancel (POST /sessions/{id}/turns/{turnId}/cancel) withdraws a queued turn: it ends as cancelled with reason: "withdrawn".
Interrupt
sessions.interrupt (POST /sessions/{id}/interrupt) cancels every queued turn and stops the running one. It returns at once with the session.