List a task's chats
curl --request GET \
--url https://api.runaether.dev/tasks/{taskID}/chats \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/tasks/{taskID}/chats"
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/tasks/{taskID}/chats', 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/tasks/{taskID}/chats",
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/tasks/{taskID}/chats"
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/tasks/{taskID}/chats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/tasks/{taskID}/chats")
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{
"items": [
{
"agent_session": {
"last_active_at": "2023-11-07T05:31:56Z",
"open_in": {
"code": "terminal",
"label": "<string>"
},
"resume_command": "<string>",
"resume_hint": "<string>",
"session_id": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"started_by": {
"code": "aether",
"label": "<string>"
}
},
"agent_type": "codex",
"archived": {
"archived_at": "2023-11-07T05:31:56Z",
"stopped_turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"can": {
"archive": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"compose": {
"attach": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_connection": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_interaction_mode": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_model": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_reasoning_effort": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"reference_files": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"use_slash_commands": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"fork": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"queue_for_later": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"remove": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"send": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"steer": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"stop": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"created_at": "2023-11-07T05:31:56Z",
"forked_from": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"forks": [
{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"interaction_mode": "<string>",
"main": true,
"model": "<string>",
"name": "<string>",
"notices": [
{
"code": "answer_not_used",
"expires_at": "2023-11-07T05:31:56Z",
"message": "<string>",
"since": "2023-11-07T05:31:56Z",
"tool_id": "<string>"
}
],
"outbox": [
{
"attachments": [
{
"filename": "<string>",
"index": 4,
"media_type": "<string>",
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sha256": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"kind": "user",
"sequence": null,
"state": "queued",
"text": "<string>",
"turn_id": null,
"waiting": {
"code": "turn_running",
"message": "<string>"
},
"client_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"message_event": {
"author": {
"login": "<string>",
"association": "<string>",
"type": "<string>"
},
"body": "<string>",
"kind": "pr_comment",
"pr_number": 4503599627370496,
"repo": {
"name": "<string>",
"owner": "<string>"
},
"action": "<string>",
"branch": "<string>",
"line": 4503599627370496,
"path": "<string>",
"review_id": 4503599627370496,
"review_state": "<string>",
"reviewer_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>"
},
"sender": {
"display_name": "<string>",
"github_login": "<string>",
"kind": "user",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"tool_response": {
"data": {
"answers": {},
"custom_answers": {}
},
"tool_name": "ask_user"
},
"waits_for": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
],
"pending_inputs": [
{
"answer": {
"answered_at": "2023-11-07T05:31:56Z",
"decision": "<string>",
"kind": "plan",
"message": "<string>"
},
"can": {
"answer": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"decisions": [
{
"id": "<string>",
"label": "<string>",
"takes_message": true,
"rule": "<string>"
}
],
"expires_at": "2023-11-07T05:31:56Z",
"input": {
"plan": "<string>",
"summary": "<string>"
},
"kind": "plan",
"requested_at": "2023-11-07T05:31:56Z",
"tool_id": "<string>"
}
],
"reasoning_effort": "<string>",
"runs_on": {
"runs_on": "aether"
},
"status": "queued",
"stopping": {
"requested_at": "2023-11-07T05:31:56Z"
},
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"waiting": {
"code": "turn_running",
"message": "<string>"
},
"waits_for": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"turn_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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Tasks
List a task's chats
Lists every chat of a task, the main chat first and then in the order they were created, archived chats included, each with its settings and its own status.
Use this tool when you need to:
- Find a task’s chats and which one needs a person
- See which chat’s turn the workspace runs and which chats wait for it
Examples:
- GET /tasks//chats
- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/chats
Hints:
- taskID is the task’s lowercase uuid. The list is returned whole: the main chat first, then the others oldest first.
- Each chat has id, task_id, name (its first prompt on one line, null before it has one), main, created_at, archived (null, or archived_at and the stopped_turn_id its archive stopped), agent_type, model, reasoning_effort, interaction_mode, runs_on and status: processing while its turn runs, queued while a message waits in its queue (waits_for names the turn another chat runs, null when none does), awaiting_input with awaiting_input_kind, or errored when the task’s workspace failed.
- Each chat has can: what the caller can do with it as things stand. Each ability (send, steer, queue_for_later, stop, archive, remove, fork, and compose’s attach, reference_files, use_slash_commands, change_model, change_reasoning_effort, change_interaction_mode and change_connection) is available with its notes, or not_now, unsupported or not_permitted with a reason: a code, an open set, and the sentence the operation it governs refuses with.
- In a sandbox, while another chat’s turn runs, every other chat’s can.send, when it is available, carries the note message_waits_for_other_chat: a message sent now waits for that turn, as a queued chat’s waiting reads other_chat_turn.
- Use getTask instead for the task’s status: in a sandbox, the most urgent of its chats’.
- On a task on its person’s computer each chat is shaped as getTaskChat reads it, and a session its person started in their own terminal is listed to them alone.
- Any member of the task’s organization may read it, a viewer included; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task or chat outside the caller’s reach is 404 not_found; 503 when the membership check is unavailable.
GET
/
tasks
/
{taskID}
/
chats
List a task's chats
curl --request GET \
--url https://api.runaether.dev/tasks/{taskID}/chats \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/tasks/{taskID}/chats"
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/tasks/{taskID}/chats', 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/tasks/{taskID}/chats",
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/tasks/{taskID}/chats"
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/tasks/{taskID}/chats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/tasks/{taskID}/chats")
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{
"items": [
{
"agent_session": {
"last_active_at": "2023-11-07T05:31:56Z",
"open_in": {
"code": "terminal",
"label": "<string>"
},
"resume_command": "<string>",
"resume_hint": "<string>",
"session_id": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"started_by": {
"code": "aether",
"label": "<string>"
}
},
"agent_type": "codex",
"archived": {
"archived_at": "2023-11-07T05:31:56Z",
"stopped_turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"can": {
"archive": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"compose": {
"attach": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_connection": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_interaction_mode": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_model": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"change_reasoning_effort": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"reference_files": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"use_slash_commands": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"fork": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"queue_for_later": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"remove": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"send": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"steer": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
},
"stop": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"created_at": "2023-11-07T05:31:56Z",
"forked_from": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"forks": [
{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"interaction_mode": "<string>",
"main": true,
"model": "<string>",
"name": "<string>",
"notices": [
{
"code": "answer_not_used",
"expires_at": "2023-11-07T05:31:56Z",
"message": "<string>",
"since": "2023-11-07T05:31:56Z",
"tool_id": "<string>"
}
],
"outbox": [
{
"attachments": [
{
"filename": "<string>",
"index": 4,
"media_type": "<string>",
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sha256": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"kind": "user",
"sequence": null,
"state": "queued",
"text": "<string>",
"turn_id": null,
"waiting": {
"code": "turn_running",
"message": "<string>"
},
"client_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"message_event": {
"author": {
"login": "<string>",
"association": "<string>",
"type": "<string>"
},
"body": "<string>",
"kind": "pr_comment",
"pr_number": 4503599627370496,
"repo": {
"name": "<string>",
"owner": "<string>"
},
"action": "<string>",
"branch": "<string>",
"line": 4503599627370496,
"path": "<string>",
"review_id": 4503599627370496,
"review_state": "<string>",
"reviewer_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>"
},
"sender": {
"display_name": "<string>",
"github_login": "<string>",
"kind": "user",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"tool_response": {
"data": {
"answers": {},
"custom_answers": {}
},
"tool_name": "ask_user"
},
"waits_for": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
],
"pending_inputs": [
{
"answer": {
"answered_at": "2023-11-07T05:31:56Z",
"decision": "<string>",
"kind": "plan",
"message": "<string>"
},
"can": {
"answer": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"decisions": [
{
"id": "<string>",
"label": "<string>",
"takes_message": true,
"rule": "<string>"
}
],
"expires_at": "2023-11-07T05:31:56Z",
"input": {
"plan": "<string>",
"summary": "<string>"
},
"kind": "plan",
"requested_at": "2023-11-07T05:31:56Z",
"tool_id": "<string>"
}
],
"reasoning_effort": "<string>",
"runs_on": {
"runs_on": "aether"
},
"status": "queued",
"stopping": {
"requested_at": "2023-11-07T05:31:56Z"
},
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"waiting": {
"code": "turn_running",
"message": "<string>"
},
"waits_for": {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"turn_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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}