Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery.
Use this tool when you need to:
- Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot
- Report that the computer cannot run it now, and why
- Report that the run ended, and how
Examples:
- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {"report": "start", "asked_at": "2026-11-08T06:00:00Z"}
- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {"report": "queued", "reason": "not_signed_in"}
- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {"report": "ended", "outcome": "finished", "ended_at": "2026-11-08T06:04:00Z"}
Hints:
- A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands.
- The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found.
- Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved.
- The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to 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.
start, with asked_at, to ask to run the turn: Aether starts it, or queues it with the reason it cannot; queued, with reason, when the computer cannot run it now; ended, with outcome and ended_at, once the run's process and every process it started have exited.
Available options:
start,
queued,
ended
asked_at
string<date-time>
With start, and only with it: when the bridge asked, on the computer's clock, which also stamps the session file's rows. The run's prompt is a row stamped no earlier, so a person's prompt of the same text written before is never taken for it.
ended_at
string<date-time>
With ended, and only with it: when the run ended, on the computer's clock, which also stamps the chat's statuses. The run's end closes the chat's turn whose status began no later, never a turn a terminal began after it.
outcome
enum<string>
With ended, and only with it. A run that never started ends only failed.
Available options:
finished,
stopped,
not_signed_in,
usage_limit,
failed,
interrupted,
fork_refused,
turn_settings_refused
reason
enum<string>
With queued, and only with it: open_in_terminal while a terminal the bridge cannot write to has the session open; not_signed_in when Claude Code is not signed in on the computer; claude_not_found when the bridge finds no claude.
Available options:
open_in_terminal,
not_signed_in,
claude_not_found
Response
OK
delivery_id
string<uuid>
required
The message the turn runs with.
message
string
required
The message's text, kept exactly: at most 64 KiB of UTF-8, holding a character other than a space. A send refuses a slash command (text starting with /); a message stored before the send refused one may read as one.
Required string length: 1 - 65536
run
object
required
A turn the computer runs with a message from Aether while no terminal has the chat's session open: Claude Code resumes the session there in print mode, with the person's own settings and sign-in. A terminal that opens the session meanwhile is told to wait.
Option 1
Option 2
Option 3
Show child attributes
session_id
string<uuid>
required
Claude Code's own id of the session the run resumes.
turn_settings
object
required
The model and thinking level a turn Aether starts on a terminal chat runs with: what the computer's Claude Code takes for --model and --effort.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Aether","colors":{"primary":"#9184ff","light":"#b3a9ff","dark":"#9184ff"},"logo":{"light":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/logo/light.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=cdf40b8647da8a5d82a91e289a1958f7","dark":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/logo/dark.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=ff1a5d20e563918957a5f0eba367dee4","href":"https://www.runaether.dev"},"favicon":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/favicon.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=26bfe1ec698456a716b64fb50a5848be","api":{"openapi":"api-reference/openapi.json"},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#f4f3ef","dark":"#08080b"}},"navbar":{"links":[{"href":"https://www.runaether.dev/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Open Aether","href":"https://app.runaether.dev"}},"footer":{"socials":{"x":"https://x.com/pranavctl","github":"https://github.com/Aether-Runtime"}},"fonts":{"family":"Geist"},"styling":{"codeblocks":"dark","latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aether-c4587800","hasAudioNarration":false,"actualSubdomain":"aether-c4587800","customDomains":["docs.runaether.dev"],"gitSource":{"type":"github","owner":"aether-runtime","repo":"aether","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6affc0b8a27afa133802f733","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":339},{"language":"default","tag":"Tasks","count":51},{"language":"default","tag":"CLI Reference","count":42},{"language":"default","tag":"Pull Requests","count":35},{"language":"default","tag":"Guides","count":29},{"language":"default","tag":"Computers","count":29},{"language":"default","tag":"Using Aether","count":25},{"language":"default","tag":"MCP Servers","count":23},{"language":"default","tag":"Concepts","count":22},{"language":"default","tag":"Agent","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{color-scheme:dark}::selection{background:rgba(145, 132, 255, 0.25)}"}]}
{"page":{"pagePath":"api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid","slug":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid","pageMetadata":{"title":"Report a turn a computer runs with a message","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-runs/{deliveryID}","description":"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery.\n\nUse this tool when you need to:\n- Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot\n- Report that the computer cannot run it now, and why\n- Report that the run ended, and how\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"start\", \"asked_at\": \"2026-11-08T06:00:00Z\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"queued\", \"reason\": \"not_signed_in\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"ended\", \"outcome\": \"finished\", \"ended_at\": \"2026-11-08T06:04:00Z\"}\n\nHints:\n- A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands.\n- The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found.\n- Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved.\n- The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller's computer is refused with 404 not_found.\n- 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.\n- 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.","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid"},"description":"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery.\n\nUse this tool when you need to:\n- Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot\n- Report that the computer cannot run it now, and why\n- Report that the run ended, and how\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"start\", \"asked_at\": \"2026-11-08T06:00:00Z\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"queued\", \"reason\": \"not_signed_in\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"ended\", \"outcome\": \"finished\", \"ended_at\": \"2026-11-08T06:04:00Z\"}\n\nHints:\n- A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands.\n- The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found.\n- Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved.\n- The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller's computer is refused with 404 not_found.\n- 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.\n- 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.","pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Report a turn a computer runs with a message","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-runs/{deliveryID}","description":"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery.\n\nUse this tool when you need to:\n- Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot\n- Report that the computer cannot run it now, and why\n- Report that the run ended, and how\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"start\", \"asked_at\": \"2026-11-08T06:00:00Z\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"queued\", \"reason\": \"not_signed_in\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"ended\", \"outcome\": \"finished\", \"ended_at\": \"2026-11-08T06:04:00Z\"}\n\nHints:\n- A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands.\n- The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found.\n- Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved.\n- The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller's computer is refused with 404 not_found.\n- 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.\n- 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.","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery.\n\nUse this tool when you need to:\n- Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot\n- Report that the computer cannot run it now, and why\n- Report that the run ended, and how\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"start\", \"asked_at\": \"2026-11-08T06:00:00Z\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"queued\", \"reason\": \"not_signed_in\"}\n- PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\"report\": \"ended\", \"outcome\": \"finished\", \"ended_at\": \"2026-11-08T06:04:00Z\"}\n\nHints:\n- A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands.\n- The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found.\n- Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved.\n- The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller's computer is refused with 404 not_found.\n- 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.\n- 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.","operationId":"reportTerminalChatRun","parameters":["715ee2b9-5fe3-4b3f-a20f-9a1fea11a9fe","781a2091-a5c3-4a41-a165-edd9a18535a8"],"requestBody":"9c9b1988-21bf-445a-b241-47a274b0268d","responses":{"200":"6791f695-c87d-426e-a097-7710e476f361","401":"546925e6-8852-470b-a204-da9a88789bc0","403":"7f2ca637-5eb5-46b0-a015-9a561eeb9a7b","404":"ad80d355-725e-49d9-b0a9-8de0ef8b28d3","409":"5ff40611-460d-4aec-9dd2-3f54ff6413b9","410":"83a3884f-3068-43d1-8248-6991ddf601cc","422":"d09db5e3-a992-47f0-98a4-4fe23dfb17f7","500":"47d1405b-36ee-45aa-9ee9-44361405612b"},"summary":"Report a turn a computer runs with a message","tags":["computers"],"x-aether-access":{"principal":"user","kinds":["grant"],"scope":"write","org":"person"},"x-aether-label":"computers.terminalChatRuns.report","x-aether-path-ids":{"computerID":"-","deliveryID":"-"},"method":"put","type":"path","servers":["70ecc424-f8a8-4f75-bfbf-2bb9b4664f43"],"security":["370a0152-9b1d-41e3-ad0c-b4211125a98a"],"path":"/computers/{computerID}/terminal-chat-runs/{deliveryID}","baseUrlOptions":["https://api.runaether.dev"],"title":"Report a turn a computer runs with a message","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"715ee2b9-5fe3-4b3f-a20f-9a1fea11a9fe":{"in":"path","name":"computerID","required":true,"schema":{"format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"781a2091-a5c3-4a41-a165-edd9a18535a8":{"in":"path","name":"deliveryID","required":true,"schema":{"format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"report":{"description":"start, with asked_at, to ask to run the turn: Aether starts it, or queues it with the reason it cannot; queued, with reason, when the computer cannot run it now; ended, with outcome and ended_at, once the run's process and every process it started have exited.","enum":["start","queued","ended"],"type":"string","isRequired":true,"uniqueKey":"report","typeLabel":"enum\u003cstring>"},"asked_at":{"description":"With start, and only with it: when the bridge asked, on the computer's clock, which also stamps the session file's rows. The run's prompt is a row stamped no earlier, so a person's prompt of the same text written before is never taken for it.","format":"date-time","type":"string","uniqueKey":"asked_at","typeLabel":"string\u003cdate-time>"},"ended_at":{"description":"With ended, and only with it: when the run ended, on the computer's clock, which also stamps the chat's statuses. The run's end closes the chat's turn whose status began no later, never a turn a terminal began after it.","format":"date-time","type":"string","uniqueKey":"ended_at","typeLabel":"string\u003cdate-time>"},"outcome":{"description":"With ended, and only with it. A run that never started ends only failed.","enum":["finished","stopped","not_signed_in","usage_limit","failed","interrupted","fork_refused","turn_settings_refused"],"type":"string","uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"reason":{"description":"With queued, and only with it: open_in_terminal while a terminal the bridge cannot write to has the session open; not_signed_in when Claude Code is not signed in on the computer; claude_not_found when the bridge finds no claude.","enum":["open_in_terminal","not_signed_in","claude_not_found"],"type":"string","uniqueKey":"reason","typeLabel":"enum\u003cstring>"}},"required":["report"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"asked_at":"2023-11-07T05:31:56Z","ended_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"6791f695-c87d-426e-a097-7710e476f361":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"delivery_id":{"description":"The message the turn runs with.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"delivery_id","typeLabel":"string\u003cuuid>"},"message":{"description":"The message's text, kept exactly: at most 64 KiB of UTF-8, holding a character other than a space. A send refuses a slash command (text starting with /); a message stored before the send refused one may read as one.","maxLength":65536,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"run":{"oneOf":[{"type":"object","description":"A turn the computer runs with a message from Aether while no terminal has the chat's session open: Claude Code resumes the session there in print mode, with the person's own settings and sign-in. A terminal that opens the session meanwhile is told to wait.","required":["delivery_id","state","reason","since"],"properties":{"delivery_id":{"description":"The message the turn runs with: its delivery's id.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"run.oneOf.0.delivery_id","typeLabel":"string\u003cuuid>"},"reason":{"description":"agents_off when the computer does not let Aether start agents (only the computer turns that on: aether computer agents on, in a terminal there); agent_limit when it already runs as many agents as it lets Aether start at once; chat_busy while an earlier run of the chat runs; open_in_terminal while a terminal Aether cannot write to has the session open; not_signed_in when Claude Code is not signed in on the computer (signing in is its person's own job); claude_not_found when the computer has no claude Aether can find. The computer asks again, so the run starts once its reason is gone.","enum":["agents_off","agent_limit","chat_busy","open_in_terminal","not_signed_in","claude_not_found"],"type":"string","isRequired":true,"uniqueKey":"run.oneOf.0.reason","typeLabel":"enum\u003cstring>"},"since":{"description":"When the computer first held the message back.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"run.oneOf.0.since","typeLabel":"string\u003cdate-time>"},"state":{"enum":["queued"],"type":"string","isRequired":true,"uniqueKey":"run.oneOf.0.state","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"run.oneOf.0","typeLabel":"object"},{"type":"object","description":"A turn the computer runs with a message from Aether while no terminal has the chat's session open: Claude Code resumes the session there in print mode, with the person's own settings and sign-in. A terminal that opens the session meanwhile is told to wait.","required":["delivery_id","state","started_at"],"properties":{"delivery_id":{"description":"The message the turn runs with: its delivery's id.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"run.oneOf.1.delivery_id","typeLabel":"string\u003cuuid>"},"started_at":{"description":"When the computer started the turn.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"run.oneOf.1.started_at","typeLabel":"string\u003cdate-time>"},"state":{"enum":["running"],"type":"string","isRequired":true,"uniqueKey":"run.oneOf.1.state","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"run.oneOf.1","typeLabel":"object"},{"type":"object","description":"A turn the computer runs with a message from Aether while no terminal has the chat's session open: Claude Code resumes the session there in print mode, with the person's own settings and sign-in. A terminal that opens the session meanwhile is told to wait.","required":["delivery_id","state","started_at","ended_at","outcome"],"properties":{"delivery_id":{"description":"The message the turn runs with: its delivery's id.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"run.oneOf.2.delivery_id","typeLabel":"string\u003cuuid>"},"ended_at":{"description":"When the run ended.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"run.oneOf.2.ended_at","typeLabel":"string\u003cdate-time>"},"outcome":{"description":"finished when the turn ran to its end; stopped when a stop from Aether, or archiving the chat, ended it, also while it was queued; not_signed_in when Claude Code said it is not signed in on the computer; usage_limit when Claude Code said the account reached its usage limit; failed when the turn did not run to its end, or never started; interrupted when its process ended while Aether on the computer was not watching it; fork_refused when the first run of a fork to the computer did not fork the source session into the chat's; turn_settings_refused when the aether CLI on the computer did not take the model or thinking level the message was sent with, before the run started.","enum":["finished","stopped","not_signed_in","usage_limit","failed","interrupted","fork_refused","turn_settings_refused"],"type":"string","isRequired":true,"uniqueKey":"run.oneOf.2.outcome","typeLabel":"enum\u003cstring>"},"started_at":{"oneOf":[{"description":"When the computer started the turn; null for a run that was stopped, failed or refused its settings before it started.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"run.oneOf.2.started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the computer started the turn; null for a run that was stopped, failed or refused its settings before it started.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"run.oneOf.2.started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"run.oneOf.2.started_at","typeLabel":"string\u003cdate-time> | null"},"state":{"enum":["ended"],"type":"string","isRequired":true,"uniqueKey":"run.oneOf.2.state","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"run.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"run","typeLabel":"object"},"session_id":{"description":"Claude Code's own id of the session the run resumes.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"session_id","typeLabel":"string\u003cuuid>"},"turn_settings":{"additionalProperties":false,"description":"The model and thinking level a turn Aether starts on a terminal chat runs with: what the computer's Claude Code takes for --model and --effort.","properties":{"model":{"oneOf":[{"type":"string","description":"The model the turn runs on; null for the computer's Claude Code's own, from its person's settings.","enum":["fable","opus","sonnet","haiku"],"isRequired":true,"uniqueKey":"turn_settings.model.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The model the turn runs on; null for the computer's Claude Code's own, from its person's settings.","isRequired":true,"uniqueKey":"turn_settings.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turn_settings.model","typeLabel":"enum\u003cstring> | null"},"reasoning_effort":{"oneOf":[{"type":"string","description":"The thinking level the turn runs at; null for the computer's Claude Code's own, from its person's settings.","enum":["low","medium","high","xhigh","max"],"isRequired":true,"uniqueKey":"turn_settings.reasoning_effort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The thinking level the turn runs at; null for the computer's Claude Code's own, from its person's settings.","isRequired":true,"uniqueKey":"turn_settings.reasoning_effort.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turn_settings.reasoning_effort","typeLabel":"enum\u003cstring> | null"}},"required":["model","reasoning_effort"],"type":"object","isRequired":true,"uniqueKey":"turn_settings","typeLabel":"object"}},"required":["delivery_id","session_id","message","turn_settings","run"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"delivery_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","message":"\u003cstring>","run":{"delivery_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason":"agents_off","since":"2023-11-07T05:31:56Z","state":"queued"},"session_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","turn_settings":{"model":"fable","reasoning_effort":"low"}}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"546925e6-8852-470b-a204-da9a88789bc0":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"7f2ca637-5eb5-46b0-a015-9a561eeb9a7b":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error","code"],"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"oneOf.0.errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"oneOf.0.errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"oneOf.0.errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"oneOf.0.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"oneOf.0.errors","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error","code"],"properties":{"code":{"enum":["org_membership_required","org_role_insufficient","org_suspended","account_deleting","agent_host_route_not_allowed","credential_kind_not_admitted","grant_scope_insufficient"],"type":"string","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"ad80d355-725e-49d9-b0a9-8de0ef8b28d3":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"},"5ff40611-460d-4aec-9dd2-3f54ff6413b9":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Conflict","exampleType":"generated"},"83a3884f-3068-43d1-8248-6991ddf601cc":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Gone","exampleType":"generated"},"d09db5e3-a992-47f0-98a4-4fe23dfb17f7":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"},"47d1405b-36ee-45aa-9ee9-44361405612b":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["account_deleting","aether_inference_unserved","agent_pr_blocked","agent_pr_pending","agent_profile_changed","agent_starts_off","agent_starts_on_from_computer_only","agent_uses_own_sign_in","answer_on_its_way","app_identity_missing","attachments_unsupported","attribution_unavailable","bad_gateway","bad_request","base_branch_unusable","branch_exists","caller_inactive","chat_archived","chat_being_forked","chat_moved","chat_not_removable","chat_settings_fixed","chats_not_addable","checkout_not_archivable","cli_upgrade_required","client_outdated","computer_cli_outdated","computer_needs_fresh_sign_in","computer_needs_setup","computer_registered_to_another_person","computer_set_up_elsewhere","computer_starts_no_agents","computer_starts_no_forks","computer_task_start_moved","computer_unreachable","conflict","connection_creator_only","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","credential_kind_not_admitted","credential_named_file","detached_head","download_unsupported","embeddings_unavailable","feature_unsupported","file_references_unsupported","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","fork_in_progress","fork_unsupported","gateway_timeout","github_failed","github_identity_required","github_push_access_required","gone","handed_branch_protected","head_moved","html_render_nul_byte","html_render_too_large","idempotency_key_conflict","idempotency_key_reused","idle_compaction_not_pending","idle_compaction_skipped","inference_proxy_unavailable","insufficient_credits","insufficient_inference_balance","interaction_mode_unsupported","internal_error","invalid_request","last_queued_message","live_protocol_unsupported","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","message_not_waiting","method_not_allowed","mode_forbidden","name_follows_session","no_checkout_on_computer","no_checkpoint_yet","no_commit","no_dispatch_target","no_main_chat","no_origin","no_work_tree_folder","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","open_in_terminal","org_id_required","org_role_insufficient","org_suspended","payment_required","pending_input_answered","permission_prompt_open","pr_automation_unsupported","pr_review_actor_required","pr_review_connection_spent","pr_review_publish_forbidden","precondition_failed","project_has_no_repository","project_not_a_choice","project_required","prompt_decisions_refused","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_failed","question_answers","question_shortened","queue_for_later_unsupported","queued_stop_requires_discard","rate_limited","reasoning_effort_fixed","remote_changes_on_from_computer_only","repository_not_connected","request_canceled","request_expired","request_timeout","request_too_large","review_name_follows_pull_request","sandbox_deleted","sandbox_failed","sandbox_needs_message","service_unavailable","session_file_generation","session_file_hole","session_file_missing","session_file_range_differs","session_gone","session_not_started_by_aether","slash_commands_unsupported","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","start_cancelled","stream_delivery_gap","stream_event_conflict","task_archived","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_connection_disconnected","task_creator_deleted","task_has_no_branch","task_has_no_repository","task_ineligible","task_not_accepting_messages","task_not_pinnable","task_not_started","task_settings_changed","task_start_failed","task_start_pending","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_prompt_closed_otherwise","terminal_chat_prompt_differs","terminal_chat_prompt_not_answered","terminal_chat_removed","terminal_chat_run_moved","terminal_question","too_large","too_many_live_connections","too_many_waiting_messages","turn_running","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","user_suspended","validation_failed","work_tree_repository_differs","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected","workspace_start_failed"],"minLength":1,"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"account_deleting","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"370a0152-9b1d-41e3-ad0c-b4211125a98a":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"70ecc424-f8a8-4f75-bfbf-2bb9b4664f43":{"url":"https://api.runaether.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"aether-c4587800","siteName":"Aether","title":"Report a turn a computer runs with a message - Aether","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T23:17:04.543Z","originalFileLocation":"api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Records what the caller\u0026#x27;s machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message\u0026#x27;s delivery. Use this tool when you need to: - Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot - Report that the computer cannot run it now, and why - Report that the run ended, and how Examples: - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;start\u0026quot;, \u0026quot;asked_at\u0026quot;: \u0026quot;2026-11-08T06:00:00Z\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;queued\u0026quot;, \u0026quot;reason\u0026quot;: \u0026quot;not_signed_in\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;ended\u0026quot;, \u0026quot;outcome\u0026quot;: \u0026quot;finished\u0026quot;, \u0026quot;ended_at\u0026quot;: \u0026quot;2026-11-08T06:04:00Z\u0026quot;} Hints: - A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands. - The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found. - Report ended once the run\u0026#x27;s process and every process it started have exited, with ended_at, when it ended on the computer\u0026#x27;s clock: the chat\u0026#x27;s turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved. - The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller\u0026#x27;s computer is refused with 404 not_found. - Only the grant of the caller\u0026#x27;s coding agent\u0026#x27;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\u0026#x27;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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aether\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Report a turn a computer runs with a message - Aether\">\u003cmeta data-mint-head property=\"og:description\" content=\"Records what the caller\u0026#x27;s machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message\u0026#x27;s delivery. Use this tool when you need to: - Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot - Report that the computer cannot run it now, and why - Report that the run ended, and how Examples: - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;start\u0026quot;, \u0026quot;asked_at\u0026quot;: \u0026quot;2026-11-08T06:00:00Z\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;queued\u0026quot;, \u0026quot;reason\u0026quot;: \u0026quot;not_signed_in\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;ended\u0026quot;, \u0026quot;outcome\u0026quot;: \u0026quot;finished\u0026quot;, \u0026quot;ended_at\u0026quot;: \u0026quot;2026-11-08T06:04:00Z\u0026quot;} Hints: - A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands. - The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found. - Report ended once the run\u0026#x27;s process and every process it started have exited, with ended_at, when it ended on the computer\u0026#x27;s clock: the chat\u0026#x27;s turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved. - The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller\u0026#x27;s computer is refused with 404 not_found. - Only the grant of the caller\u0026#x27;s coding agent\u0026#x27;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\u0026#x27;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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aether\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aether-c4587800.mintlify.site/_mintlify/api/og/v2?division=Computers\u0026amp;title=Report+a+turn+a+computer+runs+with+a+message\u0026amp;description=Records+what+the+caller%27s+machine+bridge+reports+of+a+run+of+a+message+sent+to+the+computer%2C+and+answers+the+run+as+it+then+stands.+A+run+is+the+turn+the+bridge\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=1fd50d01b9b12264b8c2ab5c31eed482a563d40efe38ecb1ae4e2a98da7f6b18\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Report a turn a computer runs with a message - Aether\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Records what the caller\u0026#x27;s machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message\u0026#x27;s delivery. Use this tool when you need to: - Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot - Report that the computer cannot run it now, and why - Report that the run ended, and how Examples: - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;start\u0026quot;, \u0026quot;asked_at\u0026quot;: \u0026quot;2026-11-08T06:00:00Z\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;queued\u0026quot;, \u0026quot;reason\u0026quot;: \u0026quot;not_signed_in\u0026quot;} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\u0026quot;report\u0026quot;: \u0026quot;ended\u0026quot;, \u0026quot;outcome\u0026quot;: \u0026quot;finished\u0026quot;, \u0026quot;ended_at\u0026quot;: \u0026quot;2026-11-08T06:04:00Z\u0026quot;} Hints: - A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands. - The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found. - Report ended once the run\u0026#x27;s process and every process it started have exited, with ended_at, when it ended on the computer\u0026#x27;s clock: the chat\u0026#x27;s turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved. - The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to the caller\u0026#x27;s computer is refused with 404 not_found. - Only the grant of the caller\u0026#x27;s coding agent\u0026#x27;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\u0026#x27;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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aether-c4587800.mintlify.site/_mintlify/api/og/v2?division=Computers\u0026amp;title=Report+a+turn+a+computer+runs+with+a+message\u0026amp;description=Records+what+the+caller%27s+machine+bridge+reports+of+a+run+of+a+message+sent+to+the+computer%2C+and+answers+the+run+as+it+then+stands.+A+run+is+the+turn+the+bridge\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=1fd50d01b9b12264b8c2ab5c31eed482a563d40efe38ecb1ae4e2a98da7f6b18\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/aether-c4587800/RjJo40w5LK5jrZHD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aether\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9184ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.runaether.dev/#organization\",\"name\":\"Aether\",\"url\":\"https://docs.runaether.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/logo/light.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=cdf40b8647da8a5d82a91e289a1958f7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.runaether.dev#website\",\"name\":\"Aether\",\"url\":\"https://docs.runaether.dev\",\"publisher\":{\"@id\":\"https://docs.runaether.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid#webpage\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid\",\"name\":\"Report a turn a computer runs with a message\",\"description\":\"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery. Use this tool when you need to: - Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot - Report that the computer cannot run it now, and why - Report that the run ended, and how Examples: - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"start\\\", \\\"asked_at\\\": \\\"2026-11-08T06:00:00Z\\\"} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"queued\\\", \\\"reason\\\": \\\"not_signed_in\\\"} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"ended\\\", \\\"outcome\\\": \\\"finished\\\", \\\"ended_at\\\": \\\"2026-11-08T06:04:00Z\\\"} Hints: - A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands. - The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found. - Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved. - The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to 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.\",\"dateModified\":\"2026-11-14T23:17:04.543Z\",\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Computers\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/computers/get-computers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Report a turn a computer runs with a message\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid#apireference\",\"headline\":\"Report a turn a computer runs with a message\",\"name\":\"Report a turn a computer runs with a message\",\"description\":\"Records what the caller's machine bridge reports of a run of a message sent to the computer, and answers the run as it then stands. A run is the turn the bridge runs itself, resuming the session with the message as its prompt, when no terminal it can write to has the session open: the bridge reports the run in place of the message's delivery. Use this tool when you need to: - Ask to start the turn of a message the computer holds: Aether starts it, or queues it with the reason it cannot - Report that the computer cannot run it now, and why - Report that the run ended, and how Examples: - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"start\\\", \\\"asked_at\\\": \\\"2026-11-08T06:00:00Z\\\"} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"queued\\\", \\\"reason\\\": \\\"not_signed_in\\\"} - PUT /computers/{computerID}/terminal-chat-runs/{deliveryID} {\\\"report\\\": \\\"ended\\\", \\\"outcome\\\": \\\"finished\\\", \\\"ended_at\\\": \\\"2026-11-08T06:04:00Z\\\"} Hints: - A start runs the turn only while the computer lets Aether start agents, runs fewer than its limit, and runs no other run of the chat; otherwise the answer is queued with agents_off, agent_limit or chat_busy, and the bridge asks again. Start the turn only on an answer of running: the message then reads relayed, and the session file delivers it. A start of a run already running answers it as it stands. - The bridge queues a run itself, before it asks to start it, with open_in_terminal, not_signed_in or claude_not_found. - Report ended once the run's process and every process it started have exited, with ended_at, when it ended on the computer's clock: the chat's turn ends as of then. A run that never started ends only failed, or turn_settings_refused when the bridge does not take the model or thinking level its message was sent with (turn_settings), which it never replaces with others; a retried end of the same outcome answers the run as it stands, and any other report of a run past it is refused with 409 terminal_chat_run_moved. - The first report of a message the bridge took and has not reported (reportTerminalChatDelivery) moves it to wait on the computer, in the same step, as a message reported terminal_closed waits. A message with no run that the bridge reported otherwise, or that settled, is refused with 409 message_not_waiting. A message not sent to 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.\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid#webpage\"},\"dateModified\":\"2026-11-14T23:17:04.543Z\",\"publisher\":{\"@id\":\"https://docs.runaether.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aether\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Aether\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid.md","siteName":"Aether","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Release Notes","href":"/api-reference/release-notes"}]},{"group":"Projects","pages":[{"title":"List projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/projects","href":"/api-reference/endpoints/projects/get-orgs-by-orgid-projects"},{"title":"Create project","openapi":"api-reference/openapi.json POST /orgs/{orgID}/projects","href":"/api-reference/endpoints/projects/post-orgs-by-orgid-projects"},{"title":"Get project","openapi":"api-reference/openapi.json GET /projects/{projectID}","href":"/api-reference/endpoints/projects/get-projects-by-projectid"},{"title":"Get project runtime options","openapi":"api-reference/openapi.json GET /projects/{projectID}/runtime-options","href":"/api-reference/endpoints/projects/get-projects-by-projectid-runtime-options"},{"title":"List the ways a task of a project can start","openapi":"api-reference/openapi.json GET /projects/{projectID}/start-options","href":"/api-reference/endpoints/projects/get-projects-by-projectid-start-options"},{"title":"Get project seed failure","openapi":"api-reference/openapi.json GET /projects/{projectID}/seed-failure","href":"/api-reference/endpoints/projects/get-projects-by-projectid-seed-failure"},{"title":"Update project","openapi":"api-reference/openapi.json PATCH /projects/{projectID}","href":"/api-reference/endpoints/projects/patch-projects-by-projectid"}]},{"group":"Workspaces","pages":[{"title":"List workspaces for a project","openapi":"api-reference/openapi.json GET /projects/{projectID}/workspaces","href":"/api-reference/endpoints/workspaces/get-projects-by-projectid-workspaces"},{"title":"List workspaces across all projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/workspaces","href":"/api-reference/endpoints/workspaces/get-orgs-by-orgid-workspaces"},{"title":"Get a workspace","openapi":"api-reference/openapi.json GET /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/get-workspaces-by-workspaceid"},{"title":"Get a workspace's disk hydration","openapi":"api-reference/openapi.json GET /workspaces/{workspaceID}/hydration","href":"/api-reference/endpoints/workspaces/get-workspaces-by-workspaceid-hydration"},{"title":"Update workspace settings","openapi":"api-reference/openapi.json PATCH /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/patch-workspaces-by-workspaceid"},{"title":"Delete a workspace","openapi":"api-reference/openapi.json DELETE /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/delete-workspaces-by-workspaceid"},{"title":"Create an authenticated preview","openapi":"api-reference/openapi.json POST /workspaces/{workspaceID}/preview-auth","href":"/api-reference/endpoints/workspaces/post-workspaces-by-workspaceid-preview-auth"},{"title":"Stop a workspace","openapi":"api-reference/openapi.json POST /workspaces/{workspaceID}/stop","href":"/api-reference/endpoints/workspaces/post-workspaces-by-workspaceid-stop"}]},{"group":"Tasks","pages":[{"title":"List tasks","openapi":"api-reference/openapi.json GET /orgs/{orgID}/tasks","href":"/api-reference/endpoints/tasks/get-orgs-by-orgid-tasks"},{"title":"Search conversations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/tasks/search","href":"/api-reference/endpoints/tasks/get-orgs-by-orgid-tasks-search"},{"title":"Create a task","openapi":"api-reference/openapi.json POST /orgs/{orgID}/tasks","href":"/api-reference/endpoints/tasks/post-orgs-by-orgid-tasks"},{"title":"Save a task to GitHub","openapi":"api-reference/openapi.json POST /tasks/{taskID}/repository","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-repository"},{"title":"Download a task's work as a zip","openapi":"api-reference/openapi.json GET /tasks/{taskID}/download","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-download"},{"title":"Get a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid"},{"title":"Get the tree containing a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/tree","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-tree"},{"title":"Get what a task was forked from and what was forked from it","openapi":"api-reference/openapi.json GET /tasks/{taskID}/lineage","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-lineage"},{"title":"Get a task's plan","openapi":"api-reference/openapi.json GET /tasks/{taskID}/plan","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-plan"},{"title":"Get how a task runs","openapi":"api-reference/openapi.json GET /tasks/{taskID}/runtime","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-runtime"},{"title":"List a task's activity","openapi":"api-reference/openapi.json GET /tasks/{taskID}/activity","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-activity"},{"title":"List media captured for a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/media","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-media"},{"title":"Hide a capture from the proof page and the Verify panel, or return it to them","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}/media/{mediaID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid-media-by-mediaid"},{"title":"Get one HTML render of a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/html-renders/{renderID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-html-renders-by-renderid"},{"title":"List the cloud devices a task is currently holding","openapi":"api-reference/openapi.json GET /tasks/{taskID}/device-sessions","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-device-sessions"},{"title":"List the provider-native subagents a task owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/subagents","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-subagents"},{"title":"Read one subagent's transcript","openapi":"api-reference/openapi.json GET /tasks/{taskID}/subagents/{toolCallID}/events","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-subagents-by-toolcallid-events"},{"title":"Get the content of one referenced conversation attachment","openapi":"api-reference/openapi.json GET /tasks/{taskID}/messages/{messageID}/attachments/{index}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-messages-by-messageid-attachments-by-index"},{"title":"Get the image one of a task's screen captures returned","openapi":"api-reference/openapi.json GET /tasks/{taskID}/captures/{toolCallID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-captures-by-toolcallid"},{"title":"Change a task","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid"},{"title":"Read accepted open messages and their canonical replacements","openapi":"api-reference/openapi.json GET /tasks/{taskID}/conversation/live","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-conversation-live"},{"title":"Read one task's model spend by what paid for it","openapi":"api-reference/openapi.json GET /tasks/{taskID}/spend","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-spend"},{"title":"Read what one task's metered runs have used so far","openapi":"api-reference/openapi.json GET /tasks/{taskID}/runtime-usage","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-runtime-usage"},{"title":"List a task's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns"},{"title":"Get a task conversation turn","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns/{turnID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns-by-turnid"},{"title":"List the messages a task conversation turn owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns/{turnID}/messages","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns-by-turnid-messages"},{"title":"List a task's chats","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats"},{"title":"List the ways a chat of a task can run","openapi":"api-reference/openapi.json GET /tasks/{taskID}/start-options","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-start-options"},{"title":"Read a task's recorded diff","openapi":"api-reference/openapi.json GET /tasks/{taskID}/diff","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-diff"},{"title":"Start a chat in a task's workspace","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats"},{"title":"Fork a chat into a new chat of its task, or a new task in a sandbox or on one of your computers","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/fork","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-fork"},{"title":"List where a chat can be forked","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/fork-options","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-fork-options"},{"title":"Read one chat of a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid"},{"title":"Change a chat of a task","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid-chats-by-chatid"},{"title":"Remove a chat from Aether","openapi":"api-reference/openapi.json DELETE /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/delete-tasks-by-taskid-chats-by-chatid"},{"title":"Send a chat a message","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/messages","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-messages"},{"title":"Answer what a chat's agent is asking","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/answer","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-answer"},{"title":"Stop a chat's running turn","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/stop","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-stop"},{"title":"List a chat's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns"},{"title":"Read one of a chat's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns/{turnID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns-by-turnid"},{"title":"List the messages one of a chat's turns owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns/{turnID}/messages","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns-by-turnid-messages"},{"title":"Read a chat's open messages and their canonical replacements","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/conversation/live","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-conversation-live"},{"title":"Remove a queued message from a task","openapi":"api-reference/openapi.json DELETE /tasks/{taskID}/messages/{messageID}","href":"/api-reference/endpoints/tasks/delete-tasks-by-taskid-messages-by-messageid"},{"title":"Read a message sent to a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/messages/{messageID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-messages-by-messageid"},{"title":"Send a task a message","openapi":"api-reference/openapi.json POST /tasks/{taskID}/messages","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-messages"},{"title":"Stop a running task","openapi":"api-reference/openapi.json POST /tasks/{taskID}/stop","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-stop"},{"title":"Open a live connection to a task's machine","openapi":"api-reference/openapi.json POST /tasks/{taskID}/connect","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-connect"},{"title":"Keep a task's full context","openapi":"api-reference/openapi.json POST /tasks/{taskID}/idle-compaction/keep","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-idle-compaction-keep"},{"title":"Compact a task's conversation now","openapi":"api-reference/openapi.json POST /tasks/{taskID}/idle-compaction/compact","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-idle-compaction-compact"},{"title":"Fork a task's chat into a new task","openapi":"api-reference/openapi.json POST /tasks/{taskID}/fork","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-fork"},{"title":"Create a task from an imported Codex session","openapi":"api-reference/openapi.json POST /orgs/{orgID}/tasks/teleport","href":"/api-reference/endpoints/tasks/post-orgs-by-orgid-tasks-teleport"}]},{"group":"Environment Variables","pages":[{"title":"List project environment variables","openapi":"api-reference/openapi.json GET /projects/{projectID}/env-vars","href":"/api-reference/endpoints/env-vars/get-projects-by-projectid-env-vars"},{"title":"Import project environment variables","openapi":"api-reference/openapi.json POST /projects/{projectID}/env-vars/import","href":"/api-reference/endpoints/env-vars/post-projects-by-projectid-env-vars-import"},{"title":"Get project environment variable","openapi":"api-reference/openapi.json GET /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/get-projects-by-projectid-env-vars-by-key"},{"title":"Set project environment variable","openapi":"api-reference/openapi.json PUT /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/put-projects-by-projectid-env-vars-by-key"},{"title":"Delete project environment variable","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/delete-projects-by-projectid-env-vars-by-key"}]},{"group":"Secret Files","pages":[{"title":"List project secret files","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files"},{"title":"Bulk upload project secret files","openapi":"api-reference/openapi.json POST /projects/{projectID}/secret-files/bulk","href":"/api-reference/endpoints/secret-files/post-projects-by-projectid-secret-files-bulk"},{"title":"Get project secret file","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files-by-filekey"},{"title":"Get project secret file content","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files/{fileKey}/content","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files-by-filekey-content"},{"title":"Set project secret file","openapi":"api-reference/openapi.json PUT /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/put-projects-by-projectid-secret-files-by-filekey"},{"title":"Delete project secret file","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/delete-projects-by-projectid-secret-files-by-filekey"}]},{"group":"Skills","pages":[{"title":"List project skills","openapi":"api-reference/openapi.json GET /projects/{projectID}/skills","href":"/api-reference/endpoints/skills/get-projects-by-projectid-skills"},{"title":"List user skills","openapi":"api-reference/openapi.json GET /skills","href":"/api-reference/endpoints/skills/get-skills"},{"title":"Upload user skill","openapi":"api-reference/openapi.json POST /skills","href":"/api-reference/endpoints/skills/post-skills"},{"title":"Get user skill","openapi":"api-reference/openapi.json GET /skills/{slug}","href":"/api-reference/endpoints/skills/get-skills-by-slug"},{"title":"List user skill files","openapi":"api-reference/openapi.json GET /skills/{slug}/files","href":"/api-reference/endpoints/skills/get-skills-by-slug-files"},{"title":"Delete user skill","openapi":"api-reference/openapi.json DELETE /skills/{slug}","href":"/api-reference/endpoints/skills/delete-skills-by-slug"},{"title":"List a project's default skills","openapi":"api-reference/openapi.json GET /projects/{projectID}/default-skills","href":"/api-reference/endpoints/skills/get-projects-by-projectid-default-skills"},{"title":"Enable a default skill on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/default-skills/{slug}","href":"/api-reference/endpoints/skills/put-projects-by-projectid-default-skills-by-slug"},{"title":"Disable a default skill on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/default-skills/{slug}","href":"/api-reference/endpoints/skills/delete-projects-by-projectid-default-skills-by-slug"}]},{"group":"Automations","pages":[{"title":"List automations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/automations","href":"/api-reference/endpoints/automations/get-orgs-by-orgid-automations"},{"title":"List project automations","openapi":"api-reference/openapi.json GET /projects/{projectID}/automations","href":"/api-reference/endpoints/automations/get-projects-by-projectid-automations"},{"title":"Get automation","openapi":"api-reference/openapi.json GET /automations/{automationID}","href":"/api-reference/endpoints/automations/get-automations-by-automationid"},{"title":"Delete automation","openapi":"api-reference/openapi.json DELETE /automations/{automationID}","href":"/api-reference/endpoints/automations/delete-automations-by-automationid"},{"title":"Update automation","openapi":"api-reference/openapi.json PATCH /automations/{automationID}","href":"/api-reference/endpoints/automations/patch-automations-by-automationid"},{"title":"List automation runs","openapi":"api-reference/openapi.json GET /automations/{automationID}/runs","href":"/api-reference/endpoints/automations/get-automations-by-automationid-runs"},{"title":"Create project automation","openapi":"api-reference/openapi.json POST /projects/{projectID}/automations","href":"/api-reference/endpoints/automations/post-projects-by-projectid-automations"}]},{"group":"Agent Profiles","pages":[{"title":"List agent profiles","openapi":"api-reference/openapi.json GET /orgs/{orgID}/agent-profiles","href":"/api-reference/endpoints/agent-profiles/get-orgs-by-orgid-agent-profiles"},{"title":"Create agent profile","openapi":"api-reference/openapi.json POST /orgs/{orgID}/agent-profiles","href":"/api-reference/endpoints/agent-profiles/post-orgs-by-orgid-agent-profiles"},{"title":"Get agent profile","openapi":"api-reference/openapi.json GET /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/get-agent-profiles-by-profileid"},{"title":"Update agent profile","openapi":"api-reference/openapi.json PATCH /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/patch-agent-profiles-by-profileid"},{"title":"Delete agent profile","openapi":"api-reference/openapi.json DELETE /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/delete-agent-profiles-by-profileid"}]},{"group":"Agent Choices","pages":[{"title":"List each agent's models, thinking levels and modes","openapi":"api-reference/openapi.json GET /agent-choices","href":"/api-reference/endpoints/agent-choices/get-agent-choices"}]},{"group":"MCP Servers","pages":[{"title":"List the organization's MCP servers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-servers"},{"title":"Probe how a remote MCP server authenticates","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers/probe","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers-probe"},{"title":"Add an MCP server to the organization's catalog","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers"},{"title":"Update an MCP server","openapi":"api-reference/openapi.json PATCH /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/patch-mcp-servers-by-mcpserverid"},{"title":"Delete an MCP server","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid"},{"title":"Preview updating a directory server from its entry","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update-preview","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update-preview"},{"title":"Update a directory server to the revision its preview showed","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update"},{"title":"List the MCP servers a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-servers"},{"title":"Check whether your tasks in a project can start","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-server-readiness","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-server-readiness"},{"title":"Enable an MCP server on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/put-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"Disable an MCP server on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"List your MCP server connections and the organization's","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-server-connections","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-server-connections"},{"title":"Connect an MCP server with your API key","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-connection"},{"title":"Disconnect your MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-connection"},{"title":"Connect an MCP server for the organization","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-org-connection"},{"title":"Disconnect the organization's MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-org-connection"},{"title":"Connect an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-connection-oauth"},{"title":"Connect an MCP server with OAuth for the organization","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/org-connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-org-connection-oauth"},{"title":"Finish connecting an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/oauth/callback","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-oauth-callback"},{"title":"List the organization's OAuth apps","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps"},{"title":"Read the redirect URI an OAuth app registers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps/redirect-uri","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps-redirect-uri"},{"title":"Save the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json PUT /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/put-orgs-by-orgid-mcp-oauth-apps"},{"title":"Delete the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/delete-orgs-by-orgid-mcp-oauth-apps"}]},{"group":"Plugins","pages":[{"title":"List the official plugin marketplaces","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugin-marketplaces","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugin-marketplaces"},{"title":"List the plugins a marketplace offers","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugin-marketplaces/browse","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugin-marketplaces-browse"},{"title":"List the organization's plugins","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugins"},{"title":"Install a plugin in the organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugins"},{"title":"Preview updating a plugin","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update-preview","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update-preview"},{"title":"Update a plugin to the revision its preview showed","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update"},{"title":"Change a plugin's organization-wide defaults","openapi":"api-reference/openapi.json PATCH /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/patch-plugins-by-pluginid"},{"title":"Uninstall a plugin","openapi":"api-reference/openapi.json DELETE /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-plugins-by-pluginid"},{"title":"List the plugins a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/plugins","href":"/api-reference/endpoints/plugins/get-projects-by-projectid-plugins"},{"title":"Enable a plugin on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/put-projects-by-projectid-plugins-by-pluginid"},{"title":"Disable a plugin on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-projects-by-projectid-plugins-by-pluginid"},{"title":"List Aether's integration directory","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-directory","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-directory"},{"title":"Search integrations by name","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search"},{"title":"Search the MCP registry","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search/registry","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search-registry"},{"title":"Install an integration of Aether's integration directory","openapi":"api-reference/openapi.json POST /orgs/{orgID}/integration-directory/{key}/install","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-integration-directory-by-key-install"}]},{"group":"Usage","pages":[{"title":"Get usage summary","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/summary","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-summary"},{"title":"List the tasks that used anything in a range","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/tasks","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-tasks"}]},{"group":"Profile","pages":[{"title":"Get profile","openapi":"api-reference/openapi.json GET /profile","href":"/api-reference/endpoints/profile/get-profile"},{"title":"Delete your account","openapi":"api-reference/openapi.json DELETE /profile","href":"/api-reference/endpoints/profile/delete-profile"},{"title":"Complete onboarding","openapi":"api-reference/openapi.json POST /profile/onboarding/complete","href":"/api-reference/endpoints/profile/post-profile-onboarding-complete"},{"title":"Launch the onboarding task","openapi":"api-reference/openapi.json POST /profile/onboarding/launch","href":"/api-reference/endpoints/profile/post-profile-onboarding-launch"},{"title":"Set up the onboarding repository","openapi":"api-reference/openapi.json POST /profile/onboarding/repo","href":"/api-reference/endpoints/profile/post-profile-onboarding-repo"}]},{"group":"Organizations","pages":[{"title":"List my organizations","openapi":"api-reference/openapi.json GET /orgs","href":"/api-reference/endpoints/orgs/get-orgs"},{"title":"Create a team organization","openapi":"api-reference/openapi.json POST /orgs","href":"/api-reference/endpoints/orgs/post-orgs"},{"title":"Change organization settings","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid"},{"title":"Delete a team organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid"},{"title":"Get an organization's teardown","openapi":"api-reference/openapi.json GET /orgs/{orgID}/teardown","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-teardown"},{"title":"List organization members","openapi":"api-reference/openapi.json GET /orgs/{orgID}/members","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-members"},{"title":"Change an organization member's role","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid-members-by-userid"},{"title":"Remove an organization member","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-by-userid"},{"title":"Leave an organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/me","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-me"},{"title":"Ask the organization's admins for a seat","openapi":"api-reference/openapi.json POST /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-seat-requests"},{"title":"List the organization's seat requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-seat-requests"},{"title":"List the organization's invitations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-invites"},{"title":"Invite a user to an organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites"},{"title":"Revoke an organization invitation","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/invites/{inviteID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-invites-by-inviteid"},{"title":"Resend an organization invitation","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites/{inviteID}/resend","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites-by-inviteid-resend"},{"title":"List my open organization invitations (pending or expired)","openapi":"api-reference/openapi.json GET /invites","href":"/api-reference/endpoints/orgs/get-invites"},{"title":"Accept an organization invitation","openapi":"api-reference/openapi.json POST /invites/{inviteID}/accept","href":"/api-reference/endpoints/orgs/post-invites-by-inviteid-accept"}]},{"group":"User Discovery","pages":[{"title":"Get dismissed discovery keys","openapi":"api-reference/openapi.json GET /user/discovery","href":"/api-reference/endpoints/user-discovery/get-user-discovery"},{"title":"Dismiss a discovery key","openapi":"api-reference/openapi.json PUT /user/discovery/dismissed-keys/{discoveryKey}","href":"/api-reference/endpoints/user-discovery/put-user-discovery-dismissed-keys-by-discoverykey"}]},{"group":"User Flags","pages":[{"title":"Get your feature flags","openapi":"api-reference/openapi.json GET /user/flags","href":"/api-reference/endpoints/user-flags/get-user-flags"}]},{"group":"Pull Requests","pages":[{"title":"List the organization's pull requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests"},{"title":"Count the organization's pull requests per section","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests/sections","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests-sections"},{"title":"Get one pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid"},{"title":"Get one pull request's review","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review"},{"title":"Get one file's content at a reviewed commit of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/file","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-file"},{"title":"Get the snapshot of a pull request head: its changed files against the base tip, their patches and their contents at the head","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/head-snapshot","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-head-snapshot"},{"title":"Retry the capture of a pull request head's snapshot that gave up","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/head-snapshot/capture","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-head-snapshot-capture"},{"title":"Get the whole stack a reviewed pull request belongs to","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/stack","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-stack"},{"title":"Request an Aether review of a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/runs","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-runs"},{"title":"Dispatch pull request feedback to Aether","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/dispatch","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-dispatch"},{"title":"List Aether feedback dispatches for a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/dispatches","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-dispatches"},{"title":"Get a pull request's merge box and checks","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github"},{"title":"Post a top-level comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments"},{"title":"Reply to a review comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/replies","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-replies"},{"title":"Resolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/resolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-resolve"},{"title":"Unresolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/unresolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-unresolve"},{"title":"Get a pull request's changed files with unified-diff patches","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/diff","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-diff"},{"title":"Merge a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/merge","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-merge"},{"title":"Convert a pull request to a draft","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/draft","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-draft"},{"title":"Mark a draft pull request ready for review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/ready","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-ready"},{"title":"Close a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/close","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-close"},{"title":"Reopen a closed pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reopen","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reopen"},{"title":"Request a reviewer on a pull request","openapi":"api-reference/openapi.json PUT /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/put-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Withdraw a reviewer's request on a pull request","openapi":"api-reference/openapi.json DELETE /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/delete-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Submit a human pull request review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reviews","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reviews"},{"title":"List a pull request's review threads","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/threads","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-threads"},{"title":"List a pull request's activity","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/activity","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-activity"},{"title":"List a pull request's recorded verification events","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/verification-events","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-verification-events"},{"title":"Get everything recorded as proof of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-proof"},{"title":"Change who may watch a pull request's proof","openapi":"api-reference/openapi.json PATCH /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/patch-pull-requests-by-pullrequestid-proof"},{"title":"Resolve a pull request by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number"},{"title":"Resolve a pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number-proof"},{"title":"Get a public pull request's proof","openapi":"api-reference/openapi.json GET /public/pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-pull-requests-by-pullrequestid-proof"},{"title":"Resolve where a task's public proof is watched","openapi":"api-reference/openapi.json GET /public/tasks/{taskID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-tasks-by-taskid-proof"},{"title":"Resolve a public pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /public/repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-public-repos-by-owner-by-repo-pulls-by-number-proof"}]},{"group":"Push Tokens","pages":[{"title":"Register an Expo push token for the current user","openapi":"api-reference/openapi.json POST /user/push-tokens","href":"/api-reference/endpoints/push-tokens/post-user-push-tokens"},{"title":"Unregister an Expo push token for the current user","openapi":"api-reference/openapi.json DELETE /user/push-tokens/{pushToken}","href":"/api-reference/endpoints/push-tokens/delete-user-push-tokens-by-pushtoken"}]},{"group":"Computers","pages":[{"title":"List your computers","openapi":"api-reference/openapi.json GET /computers","href":"/api-reference/endpoints/computers/get-computers"},{"title":"Register a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid"},{"title":"Update a computer","openapi":"api-reference/openapi.json PATCH /computers/{computerID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid"},{"title":"Remove a computer","openapi":"api-reference/openapi.json DELETE /computers/{computerID}","href":"/api-reference/endpoints/computers/delete-computers-by-computerid"},{"title":"Find or create the task of a checkout","openapi":"api-reference/openapi.json POST /computers/{computerID}/work-tree-tasks","href":"/api-reference/endpoints/computers/post-computers-by-computerid-work-tree-tasks"},{"title":"List the repositories mirrored from a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/repositories","href":"/api-reference/endpoints/computers/get-computers-by-computerid-repositories"},{"title":"Find or create the chat of a terminal session","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Report a terminal chat's status","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Read what Aether holds of a terminal chat's session file","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Ship a range of a terminal chat's session file","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Read a stop sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report how a stop sent to a computer settled","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report a terminal chat's prompt","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Wait for a terminal chat prompt's answer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Close a terminal chat's prompt","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Read a continuation sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Report a continuation a computer carried out","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Read a message sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-deliveries-by-deliveryid"},{"title":"Report what became of a message sent to a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","description":"Records what the caller's machine bridge reports of a message from Aether sent to the computer, and answers the message as it then stands.\n\nUse this tool when you need to:\n- Report that the session's bridge handed the message to the session's inbox\n- Report that the session's terminal is closed, so the message waits on the computer\n- Report that the message could not be delivered, or that whether it reached the session is unknown\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-deliveries/{deliveryID} {\"report\": \"relayed\"}\n- PUT /computers/{computerID}/terminal-chat-deliveries/{deliveryID} {\"report\": \"terminal_closed\"}\n\nHints:\n- report is relayed, terminal_closed, slash_command, session_unreachable or unknown. Report unknown, never a failure, once the message may have reached the session.\n- A message is reported once, while it is pending: a later report changes nothing and answers the message as it stands, so a retried report is harmless.\n- A message not sent to the caller's computer is refused with 404 not_found.\n- 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.\n- 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.","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-deliveries-by-deliveryid"},{"title":"Report a turn a computer runs with a message","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-runs/{deliveryID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid"},{"title":"List the turns a computer runs or holds","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-runs","description":"Lists the runs the caller's machine bridge acts on: each queued run, to ask to start again, and each running run, the oldest first, with the session it resumes and its message.\n\nUse this tool when you need to:\n- Start the queued runs once what held them back is gone: a run ended, the computer was let start agents, Claude Code was signed in\n- Learn, after the bridge restarted, which runs Aether holds running, to watch them or report how they ended\n\nExamples:\n- GET /computers/{computerID}/terminal-chat-runs\n\nHints:\n- Ask to start a queued run with reportTerminalChatRun {\"report\": \"start\", \"asked_at\": \"2026-11-08T06:00:00Z\"}; it answers running or queued again.\n- turn_settings are the model and thinking level its message was sent with, which the run's claude runs with (--model, --effort), each null for the computer's Claude Code's own.\n- A computer that is not the caller's is refused with 404 not_found.\n- 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.\n- 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.","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-runs"},{"title":"Export a chat's Claude Code session file to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file","href":"/api-reference/endpoints/computers/get-computers-by-computerid-tasks-by-taskid-chats-by-chatid-session-file"},{"title":"Record that a folder's next terminal chat is a fork of a chat","openapi":"api-reference/openapi.json POST /computers/{computerID}/pending-terminal-forks","href":"/api-reference/endpoints/computers/post-computers-by-computerid-pending-terminal-forks"},{"title":"List the tasks a computer is to start","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts"},{"title":"Read a task a computer is to start","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts/{startID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts-by-startid"},{"title":"Report a task a computer started","openapi":"api-reference/openapi.json PUT /computers/{computerID}/task-starts/{startID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-task-starts-by-startid"},{"title":"Read a file a fork started on a computer places","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts/{startID}/files/{file}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts-by-startid-files-by-file"},{"title":"Read what a computer diffs a task's work tree by","openapi":"api-reference/openapi.json GET /computers/{computerID}/tasks/{taskID}/work-tree","href":"/api-reference/endpoints/computers/get-computers-by-computerid-tasks-by-taskid-work-tree"},{"title":"Record a task's diff","openapi":"api-reference/openapi.json PUT /computers/{computerID}/tasks/{taskID}/diffs/{diffID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-tasks-by-taskid-diffs-by-diffid"}]},{"group":"Agent","pages":[{"title":"Get your agent","openapi":"api-reference/openapi.json GET /agent","href":"/api-reference/endpoints/agent/get-agent"},{"title":"List your agent's events","openapi":"api-reference/openapi.json GET /agent/events","href":"/api-reference/endpoints/agent/get-agent-events"},{"title":"List your conversation with your agent","openapi":"api-reference/openapi.json GET /agent/messages","href":"/api-reference/endpoints/agent/get-agent-messages"},{"title":"Send your agent a message","openapi":"api-reference/openapi.json POST /agent/messages","href":"/api-reference/endpoints/agent/post-agent-messages"},{"title":"Get your agent's memory","openapi":"api-reference/openapi.json GET /agent/memory","href":"/api-reference/endpoints/agent/get-agent-memory"},{"title":"Edit your agent's memory","openapi":"api-reference/openapi.json POST /agent/memory/edits","href":"/api-reference/endpoints/agent/post-agent-memory-edits"},{"title":"Get an edit of your agent's memory","openapi":"api-reference/openapi.json GET /agent/memory/edits/{editID}","href":"/api-reference/endpoints/agent/get-agent-memory-edits-by-editid"},{"title":"List your agent's tool calls this month","openapi":"api-reference/openapi.json GET /agent/tool-usage","href":"/api-reference/endpoints/agent/get-agent-tool-usage"},{"title":"Change your agent","openapi":"api-reference/openapi.json PATCH /agent","href":"/api-reference/endpoints/agent/patch-agent"},{"title":"Issue a single-use link","openapi":"api-reference/openapi.json POST /agent/links","href":"/api-reference/endpoints/agent/post-agent-links"},{"title":"Redeem a single-use link","openapi":"api-reference/openapi.json POST /agent/links/redeem","href":"/api-reference/endpoints/agent/post-agent-links-redeem"},{"title":"Paste a code on a single-use link","openapi":"api-reference/openapi.json POST /agent/links/paste","href":"/api-reference/endpoints/agent/post-agent-links-paste"},{"title":"Pick up the code pasted on a single-use link","openapi":"api-reference/openapi.json POST /agent/links/pickup","href":"/api-reference/endpoints/agent/post-agent-links-pickup"},{"title":"Get a connector","openapi":"api-reference/openapi.json GET /agent/connectors/{key}","href":"/api-reference/endpoints/agent/get-agent-connectors-by-key"},{"title":"Get your phone link","openapi":"api-reference/openapi.json GET /agent/phone","href":"/api-reference/endpoints/agent/get-agent-phone"},{"title":"Ask for a code to link your phone","openapi":"api-reference/openapi.json POST /agent/phone/verification","href":"/api-reference/endpoints/agent/post-agent-phone-verification"},{"title":"Delete your agent","openapi":"api-reference/openapi.json DELETE /agent","href":"/api-reference/endpoints/agent/delete-agent"}]},{"group":"Connections","pages":[{"title":"List your connections","openapi":"api-reference/openapi.json GET /connections","href":"/api-reference/endpoints/connections/get-connections"},{"title":"Add a connection: Claude plan","openapi":"api-reference/openapi.json POST /connections/claude-plan","href":"/api-reference/endpoints/connections/post-connections-claude-plan"},{"title":"Add a connection: Anthropic API key","openapi":"api-reference/openapi.json POST /connections/anthropic-api-key","href":"/api-reference/endpoints/connections/post-connections-anthropic-api-key"},{"title":"Add a connection: OpenAI API key","openapi":"api-reference/openapi.json POST /connections/openai-api-key","href":"/api-reference/endpoints/connections/post-connections-openai-api-key"},{"title":"Add a connection: OpenRouter API key","openapi":"api-reference/openapi.json POST /connections/openrouter-api-key","href":"/api-reference/endpoints/connections/post-connections-openrouter-api-key"},{"title":"Add a connection: OpenCode auth file","openapi":"api-reference/openapi.json POST /connections/opencode-auth-file","href":"/api-reference/endpoints/connections/post-connections-opencode-auth-file"},{"title":"Start a ChatGPT plan device sign-in","openapi":"api-reference/openapi.json POST /connections/chatgpt-plan/device-auths","href":"/api-reference/endpoints/connections/post-connections-chatgpt-plan-device-auths"},{"title":"Read a ChatGPT plan device sign-in","openapi":"api-reference/openapi.json GET /connections/chatgpt-plan/device-auths/{deviceAuthID}","href":"/api-reference/endpoints/connections/get-connections-chatgpt-plan-device-auths-by-deviceauthid"},{"title":"Reconnect a connection","openapi":"api-reference/openapi.json POST /connections/{connectionID}/reconnect","href":"/api-reference/endpoints/connections/post-connections-by-connectionid-reconnect"},{"title":"Rename a connection","openapi":"api-reference/openapi.json PATCH /connections/{connectionID}","href":"/api-reference/endpoints/connections/patch-connections-by-connectionid"},{"title":"Disconnect a connection","openapi":"api-reference/openapi.json DELETE /connections/{connectionID}","href":"/api-reference/endpoints/connections/delete-connections-by-connectionid"},{"title":"List your connection defaults","openapi":"api-reference/openapi.json GET /connections/defaults","href":"/api-reference/endpoints/connections/get-connections-defaults"},{"title":"Set a harness's default connection","openapi":"api-reference/openapi.json PUT /connections/defaults/{harness}","href":"/api-reference/endpoints/connections/put-connections-defaults-by-harness"},{"title":"Set the fallback of a harness's default connection","openapi":"api-reference/openapi.json PATCH /connections/defaults/{harness}","href":"/api-reference/endpoints/connections/patch-connections-defaults-by-harness"}]},{"group":"Slack","pages":[{"title":"Get Slack install URL","openapi":"api-reference/openapi.json GET /orgs/{orgID}/auth/slack/url","href":"/api-reference/endpoints/slack/get-orgs-by-orgid-auth-slack-url"},{"title":"List Slack channels","openapi":"api-reference/openapi.json GET /orgs/{orgID}/slack/channels","href":"/api-reference/endpoints/slack/get-orgs-by-orgid-slack-channels"},{"title":"Disconnect Slack","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/slack/connection","href":"/api-reference/endpoints/slack/delete-orgs-by-orgid-slack-connection"},{"title":"Update Slack connection","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/slack/connection","href":"/api-reference/endpoints/slack/patch-orgs-by-orgid-slack-connection"},{"title":"Link my Slack identity","openapi":"api-reference/openapi.json POST /slack/identity/link","href":"/api-reference/endpoints/slack/post-slack-identity-link"},{"title":"Unlink my Slack identity","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/slack/identity/link","href":"/api-reference/endpoints/slack/delete-orgs-by-orgid-slack-identity-link"},{"title":"List Slack routes","openapi":"api-reference/openapi.json GET /orgs/{orgID}/slack/routes","href":"/api-reference/endpoints/slack/get-orgs-by-orgid-slack-routes"},{"title":"Create Slack route","openapi":"api-reference/openapi.json POST /orgs/{orgID}/slack/routes","href":"/api-reference/endpoints/slack/post-orgs-by-orgid-slack-routes"},{"title":"Update Slack route","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/slack/routes/{routeID}","href":"/api-reference/endpoints/slack/patch-orgs-by-orgid-slack-routes-by-routeid"},{"title":"Delete Slack route","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/slack/routes/{routeID}","href":"/api-reference/endpoints/slack/delete-orgs-by-orgid-slack-routes-by-routeid"},{"title":"Get Slack status","openapi":"api-reference/openapi.json GET /orgs/{orgID}/slack/status","href":"/api-reference/endpoints/slack/get-orgs-by-orgid-slack-status"}]},{"group":"Sentry","pages":[{"title":"Get Sentry install URL","openapi":"api-reference/openapi.json GET /orgs/{orgID}/auth/sentry/url","href":"/api-reference/endpoints/sentry/get-orgs-by-orgid-auth-sentry-url"},{"title":"Disconnect Sentry","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/sentry/connection","href":"/api-reference/endpoints/sentry/delete-orgs-by-orgid-sentry-connection"},{"title":"Update Sentry connection","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/sentry/connection","href":"/api-reference/endpoints/sentry/patch-orgs-by-orgid-sentry-connection"},{"title":"List Sentry routes","openapi":"api-reference/openapi.json GET /orgs/{orgID}/sentry/routes","href":"/api-reference/endpoints/sentry/get-orgs-by-orgid-sentry-routes"},{"title":"Create Sentry route","openapi":"api-reference/openapi.json POST /orgs/{orgID}/sentry/routes","href":"/api-reference/endpoints/sentry/post-orgs-by-orgid-sentry-routes"},{"title":"Update Sentry route","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/sentry/routes/{routeID}","href":"/api-reference/endpoints/sentry/patch-orgs-by-orgid-sentry-routes-by-routeid"},{"title":"Delete Sentry route","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/sentry/routes/{routeID}","href":"/api-reference/endpoints/sentry/delete-orgs-by-orgid-sentry-routes-by-routeid"},{"title":"List Sentry projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/sentry/projects","href":"/api-reference/endpoints/sentry/get-orgs-by-orgid-sentry-projects"},{"title":"Get Sentry status","openapi":"api-reference/openapi.json GET /orgs/{orgID}/sentry/status","href":"/api-reference/endpoints/sentry/get-orgs-by-orgid-sentry-status"}]},{"group":"Feedback","pages":[{"title":"Submit feedback","openapi":"api-reference/openapi.json POST /feedback","href":"/api-reference/endpoints/feedback/post-feedback"}]},{"group":"Notifications","pages":[{"title":"Get notification preferences","openapi":"api-reference/openapi.json GET /user/notification-preferences","href":"/api-reference/endpoints/notifications/get-user-notification-preferences"},{"title":"Update notification preferences","openapi":"api-reference/openapi.json PATCH /user/notification-preferences","href":"/api-reference/endpoints/notifications/patch-user-notification-preferences"},{"title":"List notifications","openapi":"api-reference/openapi.json GET /user/notifications","href":"/api-reference/endpoints/notifications/get-user-notifications"},{"title":"Count tasks waiting on you","openapi":"api-reference/openapi.json GET /user/waiting-task-count","href":"/api-reference/endpoints/notifications/get-user-waiting-task-count"},{"title":"Resolve task notifications","openapi":"api-reference/openapi.json POST /user/notifications/tasks/{taskID}/resolve","href":"/api-reference/endpoints/notifications/post-user-notifications-tasks-by-taskid-resolve"},{"title":"Dismiss notification","openapi":"api-reference/openapi.json POST /user/notifications/{notificationID}/dismiss","href":"/api-reference/endpoints/notifications/post-user-notifications-by-notificationid-dismiss"}]},{"group":"GitHub","pages":[{"title":"Get GitHub install URL","openapi":"api-reference/openapi.json GET /auth/github/url","href":"/api-reference/endpoints/github/get-auth-github-url"},{"title":"Get GitHub authorize URL","openapi":"api-reference/openapi.json GET /auth/github/authorize-url","href":"/api-reference/endpoints/github/get-auth-github-authorize-url"},{"title":"Claim GitHub installations from an OAuth code","openapi":"api-reference/openapi.json POST /github/installations/claim","href":"/api-reference/endpoints/github/post-github-installations-claim"},{"title":"Disconnect GitHub","openapi":"api-reference/openapi.json DELETE /github/connection","href":"/api-reference/endpoints/github/delete-github-connection"},{"title":"List GitHub repos","openapi":"api-reference/openapi.json GET /github/repos","href":"/api-reference/endpoints/github/get-github-repos"},{"title":"Get a GitHub repo","openapi":"api-reference/openapi.json GET /github/repos/{owner}/{repo}","href":"/api-reference/endpoints/github/get-github-repos-by-owner-by-repo"},{"title":"Get GitHub status","openapi":"api-reference/openapi.json GET /github/status","href":"/api-reference/endpoints/github/get-github-status"},{"title":"List GitHub repo branch suggestions","openapi":"api-reference/openapi.json GET /projects/{projectID}/github/branch-suggestions","href":"/api-reference/endpoints/github/get-projects-by-projectid-github-branch-suggestions"},{"title":"Import GitHub repo","openapi":"api-reference/openapi.json POST /projects/{projectID}/github/import","href":"/api-reference/endpoints/github/post-projects-by-projectid-github-import"},{"title":"Get GitHub project link","openapi":"api-reference/openapi.json GET /projects/{projectID}/github/link","href":"/api-reference/endpoints/github/get-projects-by-projectid-github-link"},{"title":"Fetch GitHub repo tree","openapi":"api-reference/openapi.json GET /projects/{projectID}/github/tree","href":"/api-reference/endpoints/github/get-projects-by-projectid-github-tree"}]},{"group":"Platform API Keys","pages":[{"title":"List platform API keys","openapi":"api-reference/openapi.json GET /user/platform-keys","href":"/api-reference/endpoints/platform-keys/get-user-platform-keys"},{"title":"Create platform API key","openapi":"api-reference/openapi.json POST /orgs/{orgID}/platform-keys","href":"/api-reference/endpoints/platform-keys/post-orgs-by-orgid-platform-keys"},{"title":"Revoke platform API key","openapi":"api-reference/openapi.json DELETE /user/platform-keys/{platformKeyID}","href":"/api-reference/endpoints/platform-keys/delete-user-platform-keys-by-platformkeyid"}]},{"group":"User Settings","pages":[{"title":"Get user settings","openapi":"api-reference/openapi.json GET /user/settings","href":"/api-reference/endpoints/user-settings/get-user-settings"},{"title":"Update user settings","openapi":"api-reference/openapi.json PATCH /user/settings","href":"/api-reference/endpoints/user-settings/patch-user-settings"}]},{"group":"Billing","pages":[{"title":"Get billing catalog","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/catalog","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-catalog"},{"title":"Get inference balance","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/inference-balance","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-inference-balance"},{"title":"Create billing checkout session","openapi":"api-reference/openapi.json POST /orgs/{orgID}/billing/checkout-sessions","href":"/api-reference/endpoints/billing/post-orgs-by-orgid-billing-checkout-sessions"},{"title":"Bind a store transaction to a purchase intent","openapi":"api-reference/openapi.json POST /orgs/{orgID}/billing/checkout-sessions/{checkoutSessionID}/transaction","href":"/api-reference/endpoints/billing/post-orgs-by-orgid-billing-checkout-sessions-by-checkoutsessionid-transaction"},{"title":"Get billing checkout session","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/checkout-sessions/{lookup}","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-checkout-sessions-by-lookup"},{"title":"List billing credit packs","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/credit-packs","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-credit-packs"},{"title":"Create billing portal session","openapi":"api-reference/openapi.json POST /orgs/{orgID}/billing/portal-sessions","href":"/api-reference/endpoints/billing/post-orgs-by-orgid-billing-portal-sessions"},{"title":"List the caller's unassigned store purchases","openapi":"api-reference/openapi.json GET /billing/store/unassigned-purchases","href":"/api-reference/endpoints/billing/get-billing-store-unassigned-purchases"},{"title":"Claim an unassigned store purchase into an org","openapi":"api-reference/openapi.json POST /billing/store/unassigned-purchases/{transactionID}/claim","href":"/api-reference/endpoints/billing/post-billing-store-unassigned-purchases-by-transactionid-claim"},{"title":"List billing warm slots","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/slots","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-slots"},{"title":"Assign a project to a billing warm slot","openapi":"api-reference/openapi.json PUT /orgs/{orgID}/billing/slots/{slotIndex}","href":"/api-reference/endpoints/billing/put-orgs-by-orgid-billing-slots-by-slotindex"},{"title":"Release a billing warm slot","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/billing/slots/{slotIndex}","href":"/api-reference/endpoints/billing/delete-orgs-by-orgid-billing-slots-by-slotindex"},{"title":"Get billing subscription","openapi":"api-reference/openapi.json GET /orgs/{orgID}/billing/subscription","href":"/api-reference/endpoints/billing/get-orgs-by-orgid-billing-subscription"}]},{"group":"Linear","pages":[{"title":"Get Linear install URL","openapi":"api-reference/openapi.json GET /orgs/{orgID}/auth/linear/url","href":"/api-reference/endpoints/linear/get-orgs-by-orgid-auth-linear-url"},{"title":"Disconnect Linear","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/linear/connection","href":"/api-reference/endpoints/linear/delete-orgs-by-orgid-linear-connection"},{"title":"Update Linear connection","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/linear/connection","href":"/api-reference/endpoints/linear/patch-orgs-by-orgid-linear-connection"},{"title":"List Linear projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/linear/projects","href":"/api-reference/endpoints/linear/get-orgs-by-orgid-linear-projects"},{"title":"List Linear routes","openapi":"api-reference/openapi.json GET /orgs/{orgID}/linear/routes","href":"/api-reference/endpoints/linear/get-orgs-by-orgid-linear-routes"},{"title":"Create Linear route","openapi":"api-reference/openapi.json POST /orgs/{orgID}/linear/routes","href":"/api-reference/endpoints/linear/post-orgs-by-orgid-linear-routes"},{"title":"Update Linear route","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/linear/routes/{routeID}","href":"/api-reference/endpoints/linear/patch-orgs-by-orgid-linear-routes-by-routeid"},{"title":"Delete Linear route","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/linear/routes/{routeID}","href":"/api-reference/endpoints/linear/delete-orgs-by-orgid-linear-routes-by-routeid"},{"title":"Get Linear status","openapi":"api-reference/openapi.json GET /orgs/{orgID}/linear/status","href":"/api-reference/endpoints/linear/get-orgs-by-orgid-linear-status"},{"title":"List Linear teams","openapi":"api-reference/openapi.json GET /orgs/{orgID}/linear/teams","href":"/api-reference/endpoints/linear/get-orgs-by-orgid-linear-teams"}]},{"group":"WebSocket","pages":[{"title":"WebSocket Overview","href":"/api-reference/websocket/overview"},{"title":"Terminal Channel","href":"/api-reference/websocket/terminal"},{"title":"Files Channel","href":"/api-reference/websocket/files"},{"title":"Agent Channel","href":"/api-reference/websocket/agent"},{"title":"Ports Channel","href":"/api-reference/websocket/ports"},{"title":"Git Channel","href":"/api-reference/websocket/git"}]}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli/overview"}]}]},"basePath":"","title":"Report a turn a computer runs with a message - Aether","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}