Skip to main content
PUT
Report a turn a computer runs with a message

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}$
deliveryID
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
report
enum<string>
required

start, with asked_at, to ask to run the turn: Aether starts it, or queues it with the reason it cannot; queued, with reason, when the computer cannot run it now; ended, with outcome and ended_at, once the run's process and every process it started have exited.

Available options:
start,
queued,
ended
asked_at
string<date-time>

With start, and only with it: when the bridge asked, on the computer's clock, which also stamps the session file's rows. The run's prompt is a row stamped no earlier, so a person's prompt of the same text written before is never taken for it.

ended_at
string<date-time>

With ended, and only with it: when the run ended, on the computer's clock, which also stamps the chat's statuses. The run's end closes the chat's turn whose status began no later, never a turn a terminal began after it.

outcome
enum<string>

With ended, and only with it. A run that never started ends only failed.

Available options:
finished,
stopped,
not_signed_in,
usage_limit,
failed,
interrupted,
fork_refused,
turn_settings_refused
reason
enum<string>

With queued, and only with it: open_in_terminal while a terminal the bridge cannot write to has the session open; not_signed_in when Claude Code is not signed in on the computer; claude_not_found when the bridge finds no claude.

Available options:
open_in_terminal,
not_signed_in,
claude_not_found

Response

OK

delivery_id
string<uuid>
required

The message the turn runs with.

message
string
required

The message's text, kept exactly: at most 64 KiB of UTF-8, holding a character other than a space. A send refuses a slash command (text starting with /); a message stored before the send refused one may read as one.

Required string length: 1 - 65536
run
object
required

A turn the computer runs with a message from Aether while no terminal has the chat's session open: Claude Code resumes the session there in print mode, with the person's own settings and sign-in. A terminal that opens the session meanwhile is told to wait.

session_id
string<uuid>
required

Claude Code's own id of the session the run resumes.

turn_settings
object
required

The model and thinking level a turn Aether starts on a terminal chat runs with: what the computer's Claude Code takes for --model and --effort.