Skip to main content
GET
Read a message sent to a computer

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}$

Response

OK

id
string<uuid>
required
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
pending
boolean
required

true while the computer has reported nothing of the message and it can still be delivered; a message that is not pending is taken no more.

session_id
string<uuid>
required

Claude Code's own id of the session the message goes to.

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.