Report a terminal chat's status
curl --request PATCH \
--url https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"observed_at": "2023-11-07T05:31:56Z",
"open_in": "terminal",
"session_gone": true
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}"
payload = {
"observed_at": "2023-11-07T05:31:56Z",
"open_in": "terminal",
"session_gone": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({observed_at: '2023-11-07T05:31:56Z', open_in: 'terminal', session_gone: true})
};
fetch('https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'observed_at' => '2023-11-07T05:31:56Z',
'open_in' => 'terminal',
'session_gone' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}"
payload := strings.NewReader("{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_gone_at": "2023-11-07T05:31:56Z",
"status": "running",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Computers
Report a terminal chat's status
Records what a terminal chat's machine bridge observes of it: the status its Claude Code hooks report (running from a prompt to the end of its turn, needs_you while a permission request is open, idle otherwise), that its session's file is gone from the computer, or where its session is open. Answers the chat.
Use this tool when you need to:
- Report a terminal chat's status from its hooks, as the machine bridge does
- Report that a session file the bridge shipped is gone from the computer, so the chat is read-only history
- Report whether a terminal Aether can write to holds the session
Examples:
- PATCH /computers/{computerID}/terminal-chats/{sessionID} {"status": "running", "observed_at": "2026-11-07T10:00:00.120Z"}
- PATCH /computers/{computerID}/terminal-chats/{sessionID} {"session_gone": true, "observed_at": "2026-11-07T10:00:00.120Z"}
- PATCH /computers/{computerID}/terminal-chats/{sessionID} {"open_in": "terminal", "observed_at": "2026-11-07T10:00:00.120Z"}
Hints:
- A report is status, session_gone or open_in, exactly one: a body with two, or none, is refused with 422.
- open_in is terminal while a terminal Aether can write to holds the session, null while none does: the chat reads what the agent supports in a terminal, or as a run. Report it for each session after every connect, which clears it for the computer's sessions, and again whenever it changes, in order: the latest report stands. A report that arrived before a connect writes nothing after it.
- observed_at is when the bridge observed the status, or the file gone, on the computer's clock. A status observed before the chat's current status began changes nothing, so a retried report is harmless; a Stop that reports background work still running is reported running from the Stop.
- session_gone keeps the chat's status as it was and sets its session_gone_at, unless a status observed after it says the file was there; one already set keeps its first time. A status observed no earlier than it, or a range of the session's files, means the file is back and clears it.
- The session file closes a turn its hooks did not end (Escape in the terminal, a prompt a hook blocked, a manual /compact, a permission Claude denied itself): its reader sets the chat idle from the turn's end.
- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, is refused with 404 not_found.
- Only the grant of the caller's coding agent's bridge calls it, the machine bridge on the computer: a session or an API key is refused with 403 credential_kind_not_admitted.
- The call presents the computer's own secret, which aether setup keeps on it, in the Aether-Computer-Secret header. A computer that has none is refused with 403 computer_needs_setup: update the aether CLI there and run aether setup. A call that presents no secret, or another, is refused with 403 computer_set_up_elsewhere.
PATCH
/
computers
/
{computerID}
/
terminal-chats
/
{sessionID}
Report a terminal chat's status
curl --request PATCH \
--url https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"observed_at": "2023-11-07T05:31:56Z",
"open_in": "terminal",
"session_gone": true
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}"
payload = {
"observed_at": "2023-11-07T05:31:56Z",
"open_in": "terminal",
"session_gone": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({observed_at: '2023-11-07T05:31:56Z', open_in: 'terminal', session_gone: true})
};
fetch('https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'observed_at' => '2023-11-07T05:31:56Z',
'open_in' => 'terminal',
'session_gone' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}"
payload := strings.NewReader("{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/terminal-chats/{sessionID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"observed_at\": \"2023-11-07T05:31:56Z\",\n \"open_in\": \"terminal\",\n \"session_gone\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_gone_at": "2023-11-07T05:31:56Z",
"status": "running",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Authorizations
Path Parameters
Body
application/json
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.
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.