List where a chat can be forked
curl --request GET \
--url https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options"
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/{chatID}/fork-options', 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/{chatID}/fork-options",
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/{chatID}/fork-options"
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/{chatID}/fork-options")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options")
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": [
{
"can": {
"fork": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"defaults": {
"model": "<string>",
"reasoning_effort": "<string>"
},
"machine_label": "<string>",
"models": [
{
"default_reasoning_effort": {
"description": "<string>",
"label": "<string>"
},
"id": "<string>",
"label": "<string>",
"reasoning_efforts": [
{
"description": "<string>",
"id": "<string>",
"label": "<string>",
"selectable": true
}
],
"selectable": true
}
],
"to": {
"kind": "this_task"
}
}
]
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Tasks
List where a chat can be forked
Lists where a chat can be forked, and whether the caller can fork it there now. The list is returned whole.
Use this tool when you need to:
- Offer, disable or hide a chat’s Fork chat before a person chooses it
- Say why a chat cannot be forked into a new chat of its task, a new sandbox task, or a new task on one of your computers, now
Examples:
- GET /tasks//chats//fork-options
- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/chats/0b8e6d52-4f3a-4c1e-9d7b-2a5c8e1f3b90/fork-options
Hints:
- taskID and chatID are lowercase uuids; a chat of another task is 404.
- The list holds one option of to kind this_task, a new chat of the chat’s own task, then one of kind sandbox, a new task in a sandbox of the project’s default size, then one of kind computer for each of the caller’s own computers (listComputers), never another person’s. to is what forkTaskChat takes. Each option has machine_label (the label of the machine the new chat runs on), can.fork, models and defaults (the model and thinking level the new chat runs with when the fork names none).
- this_task: models is empty, and defaults are the chat’s own model and thinking level.
- sandbox: models are what GET /projects//start-options lists for the chat’s agent. defaults are the chat’s own model and thinking level where models lists them, else that list’s default model and the model’s default thinking level (null).
- can.fork is available, or not_now, unsupported or not_permitted with a reason whose message is the sentence forkTaskChat refuses with: not_now while a turn of the chat is queued or running, while its agent waits on a question or plan, and before its first turn has ended; unsupported for an OpenCode chat; not_permitted for a reader who may not act in the task’s chats, or a suspended account (a suspended organization is refused the read with 403 org_suspended). The sandbox option’s can.fork then reads the account’s standing for a new task as GET /projects//start-options reads it: not_now with billing_blocked, credits_exhausted or org_task_concurrency_exceeded.
- computer: machine_label is the computer’s name. models are what that computer’s start option (GET /projects//start-options) lists for the chat’s agent, and defaults the chat’s own model and thinking level where they list them, else model default and no thinking level, the computer’s own settings. An item that cannot be chosen because its agent runs on no computer (can.fork unsupported with fork_unsupported) lists no models, and its defaults are the chat’s own: a client offers no model for it. can.fork reads the chat’s own reasons first, then that start option’s can.start for a fork: unsupported with fork_unsupported for an agent that cannot be continued there (only Claude Code runs on a computer, and a bridge may declare it places no fork), computer_cli_outdated for a bridge that does not start tasks or place forks, no_work_tree_folder for one that named no folder for work trees, project_has_no_repository; not_now with computer_unreachable, agent_starts_off or no_checkout_on_computer; not_permitted with credential_kind_not_admitted for a client app’s grant or an agent’s credential; available with the note not_signed_in or agent_not_installed when the agent there needs putting right, which the new task’s start waits on.
- 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.
- A chat on its person’s computer lists the same three kinds, from one read of the chat, the account’s standing and the caller’s computers. this_task is unsupported with chats_not_addable (not_permitted first for anyone who may not act on the chat): a task on a computer runs one chat. machine_label is the task’s computer’s name, and defaults are the chat’s own. sandbox reads the chat’s can.fork, then the account’s standing; computer reads the chat’s can.fork, then that computer’s start option for a fork, the chat’s own computer included. Each item’s defaults are the chat’s model and thinking level where the destination lists them, else what its session last ran on (read from the end of Aether’s copy of its file) where it lists that, else the destination’s default. forkTaskChat refuses each destination with the code and sentence its item shows. A deployment with no checkpoint storage answers the list, as it answers a fork of such a chat into a new task, 500 teleport_unavailable.
GET
/
tasks
/
{taskID}
/
chats
/
{chatID}
/
fork-options
List where a chat can be forked
curl --request GET \
--url https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options"
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/{chatID}/fork-options', 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/{chatID}/fork-options",
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/{chatID}/fork-options"
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/{chatID}/fork-options")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/tasks/{taskID}/chats/{chatID}/fork-options")
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": [
{
"can": {
"fork": {
"availability": "available",
"notes": [
{
"code": "<string>",
"message": "<string>"
}
]
}
},
"defaults": {
"model": "<string>",
"reasoning_effort": "<string>"
},
"machine_label": "<string>",
"models": [
{
"default_reasoning_effort": {
"description": "<string>",
"label": "<string>"
},
"id": "<string>",
"label": "<string>",
"reasoning_efforts": [
{
"description": "<string>",
"id": "<string>",
"label": "<string>",
"selectable": true
}
],
"selectable": true
}
],
"to": {
"kind": "this_task"
}
}
]
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}