Skip to main content
PATCH
Report a terminal chat's status

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}$
sessionID
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
observed_at
string<date-time>
required

When the machine bridge observed the status, the file gone, or where the session is open, on the computer's clock.

open_in
enum<string> | null

Where the session is open: terminal while a terminal Aether can write to holds it, null while none does. Sent alone; absent is no report.

Available options:
terminal
session_gone
boolean

true: the session file the bridge shipped is gone from the computer, so the chat is read-only history. Sent alone; false is no report.

status
enum<string>

The status the chat's hooks report. Sent alone.

Available options:
running,
needs_you,
idle

Response

OK

A terminal chat as its computer's machine bridge reads it: its id, its task, its status and whether its session's file is gone.

id
string<uuid>
required
session_gone_at
string<date-time> | null
required

When the computer's machine bridge found the session's file gone from the computer, on its clock: Claude Code can no longer resume the session there, so the chat is read-only history. Null while the file is there, and always from a machine bridge too old to report it.

status
enum<string>
required

running from a prompt to the end of its turn, needs_you while a permission request is open, idle otherwise.

Available options:
running,
needs_you,
idle
task_id
string<uuid>
required