Read a task a computer is to start
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/task-starts/{startID} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/task-starts/{startID}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/computers/{computerID}/task-starts/{startID}', 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}/task-starts/{startID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/task-starts/{startID}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/computers/{computerID}/task-starts/{startID}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/task-starts/{startID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"base_branch": "<string>",
"branch": "<string>",
"checkout": "<string>",
"folder": "<string>",
"fork": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subagents": [
"<string>"
]
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "<string>",
"repository": {
"name": "<string>",
"owner": "<string>"
},
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent": "<string>"
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Computers
Read a task a computer is to start
Reads a start of a task on the caller’s computer, by the id of the start_task command that named it: the work tree to make (the task’s own branch from origin’s base branch, added from the person’s checkout of the repository, at the start’s folder) and the id of the Claude Code session the task’s main chat is.
Use this tool when you need to:
- Carry out a start_task command: read the start it names, make its work tree, and report it with reportComputerTaskStart
Examples:
- GET /computers//task-starts/
Hints:
- Make the work tree only while state is pending; a prepared start’s first message (first_message_id) runs as the main chat’s first run, and a failed start is settled.
- A pending start waits while the computer does not let Aether start agents: it is refused with 409 agent_starts_off, and listComputerTaskStarts lists it once the computer turns that on.
- A start not on the caller’s computer 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.
GET
/
computers
/
{computerID}
/
task-starts
/
{startID}
Read a task a computer is to start
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/task-starts/{startID} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/task-starts/{startID}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/computers/{computerID}/task-starts/{startID}', 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}/task-starts/{startID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/task-starts/{startID}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/computers/{computerID}/task-starts/{startID}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/task-starts/{startID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"base_branch": "<string>",
"branch": "<string>",
"checkout": "<string>",
"folder": "<string>",
"fork": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subagents": [
"<string>"
]
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "<string>",
"repository": {
"name": "<string>",
"owner": "<string>"
},
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent": "<string>"
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Authorizations
Path Parameters
Response
OK
- Option 1
- Option 2
- Option 3
A task started on the computer, as its machine bridge carries it out: the work tree to make, the session the task's main chat is, and where the start stands.