Skip to main content
PUT
Report how a stop sent to a computer settled

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

computerID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
stopID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json
outcome
enum<string>
required

stopped once a tool hook of the turn was answered with the stop; turn_ended when the turn ended by itself first; nothing_to_stop when no turn of the main agent ran when the stop arrived, or the one running began with a prompt after its turn_since.

Available options:
stopped,
turn_ended,
nothing_to_stop

Response

OK

session_id
string<uuid>
required

Claude Code's own id of the session whose turn the stop ends.

stop
object
required

The stop where it stands, as its person reads it: on_its_way while Aether waits for the computer to take it or counts it held by the computer's live connection; settled once the computer reported how it settled, after which it is held no more; undelivered once Aether counts it not delivered. Its run_id names the run of the machine bridge's whose turn it is for, which the bridge ends at once; a stop of a run that no longer runs on the computer finds its turn ended.

turn_since
string<date-time>
required

When the chat's status its person saw began, on the computer's clock, as its machine bridge reported it: a turn that began after it is a later one, which the stop never reaches.