Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it.
Use this tool when you need to:
- Show a permission request Claude Code holds open in the terminal, and notify its person
- Show that a terminal chat waits on a question in the terminal
Examples:
- PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {"kind": "permission", "tool_name": "Bash", "tool_input": {"command": "git push origin main"}, "input_shortened": false, "hold_seconds": 3000}
Hints:
- promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs.
- The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone.
- A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422.
- tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400.
- decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else.
- Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt.
- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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.
How long from now the bridge holds the hook open, in seconds: the prompt expires then.
Required range: 1 <= x <= 7200
input_shortened
boolean
required
The bridge cut the input's longest strings to fit it in 64 KiB.
kind
enum<string>
required
permission asks to run a tool call, answerable from Aether; question asks in the terminal alone (AskUserQuestion, ExitPlanMode), or, a run's, from Aether alone.
Available options:
permission,
question
tool_input
object
required
The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.
tool_name
string
required
The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.
Required string length: 1 - 200
decisions
object[]
permission only: what the request offers beside allow and deny, which every permission request offers, from what the agent itself suggested. Absent when it offers nothing else. Each adds, for the agent's session alone, allow rules the agent suggested for the request's own tool; the bridge names no change of mode, no folder and no write to a settings file. A report naming anything else, an id twice, an id allow or deny, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused.
Required array length: 1 - 8 elements
Show child attributes
run_id
string<uuid>
The run whose hooks reported the prompt (reportTerminalChatRun's delivery_id): no terminal answers it, so Aether shows a question of it as answerable too. Absent for a terminal's.
Response
OK
chat_id
string<uuid>
required
expires_at
string<date-time>
required
id
string<uuid>
required
input_shortened
boolean
required
kind
enum<string>
required
Available options:
permission,
question
requested_at
string<date-time>
required
state
object
required
Waiting on the person, in Aether and in the terminal; a run's, in Aether alone.
Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Show child attributes
tool_input
object
required
The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.
tool_name
string
required
The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.
Required string length: 1 - 200
{"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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-chats-by-sessionid-prompts-by-promptid","slug":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid","pageMetadata":{"title":"Report a terminal chat's prompt","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","description":"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it.\n\nUse this tool when you need to:\n- Show a permission request Claude Code holds open in the terminal, and notify its person\n- Show that a terminal chat waits on a question in the terminal\n\nExamples:\n- PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\"kind\": \"permission\", \"tool_name\": \"Bash\", \"tool_input\": {\"command\": \"git push origin main\"}, \"input_shortened\": false, \"hold_seconds\": 3000}\n\nHints:\n- promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs.\n- The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone.\n- A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422.\n- tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400.\n- decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else.\n- Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt.\n- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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-chats-by-sessionid-prompts-by-promptid"},"description":"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it.\n\nUse this tool when you need to:\n- Show a permission request Claude Code holds open in the terminal, and notify its person\n- Show that a terminal chat waits on a question in the terminal\n\nExamples:\n- PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\"kind\": \"permission\", \"tool_name\": \"Bash\", \"tool_input\": {\"command\": \"git push origin main\"}, \"input_shortened\": false, \"hold_seconds\": 3000}\n\nHints:\n- promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs.\n- The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone.\n- A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422.\n- tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400.\n- decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else.\n- Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt.\n- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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 terminal chat's prompt","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","description":"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it.\n\nUse this tool when you need to:\n- Show a permission request Claude Code holds open in the terminal, and notify its person\n- Show that a terminal chat waits on a question in the terminal\n\nExamples:\n- PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\"kind\": \"permission\", \"tool_name\": \"Bash\", \"tool_input\": {\"command\": \"git push origin main\"}, \"input_shortened\": false, \"hold_seconds\": 3000}\n\nHints:\n- promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs.\n- The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone.\n- A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422.\n- tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400.\n- decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else.\n- Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt.\n- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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-chats-by-sessionid-prompts-by-promptid"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it.\n\nUse this tool when you need to:\n- Show a permission request Claude Code holds open in the terminal, and notify its person\n- Show that a terminal chat waits on a question in the terminal\n\nExamples:\n- PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\"kind\": \"permission\", \"tool_name\": \"Bash\", \"tool_input\": {\"command\": \"git push origin main\"}, \"input_shortened\": false, \"hold_seconds\": 3000}\n\nHints:\n- promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs.\n- The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone.\n- A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422.\n- tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400.\n- decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else.\n- Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt.\n- A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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":"openTerminalChatPrompt","parameters":["e8d153be-9a3b-435f-8da5-387f8b0e070f","8dc7f8ea-683f-402a-b8a5-0c2b2a0e32c5","b6ae0b49-daef-4474-9e2d-37b817dcb42f"],"requestBody":"adf66e69-d184-440f-951e-5d3f060ad313","responses":{"200":"bdac7e5c-1c41-47ab-aae0-5e411882ec22","401":"d57b945a-1a19-4730-9964-0043db45d797","403":"6815a380-86fe-4912-a0e9-367f808e00e6","404":"73ffb5a5-9938-4075-a865-ded8c9c69ae6","409":"cf931841-3f53-4143-86e8-d25353903f73","410":"3714c12c-f066-4f6c-ba0a-6d9d043da843","422":"eaa8a51e-d113-456c-8f9e-ff099c86343a","500":"5aa3fc9a-d11e-46c5-b991-5d2ca6a4d8eb"},"summary":"Report a terminal chat's prompt","tags":["computers"],"x-aether-access":{"principal":"user","kinds":["grant"],"scope":"write","org":"person"},"x-aether-label":"computers.terminalChats.prompts.open","x-aether-path-ids":{"computerID":"-","promptID":"-","sessionID":"-"},"method":"put","type":"path","servers":["70ecc424-f8a8-4f75-bfbf-2bb9b4664f43"],"security":["370a0152-9b1d-41e3-ad0c-b4211125a98a"],"path":"/computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","baseUrlOptions":["https://api.runaether.dev"],"title":"Report a terminal chat's prompt","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e8d153be-9a3b-435f-8da5-387f8b0e070f":{"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>"}},"8dc7f8ea-683f-402a-b8a5-0c2b2a0e32c5":{"in":"path","name":"sessionID","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>"}},"b6ae0b49-daef-4474-9e2d-37b817dcb42f":{"in":"path","name":"promptID","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":{"hold_seconds":{"description":"How long from now the bridge holds the hook open, in seconds: the prompt expires then.","maximum":7200,"minimum":1,"type":"integer","isRequired":true,"uniqueKey":"hold_seconds","typeLabel":"integer"},"input_shortened":{"description":"The bridge cut the input's longest strings to fit it in 64 KiB.","type":"boolean","isRequired":true,"uniqueKey":"input_shortened","typeLabel":"boolean"},"kind":{"description":"permission asks to run a tool call, answerable from Aether; question asks in the terminal alone (AskUserQuestion, ExitPlanMode), or, a run's, from Aether alone.","enum":["permission","question"],"type":"string","isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"tool_input":{"additionalProperties":true,"description":"The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.","properties":{},"type":"object","isRequired":true,"uniqueKey":"tool_input","typeLabel":"object"},"tool_name":{"description":"The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.","maxLength":200,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"tool_name","typeLabel":"string"},"decisions":{"description":"permission only: what the request offers beside allow and deny, which every permission request offers, from what the agent itself suggested. Absent when it offers nothing else. Each adds, for the agent's session alone, allow rules the agent suggested for the request's own tool; the bridge names no change of mode, no folder and no write to a settings file. A report naming anything else, an id twice, an id allow or deny, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused.","items":{"additionalProperties":false,"properties":{"behavior":{"enum":["allow"],"type":"string","isRequired":true,"uniqueKey":"decisions.items.[INDEX].behavior","typeLabel":"enum\u003cstring>"},"destination":{"description":"The rules hold for the agent's session alone, and are written to no settings file.","enum":["session"],"type":"string","isRequired":true,"uniqueKey":"decisions.items.[INDEX].destination","typeLabel":"enum\u003cstring>"},"id":{"description":"Names the decision in the answer; neither allow nor deny.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","isRequired":true,"uniqueKey":"decisions.items.[INDEX].id","typeLabel":"string"},"rules":{"items":{"additionalProperties":false,"properties":{"tool_name":{"description":"The request's own tool.","maxLength":200,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"decisions.items.[INDEX].rules.items.[INDEX].tool_name","typeLabel":"string"},"rule_content":{"description":"What of the tool the rule matches, as Claude Code writes a rule's content (npm test *); absent for the whole tool.","maxLength":200,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"decisions.items.[INDEX].rules.items.[INDEX].rule_content","typeLabel":"string"}},"required":["tool_name"],"type":"object","uniqueKey":"decisions.items.[INDEX].rules.items.[INDEX]","typeLabel":"object"},"maxItems":8,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"decisions.items.[INDEX].rules","typeLabel":"object[]"},"type":{"enum":["add_rules"],"type":"string","isRequired":true,"uniqueKey":"decisions.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["id","type","behavior","destination","rules"],"type":"object","uniqueKey":"decisions.items.[INDEX]","typeLabel":"object"},"maxItems":8,"minItems":1,"type":"array","uniqueKey":"decisions","typeLabel":"object[]"},"run_id":{"description":"The run whose hooks reported the prompt (reportTerminalChatRun's delivery_id): no terminal answers it, so Aether shows a question of it as answerable too. Absent for a terminal's.","format":"uuid","type":"string","uniqueKey":"run_id","typeLabel":"string\u003cuuid>"}},"required":["kind","tool_name","tool_input","input_shortened","hold_seconds"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"hold_seconds":3600,"input_shortened":true,"tool_input":{},"tool_name":"\u003cstring>","decisions":[{"behavior":"allow","destination":"session","id":"\u003cstring>","rules":[{"tool_name":"\u003cstring>","rule_content":"\u003cstring>"}],"type":"add_rules"}],"run_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"bdac7e5c-1c41-47ab-aae0-5e411882ec22":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"chat_id":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"chat_id","typeLabel":"string\u003cuuid>"},"expires_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"id":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"input_shortened":{"type":"boolean","isRequired":true,"uniqueKey":"input_shortened","typeLabel":"boolean"},"kind":{"enum":["permission","question"],"type":"string","isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"requested_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"requested_at","typeLabel":"string\u003cdate-time>"},"state":{"oneOf":[{"type":"object","description":"Waiting on the person, in Aether and in the terminal; a run's, in Aether alone.","required":["kind"],"properties":{"kind":{"enum":["open"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.0.kind","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.0","typeLabel":"object"},{"type":"object","description":"Answered from Aether, on its way to the hook.","required":["kind","answer"],"properties":{"answer":{"additionalProperties":false,"properties":{"answered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"state.oneOf.1.answer.answered_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"allow lets the tool call run; deny refuses it.","enum":["allow","deny"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.1.answer.decision","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.1.answer.reason.oneOf.0","typeLabel":"string"},{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"null","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.1.answer.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.1.answer.reason","typeLabel":"string | null"},"answers":{"additionalProperties":{"maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"state.oneOf.1.answer.answers.additionalProperties","typeLabel":"string"},"description":"The answer to each question of a run's AskUserQuestion, keyed by the question, when it was answered so; absent otherwise.","type":"object","uniqueKey":"state.oneOf.1.answer.answers","typeLabel":"object"},"decision_id":{"description":"The decision the request was opened with that an allow picked: the bridge adds its rules for the session alone, from what it holds of the request. Absent on a plain allow, on a denial, and on every answer to a request opened with no decisions.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","uniqueKey":"state.oneOf.1.answer.decision_id","typeLabel":"string"}},"required":["decision","reason","answered_at"],"type":"object","isRequired":true,"uniqueKey":"state.oneOf.1.answer","typeLabel":"object"},"kind":{"enum":["answered"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.1.kind","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.1","typeLabel":"object"},{"type":"object","description":"The answer from Aether reached Claude Code.","required":["kind","answer"],"properties":{"answer":{"additionalProperties":false,"properties":{"answered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"state.oneOf.2.answer.answered_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"allow lets the tool call run; deny refuses it.","enum":["allow","deny"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.2.answer.decision","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.2.answer.reason.oneOf.0","typeLabel":"string"},{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"null","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.2.answer.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.2.answer.reason","typeLabel":"string | null"},"answers":{"additionalProperties":{"maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"state.oneOf.2.answer.answers.additionalProperties","typeLabel":"string"},"description":"The answer to each question of a run's AskUserQuestion, keyed by the question, when it was answered so; absent otherwise.","type":"object","uniqueKey":"state.oneOf.2.answer.answers","typeLabel":"object"},"decision_id":{"description":"The decision the request was opened with that an allow picked: the bridge adds its rules for the session alone, from what it holds of the request. Absent on a plain allow, on a denial, and on every answer to a request opened with no decisions.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","uniqueKey":"state.oneOf.2.answer.decision_id","typeLabel":"string"}},"required":["decision","reason","answered_at"],"type":"object","isRequired":true,"uniqueKey":"state.oneOf.2.answer","typeLabel":"object"},"kind":{"enum":["answered_from_aether"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.2.kind","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.2","typeLabel":"object"},{"type":"object","description":"The terminal answered first; late_answer is an answer from Aether Claude Code never got, null when there was none.","required":["kind","late_answer"],"properties":{"kind":{"enum":["answered_in_terminal"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"late_answer":{"oneOf":[{"type":"object","required":["decision","reason","answered_at"],"properties":{"answered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0.answered_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"allow lets the tool call run; deny refuses it.","enum":["allow","deny"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0.decision","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"null","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0.reason","typeLabel":"string | null"},"answers":{"additionalProperties":{"maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"state.oneOf.3.late_answer.oneOf.0.answers.additionalProperties","typeLabel":"string"},"description":"The answer to each question of a run's AskUserQuestion, keyed by the question, when it was answered so; absent otherwise.","type":"object","uniqueKey":"state.oneOf.3.late_answer.oneOf.0.answers","typeLabel":"object"},"decision_id":{"description":"The decision the request was opened with that an allow picked: the bridge adds its rules for the session alone, from what it holds of the request. Absent on a plain allow, on a denial, and on every answer to a request opened with no decisions.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","uniqueKey":"state.oneOf.3.late_answer.oneOf.0.decision_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"state.oneOf.3.late_answer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.3.late_answer","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.3","typeLabel":"object"},{"type":"object","description":"A stop from Aether ended the turn first: Claude Code denied the tool call and stopped. late_answer is an answer from Aether Claude Code never got, null when there was none.","required":["kind","late_answer"],"properties":{"kind":{"enum":["stopped"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"late_answer":{"oneOf":[{"type":"object","required":["decision","reason","answered_at"],"properties":{"answered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0.answered_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"allow lets the tool call run; deny refuses it.","enum":["allow","deny"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0.decision","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"null","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0.reason","typeLabel":"string | null"},"answers":{"additionalProperties":{"maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"state.oneOf.4.late_answer.oneOf.0.answers.additionalProperties","typeLabel":"string"},"description":"The answer to each question of a run's AskUserQuestion, keyed by the question, when it was answered so; absent otherwise.","type":"object","uniqueKey":"state.oneOf.4.late_answer.oneOf.0.answers","typeLabel":"object"},"decision_id":{"description":"The decision the request was opened with that an allow picked: the bridge adds its rules for the session alone, from what it holds of the request. Absent on a plain allow, on a denial, and on every answer to a request opened with no decisions.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","uniqueKey":"state.oneOf.4.late_answer.oneOf.0.decision_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"state.oneOf.4.late_answer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.4.late_answer","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.4","typeLabel":"object"},{"type":"object","description":"The hold ended first and the prompt stays in the terminal, or, a run's, was denied; late_answer is an answer from Aether that did not reach the hook in time, null when there was none.","required":["kind","late_answer"],"properties":{"kind":{"enum":["expired"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"late_answer":{"oneOf":[{"type":"object","required":["decision","reason","answered_at"],"properties":{"answered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0.answered_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"allow lets the tool call run; deny refuses it.","enum":["allow","deny"],"type":"string","isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0.decision","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"description":"What a denial tells Claude; null for an approval and for a denial that gave none.","maxLength":2000,"minLength":1,"type":"null","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0.reason","typeLabel":"string | null"},"answers":{"additionalProperties":{"maxLength":2000,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","uniqueKey":"state.oneOf.5.late_answer.oneOf.0.answers.additionalProperties","typeLabel":"string"},"description":"The answer to each question of a run's AskUserQuestion, keyed by the question, when it was answered so; absent otherwise.","type":"object","uniqueKey":"state.oneOf.5.late_answer.oneOf.0.answers","typeLabel":"object"},"decision_id":{"description":"The decision the request was opened with that an allow picked: the bridge adds its rules for the session alone, from what it holds of the request. Absent on a plain allow, on a denial, and on every answer to a request opened with no decisions.","pattern":"^[a-z][a-z0-9_]{0,63}$","type":"string","uniqueKey":"state.oneOf.5.late_answer.oneOf.0.decision_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"state.oneOf.5.late_answer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state.oneOf.5.late_answer","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"state.oneOf.5","typeLabel":"object"}],"isRequired":true,"uniqueKey":"state","typeLabel":"object"},"tool_input":{"additionalProperties":true,"description":"The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.","properties":{},"type":"object","isRequired":true,"uniqueKey":"tool_input","typeLabel":"object"},"tool_name":{"description":"The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.","maxLength":200,"minLength":1,"type":"string","x-aether-string-length-unit":"unicode-code-point","isRequired":true,"uniqueKey":"tool_name","typeLabel":"string"}},"required":["id","chat_id","kind","tool_name","tool_input","input_shortened","requested_at","expires_at","state"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"chat_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","expires_at":"2023-11-07T05:31:56Z","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","input_shortened":true,"kind":"permission","requested_at":"2023-11-07T05:31:56Z","state":{"kind":"open"},"tool_input":{},"tool_name":"\u003cstring>"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"d57b945a-1a19-4730-9964-0043db45d797":{"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"},"6815a380-86fe-4912-a0e9-367f808e00e6":{"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"},"73ffb5a5-9938-4075-a865-ded8c9c69ae6":{"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"},"cf931841-3f53-4143-86e8-d25353903f73":{"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"},"3714c12c-f066-4f6c-ba0a-6d9d043da843":{"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"},"eaa8a51e-d113-456c-8f9e-ff099c86343a":{"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"},"5aa3fc9a-d11e-46c5-b991-5d2ca6a4d8eb":{"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 terminal chat's prompt - Aether","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T15:10:47.369Z","originalFileLocation":"api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid.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 a terminal chat\u0026#x27;s Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it. Use this tool when you need to: - Show a permission request Claude Code holds open in the terminal, and notify its person - Show that a terminal chat waits on a question in the terminal Examples: - PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\u0026quot;kind\u0026quot;: \u0026quot;permission\u0026quot;, \u0026quot;tool_name\u0026quot;: \u0026quot;Bash\u0026quot;, \u0026quot;tool_input\u0026quot;: {\u0026quot;command\u0026quot;: \u0026quot;git push origin main\u0026quot;}, \u0026quot;input_shortened\u0026quot;: false, \u0026quot;hold_seconds\u0026quot;: 3000} Hints: - promptID is the bridge\u0026#x27;s own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs. - The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone. - A prompt of a turn the bridge runs itself carries run_id, the run\u0026#x27;s delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422. - tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double\u0026#x27;s range included, is refused with 400. - decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent\u0026#x27;s session alone, allow rules the agent itself suggested for the request\u0026#x27;s own tool, the one kind Aether offers. A person\u0026#x27;s answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else. - Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt. - A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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 terminal chat\u0026#x27;s prompt - Aether\">\u003cmeta data-mint-head property=\"og:description\" content=\"Records what a terminal chat\u0026#x27;s Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it. Use this tool when you need to: - Show a permission request Claude Code holds open in the terminal, and notify its person - Show that a terminal chat waits on a question in the terminal Examples: - PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\u0026quot;kind\u0026quot;: \u0026quot;permission\u0026quot;, \u0026quot;tool_name\u0026quot;: \u0026quot;Bash\u0026quot;, \u0026quot;tool_input\u0026quot;: {\u0026quot;command\u0026quot;: \u0026quot;git push origin main\u0026quot;}, \u0026quot;input_shortened\u0026quot;: false, \u0026quot;hold_seconds\u0026quot;: 3000} Hints: - promptID is the bridge\u0026#x27;s own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs. - The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone. - A prompt of a turn the bridge runs itself carries run_id, the run\u0026#x27;s delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422. - tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double\u0026#x27;s range included, is refused with 400. - decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent\u0026#x27;s session alone, allow rules the agent itself suggested for the request\u0026#x27;s own tool, the one kind Aether offers. A person\u0026#x27;s answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else. - Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt. - A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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-chats-by-sessionid-prompts-by-promptid\">\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+terminal+chat%27s+prompt\u0026amp;description=Records+what+a+terminal+chat%27s+Claude+Code+session+waits+on+its+person+for%2C+from+its+PermissionRequest+hook%2C+and+answers+the+prompt.+A+permission+prompt+asks+to\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=d4f880ec6a8fb1a3a4226fcfd35472bc25111363eb4e8e9b82d0c0f5e260e36b\">\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 terminal chat\u0026#x27;s prompt - Aether\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Records what a terminal chat\u0026#x27;s Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it. Use this tool when you need to: - Show a permission request Claude Code holds open in the terminal, and notify its person - Show that a terminal chat waits on a question in the terminal Examples: - PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\u0026quot;kind\u0026quot;: \u0026quot;permission\u0026quot;, \u0026quot;tool_name\u0026quot;: \u0026quot;Bash\u0026quot;, \u0026quot;tool_input\u0026quot;: {\u0026quot;command\u0026quot;: \u0026quot;git push origin main\u0026quot;}, \u0026quot;input_shortened\u0026quot;: false, \u0026quot;hold_seconds\u0026quot;: 3000} Hints: - promptID is the bridge\u0026#x27;s own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs. - The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone. - A prompt of a turn the bridge runs itself carries run_id, the run\u0026#x27;s delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422. - tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double\u0026#x27;s range included, is refused with 400. - decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent\u0026#x27;s session alone, allow rules the agent itself suggested for the request\u0026#x27;s own tool, the one kind Aether offers. A person\u0026#x27;s answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else. - Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt. - A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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+terminal+chat%27s+prompt\u0026amp;description=Records+what+a+terminal+chat%27s+Claude+Code+session+waits+on+its+person+for%2C+from+its+PermissionRequest+hook%2C+and+answers+the+prompt.+A+permission+prompt+asks+to\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=d4f880ec6a8fb1a3a4226fcfd35472bc25111363eb4e8e9b82d0c0f5e260e36b\">\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-chats-by-sessionid-prompts-by-promptid\">\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-chats-by-sessionid-prompts-by-promptid.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-chats-by-sessionid-prompts-by-promptid#webpage\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid\",\"name\":\"Report a terminal chat's prompt\",\"description\":\"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it. Use this tool when you need to: - Show a permission request Claude Code holds open in the terminal, and notify its person - Show that a terminal chat waits on a question in the terminal Examples: - PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\\\"kind\\\": \\\"permission\\\", \\\"tool_name\\\": \\\"Bash\\\", \\\"tool_input\\\": {\\\"command\\\": \\\"git push origin main\\\"}, \\\"input_shortened\\\": false, \\\"hold_seconds\\\": 3000} Hints: - promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs. - The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone. - A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422. - tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400. - decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else. - Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt. - A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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-17T15:10:47.369Z\",\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid#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 terminal chat's prompt\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid#apireference\",\"headline\":\"Report a terminal chat's prompt\",\"name\":\"Report a terminal chat's prompt\",\"description\":\"Records what a terminal chat's Claude Code session waits on its person for, from its PermissionRequest hook, and answers the prompt. A permission prompt asks to run one tool call: the machine bridge holds the hook open for hold_seconds while Aether shows it and notifies the person, who answers from Aether or in the terminal, whichever comes first. A question (AskUserQuestion, or the plan ExitPlanMode asks to approve) is answered in the terminal alone; Aether shows it. Use this tool when you need to: - Show a permission request Claude Code holds open in the terminal, and notify its person - Show that a terminal chat waits on a question in the terminal Examples: - PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID} {\\\"kind\\\": \\\"permission\\\", \\\"tool_name\\\": \\\"Bash\\\", \\\"tool_input\\\": {\\\"command\\\": \\\"git push origin main\\\"}, \\\"input_shortened\\\": false, \\\"hold_seconds\\\": 3000} Hints: - promptID is the bridge's own id of the prompt: reporting it again answers the same prompt, its hold unmoved, and notifies nobody twice. A prompt of the id that asks something else is refused with 409 terminal_chat_prompt_differs. - The prompt expires hold_seconds from the first report: the hook then answers no decision, and the prompt stays in the terminal alone. - A prompt of a turn the bridge runs itself carries run_id, the run's delivery_id (reportTerminalChatRun): no terminal answers it, so Aether shows its question as answerable too, and the bridge denies it when its hold ends unanswered and closes it expired. A run the chat holds none of is refused with 422. - tool_input holds at most 64 KiB as Postgres stores it, each key once and no NUL character: a longer input is refused with 422. Shorten its strings and set input_shortened. A body the API cannot read, a number past a double's range included, is refused with 400. - decisions, on a permission prompt, names what it offers beside allow and deny: an allow that adds, for the agent's session alone, allow rules the agent itself suggested for the request's own tool, the one kind Aether offers. A person's answer that picks one reads with decision_id. Any other kind, an id allow or deny or named twice, more than 8 decisions or rules, a rule of another tool, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused (a value the schema does not take with 422 validation_failed). A report of the same id with other decisions asks something else. - Wait for the answer with getTerminalChatPrompt and close the prompt with closeTerminalChatPrompt. - A session the computer holds no chat of for the caller (ensureTerminalChat creates it), or a computer that is not theirs, 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-chats-by-sessionid-prompts-by-promptid\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid#webpage\"},\"dateModified\":\"2026-11-17T15:10:47.369Z\",\"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-chats-by-sessionid-prompts-by-promptid.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}","description":"Records how a stop of a terminal chat's turn sent to the caller's computer settled, as its machine bridge reports it, and answers the stop.\n\nUse this tool when you need to:\n- Report that a tool hook of the turn was answered with the stop, which ended the turn there\n- Report that the turn ended by itself first, or that no turn ran when the stop arrived\n\nExamples:\n- PUT /computers/{computerID}/terminal-chat-stops/{stopID} {\"outcome\": \"stopped\"}\n\nHints:\n- outcome is stopped, turn_ended or nothing_to_stop. A stop settles once: a later report changes nothing and answers the stop as it settled, so a retried report is harmless.\n- Report a stop's outcome before the chat status it brings (patchTerminalChat): a turn reported ended settles the chat's stops still unsettled as turn_ended.\n- A stop 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-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}","description":"Answers a terminal chat's prompt once it is no longer open (answered from Aether, or closed), or as it stands after wait_seconds. The machine bridge holds a permission prompt's hook open while it waits.\n\nUse this tool when you need to:\n- Learn the answer from Aether to a permission prompt the bridge holds, as soon as the person gives it\n\nExamples:\n- GET /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}?wait_seconds=25\n\nHints:\n- state is open, answered (the answer to hand the hook: allow, or deny with the reason Claude reads), answered_from_aether, answered_in_terminal, stopped or expired. An open prompt past its expires_at reads expired.\n- wait_seconds is 0 to 25; read again while the prompt is open and the hold lasts.\n- A prompt the chat does not hold, a session the computer holds no chat of for the caller, or a computer that is not theirs, 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-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}","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","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 terminal chat's prompt - 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"]}