Skip to main content
A turn’s id is 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.