List each agent's models, thinking levels and modes
curl --request GET \
--url https://api.runaether.dev/agent-choices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/agent-choices"
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/agent-choices', 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/agent-choices",
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/agent-choices"
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/agent-choices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/agent-choices")
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_label": "<string>",
"agent_type": "codex",
"choices": {
"attachment_types": [
"<string>"
],
"interaction_modes": [
{
"id": "<string>",
"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
}
]
},
"defaults": {
"interaction_mode": "<string>",
"model": "<string>",
"reasoning_effort": "<string>"
}
}
]
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Agent Choices
List each agent's models, thinking levels and modes
Lists each agent a new task may start with, with the models, thinking levels and modes it may choose and its own defaults, for a screen with no project.
Use this tool when you need to:
- Choose agent_type, model and reasoning_effort for an agent profile (createAgentProfile, patchAgentProfile)
- Choose agent_type, model and interaction_mode for the onboarding task (launchOnboardingTask)
- Show the labels of the agents, models, thinking levels and modes
Examples:
- GET /agent-choices
Hints:
- Takes no parameters. Not paged: items holds one entry per agent a cloud sandbox runs and a new selection may name, in the catalog’s order (today codex and claude-code); an agent retired from new selections (today opencode) is not listed. Each has agent_type, agent_label, choices and defaults.
- choices is a start option’s: models holds each model (id, label, selectable) with reasoning_efforts, the thinking levels it takes (id, label, description, selectable), empty when it takes none, and default_reasoning_effort, the words for what a null reasoning_effort runs, null when it takes none. interaction_modes holds each mode (id, label) and attachment_types the media types a message may attach. Every model and level listed here is selectable. Ids are open strings: show the label of an id you do not know.
- defaults is the agent’s own default model, reasoning_effort (null when the default model takes none) and interaction_mode, the same in every project, never a project’s stored task defaults.
- What an agent may choose is the same in every project and for every caller, so this reads no project, organization or standing. getProjectStartOptions lists the same entries for a project with where each runs and what the caller can do with it.
- Any signed-in person may call it, with a session or an API key; a caller who is not signed in is refused with 401.
GET
/
agent-choices
List each agent's models, thinking levels and modes
curl --request GET \
--url https://api.runaether.dev/agent-choices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/agent-choices"
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/agent-choices', 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/agent-choices",
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/agent-choices"
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/agent-choices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/agent-choices")
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_label": "<string>",
"agent_type": "codex",
"choices": {
"attachment_types": [
"<string>"
],
"interaction_modes": [
{
"id": "<string>",
"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
}
]
},
"defaults": {
"interaction_mode": "<string>",
"model": "<string>",
"reasoning_effort": "<string>"
}
}
]
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "bad_gateway",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}