Reads the task’s whole current plan: its steps, each with its work and checks, and the earlier steps it replaced.
Use this tool when you need to:
See every step of a task’s plan, which one is in progress and what is left
Find the checks run and the tool calls or cloud agents spawned while a step was worked
Examples:
GET /tasks//plan
GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan
Hints:
taskID is the task’s lowercase uuid; there are no other parameters.
steps are in the agent’s order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan.
earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds.
The task’s plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found.
Use getTask instead for the plan’s counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names.
Any member of the task’s organization may read it, a viewer included, and an agent host’s grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller’s reach is 404 not_found; 503 when the membership check is unavailable.
{"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":"6af26ce7f1d8ff0c24b93b53","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":340},{"language":"default","tag":"Tasks","count":55},{"language":"default","tag":"CLI Reference","count":41},{"language":"default","tag":"Pull Requests","count":35},{"language":"default","tag":"Guides","count":29},{"language":"default","tag":"Computers","count":27},{"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":"llms-txt-v2","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":"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":"comment-mode","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/tasks/get-tasks-by-taskid-plan","slug":"/api-reference/endpoints/tasks/get-tasks-by-taskid-plan","pageMetadata":{"title":"Get a task's plan","openapi":"api-reference/openapi.json GET /tasks/{taskID}/plan","description":"Reads the task's whole current plan: its steps, each with its work and checks, and the earlier steps it replaced.\n\nUse this tool when you need to:\n- See every step of a task's plan, which one is in progress and what is left\n- Find the checks run and the tool calls or cloud agents spawned while a step was worked\n\nExamples:\n- GET /tasks/{taskID}/plan\n- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan\n\nHints:\n- taskID is the task's lowercase uuid; there are no other parameters.\n- steps are in the agent's order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan.\n- earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds.\n- The task's plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found.\n- Use getTask instead for the plan's counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names.\n- Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-plan"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Reads the task’s whole current plan: its steps, each with its work and checks, and the earlier steps it replaced.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Use this tool when you need to:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"See every step of a task’s plan, which one is in progress and what is left\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Find the checks run and the tool calls or cloud agents spawned while a step was worked\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Examples:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"GET /tasks/\", \"/plan\"]\n }), \"\\n\", _jsx(_components.li, {\n children: \"GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Hints:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"taskID is the task’s lowercase uuid; there are no other parameters.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"steps are in the agent’s order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"The task’s plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Use getTask instead for the plan’s counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Any member of the task’s organization may read it, a viewer included, and an agent host’s grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller’s reach is 404 not_found; 503 when the membership check is unavailable.\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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":"Get a task's plan","openapi":"api-reference/openapi.json GET /tasks/{taskID}/plan","description":"Reads the task's whole current plan: its steps, each with its work and checks, and the earlier steps it replaced.\n\nUse this tool when you need to:\n- See every step of a task's plan, which one is in progress and what is left\n- Find the checks run and the tool calls or cloud agents spawned while a step was worked\n\nExamples:\n- GET /tasks/{taskID}/plan\n- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan\n\nHints:\n- taskID is the task's lowercase uuid; there are no other parameters.\n- steps are in the agent's order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan.\n- earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds.\n- The task's plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found.\n- Use getTask instead for the plan's counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names.\n- Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-plan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Reads the task's whole current plan: its steps, each with its work and checks, and the earlier steps it replaced.\n\nUse this tool when you need to:\n- See every step of a task's plan, which one is in progress and what is left\n- Find the checks run and the tool calls or cloud agents spawned while a step was worked\n\nExamples:\n- GET /tasks/{taskID}/plan\n- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan\n\nHints:\n- taskID is the task's lowercase uuid; there are no other parameters.\n- steps are in the agent's order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan.\n- earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds.\n- The task's plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found.\n- Use getTask instead for the plan's counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names.\n- Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.","operationId":"getTaskPlan","parameters":["e2f3e47d-5389-40c1-9137-6234c3053563"],"responses":{"200":"4e3325d5-7931-4c88-9747-4e86f77e5d1c","401":"f289e1fc-d1e4-47a7-b5b3-e2ec6f8fda70","403":"316e368e-3ebb-449d-94d0-a2008976d20a","404":"9efb234a-85bd-4149-ae26-e49ca03be97c","422":"bd9d94bb-d574-45b8-b9a7-4fb1282c37d9","500":"7f368b32-b566-4664-92b6-0d4c05ee7169","503":"f5c779dd-16ce-4a84-94f9-9f36d1c6eee5"},"summary":"Get a task's plan","tags":["tasks"],"x-aether-access":{"principal":"user","kinds":["jwt","api_key","agent_host"],"scope":"read","capability":"read_product","org":"resource"},"x-aether-label":"tasks.plan.get","method":"get","type":"path","servers":["66ab535b-c4ec-41e3-98da-d80687cb1fb1"],"security":["9afdaa3a-ab5d-440b-98ad-31a38432c246"],"path":"/tasks/{taskID}/plan","baseUrlOptions":["https://api.runaether.dev"],"title":"Get a task's plan","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e2f3e47d-5389-40c1-9137-6234c3053563":{"in":"path","name":"taskID","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>"}}},"responses":{"4e3325d5-7931-4c88-9747-4e86f77e5d1c":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"completed":{"format":"int64","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"completed","typeLabel":"integer\u003cint64>"},"earlier_steps":{"items":{"additionalProperties":false,"properties":{"content":{"minLength":1,"pattern":"\\S","type":"string","isRequired":true,"uniqueKey":"earlier_steps.items.[INDEX].content","typeLabel":"string"},"id":{"description":"The step's key: the stream sequence its plan window starts at, and its position in that window.","pattern":"^[0-9]+:[0-9]+$","type":"string","isRequired":true,"uniqueKey":"earlier_steps.items.[INDEX].id","typeLabel":"string"},"work":{"additionalProperties":false,"properties":{"cloud_agent_task_ids":{"items":{"format":"uuid","type":"string","uniqueKey":"earlier_steps.items.[INDEX].work.cloud_agent_task_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"type":"array","isRequired":true,"uniqueKey":"earlier_steps.items.[INDEX].work.cloud_agent_task_ids","typeLabel":"string\u003cuuid>[]"},"ledger_tool_call_ids":{"items":{"minLength":1,"type":"string","uniqueKey":"earlier_steps.items.[INDEX].work.ledger_tool_call_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"earlier_steps.items.[INDEX].work.ledger_tool_call_ids","typeLabel":"string[]"}},"required":["ledger_tool_call_ids","cloud_agent_task_ids"],"type":"object","isRequired":true,"uniqueKey":"earlier_steps.items.[INDEX].work","typeLabel":"object"}},"required":["id","content","work"],"type":"object","uniqueKey":"earlier_steps.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"earlier_steps","typeLabel":"object[]"},"steps":{"items":{"additionalProperties":false,"properties":{"checks":{"items":{"additionalProperties":false,"properties":{"kind":{"enum":["tests","typecheck","lint","browser_check","preview_session"],"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].checks.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"outcome":{"enum":["passed","failed"],"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].checks.items.[INDEX].outcome","typeLabel":"enum\u003cstring>"}},"required":["kind","outcome"],"type":"object","uniqueKey":"steps.items.[INDEX].checks.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"steps.items.[INDEX].checks","typeLabel":"object[]"},"content":{"minLength":1,"pattern":"\\S","type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].content","typeLabel":"string"},"status":{"enum":["pending","in_progress","completed"],"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"work":{"additionalProperties":false,"properties":{"cloud_agent_task_ids":{"items":{"format":"uuid","type":"string","uniqueKey":"steps.items.[INDEX].work.cloud_agent_task_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"type":"array","isRequired":true,"uniqueKey":"steps.items.[INDEX].work.cloud_agent_task_ids","typeLabel":"string\u003cuuid>[]"},"ledger_tool_call_ids":{"items":{"minLength":1,"type":"string","uniqueKey":"steps.items.[INDEX].work.ledger_tool_call_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"steps.items.[INDEX].work.ledger_tool_call_ids","typeLabel":"string[]"}},"required":["ledger_tool_call_ids","cloud_agent_task_ids"],"type":"object","isRequired":true,"uniqueKey":"steps.items.[INDEX].work","typeLabel":"object"},"active_form":{"minLength":1,"pattern":"\\S","type":"string","uniqueKey":"steps.items.[INDEX].active_form","typeLabel":"string"}},"required":["content","status","checks","work"],"type":"object","uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"total":{"format":"int64","minimum":1,"type":"integer","isRequired":true,"uniqueKey":"total","typeLabel":"integer\u003cint64>"},"unclaimed_work":{"additionalProperties":false,"properties":{"cloud_agent_task_ids":{"items":{"format":"uuid","type":"string","uniqueKey":"unclaimed_work.cloud_agent_task_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"type":"array","isRequired":true,"uniqueKey":"unclaimed_work.cloud_agent_task_ids","typeLabel":"string\u003cuuid>[]"},"ledger_tool_call_ids":{"items":{"minLength":1,"type":"string","uniqueKey":"unclaimed_work.ledger_tool_call_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"unclaimed_work.ledger_tool_call_ids","typeLabel":"string[]"}},"required":["ledger_tool_call_ids","cloud_agent_task_ids"],"type":"object","isRequired":true,"uniqueKey":"unclaimed_work","typeLabel":"object"},"updated_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"current_step":{"minLength":1,"pattern":"\\S","type":"string","uniqueKey":"current_step","typeLabel":"string"},"explanation":{"minLength":1,"pattern":"\\S","type":"string","uniqueKey":"explanation","typeLabel":"string"}},"required":["steps","completed","total","updated_at","earlier_steps","unclaimed_work"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"completed":1,"earlier_steps":[{"content":"\u003cstring>","id":"\u003cstring>","work":{"cloud_agent_task_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"ledger_tool_call_ids":["\u003cstring>"]}}],"steps":[{"checks":[{"kind":"tests","outcome":"passed"}],"content":"\u003cstring>","status":"pending","work":{"cloud_agent_task_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"ledger_tool_call_ids":["\u003cstring>"]},"active_form":"\u003cstring>"}],"total":2,"unclaimed_work":{"cloud_agent_task_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"ledger_tool_call_ids":["\u003cstring>"]},"updated_at":"2023-11-07T05:31:56Z","current_step":"\u003cstring>","explanation":"\u003cstring>"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"f289e1fc-d1e4-47a7-b5b3-e2ec6f8fda70":{"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","app_identity_missing","attribution_unavailable","bad_gateway","bad_request","caller_inactive","chat_archived","computer_connection_stale","computer_starts_no_agents","computer_starts_no_forks","computer_unreachable","conflict","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","creator_github_access_missing","embeddings_unavailable","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","gateway_timeout","github_claim_unverified","github_failed","github_identity_mismatch","github_identity_required","github_push_access_required","github_reconnect_required","github_ref_not_found","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","internal_error","invalid_request","last_queued_message","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","method_not_allowed","mode_forbidden","no_checkout_on_computer","no_dispatch_target","no_turn_running","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","org_id_required","org_role_insufficient","org_suspended","payment_required","permission_prompt_answered_in_terminal","permission_prompt_expired","permission_prompt_open","permission_prompt_stopped","pr_review_actor_required","pr_review_publish_forbidden","precondition_failed","project_archived","project_has_no_repository","project_repo_disconnected","project_repository_differs","project_required","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_file_too_large","push_rejected","push_secret_detected","question_answers","queued_stop_requires_discard","rate_limited","repository_administration_not_granted","repository_already_connected","repository_create_forbidden","repository_create_rejected","repository_created_not_linked","repository_owner_not_caller","request_canceled","request_timeout","request_too_large","save_in_progress","save_requires_task_creator","service_unavailable","slash_command","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","stream_delivery_gap","stream_event_conflict","task_already_saved","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_bound_at_creation","task_branch_diverged","task_branch_is_default","task_branch_mismatch","task_branch_missing","task_connection_disconnected","task_creator_deleted","task_executing","task_file_too_large","task_fork_refused","task_has_no_commits","task_has_no_files","task_has_no_repository","task_history_has_merges","task_ineligible","task_is_child","task_not_accepting_messages","task_not_pinnable","task_not_started","task_rebase_in_progress","task_settings_changed","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_run_running","terminal_question","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","validation_failed","working_tree_dirty","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected"],"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"},"316e368e-3ebb-449d-94d0-a2008976d20a":{"content":{"application/json":{"schema":{"additionalProperties":false,"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":"code","typeLabel":"enum\u003cstring>"},"error":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error","code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"org_membership_required","error":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"9efb234a-85bd-4149-ae26-e49ca03be97c":{"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","app_identity_missing","attribution_unavailable","bad_gateway","bad_request","caller_inactive","chat_archived","computer_connection_stale","computer_starts_no_agents","computer_starts_no_forks","computer_unreachable","conflict","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","creator_github_access_missing","embeddings_unavailable","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","gateway_timeout","github_claim_unverified","github_failed","github_identity_mismatch","github_identity_required","github_push_access_required","github_reconnect_required","github_ref_not_found","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","internal_error","invalid_request","last_queued_message","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","method_not_allowed","mode_forbidden","no_checkout_on_computer","no_dispatch_target","no_turn_running","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","org_id_required","org_role_insufficient","org_suspended","payment_required","permission_prompt_answered_in_terminal","permission_prompt_expired","permission_prompt_open","permission_prompt_stopped","pr_review_actor_required","pr_review_publish_forbidden","precondition_failed","project_archived","project_has_no_repository","project_repo_disconnected","project_repository_differs","project_required","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_file_too_large","push_rejected","push_secret_detected","question_answers","queued_stop_requires_discard","rate_limited","repository_administration_not_granted","repository_already_connected","repository_create_forbidden","repository_create_rejected","repository_created_not_linked","repository_owner_not_caller","request_canceled","request_timeout","request_too_large","save_in_progress","save_requires_task_creator","service_unavailable","slash_command","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","stream_delivery_gap","stream_event_conflict","task_already_saved","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_bound_at_creation","task_branch_diverged","task_branch_is_default","task_branch_mismatch","task_branch_missing","task_connection_disconnected","task_creator_deleted","task_executing","task_file_too_large","task_fork_refused","task_has_no_commits","task_has_no_files","task_has_no_repository","task_history_has_merges","task_ineligible","task_is_child","task_not_accepting_messages","task_not_pinnable","task_not_started","task_rebase_in_progress","task_settings_changed","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_run_running","terminal_question","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","validation_failed","working_tree_dirty","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected"],"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"},"bd9d94bb-d574-45b8-b9a7-4fb1282c37d9":{"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","app_identity_missing","attribution_unavailable","bad_gateway","bad_request","caller_inactive","chat_archived","computer_connection_stale","computer_starts_no_agents","computer_starts_no_forks","computer_unreachable","conflict","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","creator_github_access_missing","embeddings_unavailable","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","gateway_timeout","github_claim_unverified","github_failed","github_identity_mismatch","github_identity_required","github_push_access_required","github_reconnect_required","github_ref_not_found","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","internal_error","invalid_request","last_queued_message","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","method_not_allowed","mode_forbidden","no_checkout_on_computer","no_dispatch_target","no_turn_running","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","org_id_required","org_role_insufficient","org_suspended","payment_required","permission_prompt_answered_in_terminal","permission_prompt_expired","permission_prompt_open","permission_prompt_stopped","pr_review_actor_required","pr_review_publish_forbidden","precondition_failed","project_archived","project_has_no_repository","project_repo_disconnected","project_repository_differs","project_required","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_file_too_large","push_rejected","push_secret_detected","question_answers","queued_stop_requires_discard","rate_limited","repository_administration_not_granted","repository_already_connected","repository_create_forbidden","repository_create_rejected","repository_created_not_linked","repository_owner_not_caller","request_canceled","request_timeout","request_too_large","save_in_progress","save_requires_task_creator","service_unavailable","slash_command","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","stream_delivery_gap","stream_event_conflict","task_already_saved","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_bound_at_creation","task_branch_diverged","task_branch_is_default","task_branch_mismatch","task_branch_missing","task_connection_disconnected","task_creator_deleted","task_executing","task_file_too_large","task_fork_refused","task_has_no_commits","task_has_no_files","task_has_no_repository","task_history_has_merges","task_ineligible","task_is_child","task_not_accepting_messages","task_not_pinnable","task_not_started","task_rebase_in_progress","task_settings_changed","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_run_running","terminal_question","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","validation_failed","working_tree_dirty","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected"],"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"},"7f368b32-b566-4664-92b6-0d4c05ee7169":{"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","app_identity_missing","attribution_unavailable","bad_gateway","bad_request","caller_inactive","chat_archived","computer_connection_stale","computer_starts_no_agents","computer_starts_no_forks","computer_unreachable","conflict","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","creator_github_access_missing","embeddings_unavailable","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","gateway_timeout","github_claim_unverified","github_failed","github_identity_mismatch","github_identity_required","github_push_access_required","github_reconnect_required","github_ref_not_found","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","internal_error","invalid_request","last_queued_message","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","method_not_allowed","mode_forbidden","no_checkout_on_computer","no_dispatch_target","no_turn_running","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","org_id_required","org_role_insufficient","org_suspended","payment_required","permission_prompt_answered_in_terminal","permission_prompt_expired","permission_prompt_open","permission_prompt_stopped","pr_review_actor_required","pr_review_publish_forbidden","precondition_failed","project_archived","project_has_no_repository","project_repo_disconnected","project_repository_differs","project_required","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_file_too_large","push_rejected","push_secret_detected","question_answers","queued_stop_requires_discard","rate_limited","repository_administration_not_granted","repository_already_connected","repository_create_forbidden","repository_create_rejected","repository_created_not_linked","repository_owner_not_caller","request_canceled","request_timeout","request_too_large","save_in_progress","save_requires_task_creator","service_unavailable","slash_command","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","stream_delivery_gap","stream_event_conflict","task_already_saved","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_bound_at_creation","task_branch_diverged","task_branch_is_default","task_branch_mismatch","task_branch_missing","task_connection_disconnected","task_creator_deleted","task_executing","task_file_too_large","task_fork_refused","task_has_no_commits","task_has_no_files","task_has_no_repository","task_history_has_merges","task_ineligible","task_is_child","task_not_accepting_messages","task_not_pinnable","task_not_started","task_rebase_in_progress","task_settings_changed","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_run_running","terminal_question","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","validation_failed","working_tree_dirty","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected"],"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"},"f5c779dd-16ce-4a84-94f9-9f36d1c6eee5":{"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","app_identity_missing","attribution_unavailable","bad_gateway","bad_request","caller_inactive","chat_archived","computer_connection_stale","computer_starts_no_agents","computer_starts_no_forks","computer_unreachable","conflict","connection_harness_mismatch","connection_not_held","contents_write_required","continuation_failed","continuation_unavailable","control_forbidden","creator_github_access_missing","embeddings_unavailable","fix_not_requested","fix_requests_unrecorded","forbidden","fork_branch_delete_unsupported","fork_forbidden","gateway_timeout","github_claim_unverified","github_failed","github_identity_mismatch","github_identity_required","github_push_access_required","github_reconnect_required","github_ref_not_found","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","internal_error","invalid_request","last_queued_message","main_chat_permanent","mcp_server_not_connected","merge_when_ready_requires_pr_review","message_not_queued","method_not_allowed","mode_forbidden","no_checkout_on_computer","no_dispatch_target","no_turn_running","not_acceptable","not_found","not_implemented","onboarding_already_completed","onboarding_requirements_missing","org_id_required","org_role_insufficient","org_suspended","payment_required","permission_prompt_answered_in_terminal","permission_prompt_expired","permission_prompt_open","permission_prompt_stopped","pr_review_actor_required","pr_review_publish_forbidden","precondition_failed","project_archived","project_has_no_repository","project_repo_disconnected","project_repository_differs","project_required","pull_request_closed","pull_request_mirror_failed","pull_request_not_mirrored","push_file_too_large","push_rejected","push_secret_detected","question_answers","queued_stop_requires_discard","rate_limited","repository_administration_not_granted","repository_already_connected","repository_create_forbidden","repository_create_rejected","repository_created_not_linked","repository_owner_not_caller","request_canceled","request_timeout","request_too_large","save_in_progress","save_requires_task_creator","service_unavailable","slash_command","stack_cycle","stack_too_large","stack_two_parents","stale_execution","stale_or_indeterminate","stale_pending_input","stream_delivery_gap","stream_event_conflict","task_already_saved","task_awaiting_message","task_awaiting_tool_response","task_backed_by_work_tree","task_bound_at_creation","task_branch_diverged","task_branch_is_default","task_branch_mismatch","task_branch_missing","task_connection_disconnected","task_creator_deleted","task_executing","task_file_too_large","task_fork_refused","task_has_no_commits","task_has_no_files","task_has_no_repository","task_history_has_merges","task_ineligible","task_is_child","task_not_accepting_messages","task_not_pinnable","task_not_started","task_rebase_in_progress","task_settings_changed","teleport_unavailable","terminal_chat","terminal_chat_continuation_refused","terminal_chat_run_running","terminal_question","unauthenticated","unsigned_aether_head","unsigned_commit","unsupported_changes","unsupported_media_type","untyped_error","validation_failed","working_tree_dirty","workspace_git_unavailable","workspace_gone","workspace_outdated","workspace_rejected"],"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":"Service Unavailable","exampleType":"generated"}},"security":{"9afdaa3a-ab5d-440b-98ad-31a38432c246":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"66ab535b-c4ec-41e3-98da-d80687cb1fb1":{"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":"Get a task's plan - Aether","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T13:40:00.085Z","originalFileLocation":"api-reference/endpoints/tasks/get-tasks-by-taskid-plan.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=\"Reads the task\u0026#x27;s whole current plan: its steps, each with its work and checks, and the earlier steps it replaced. Use this tool when you need to: - See every step of a task\u0026#x27;s plan, which one is in progress and what is left - Find the checks run and the tool calls or cloud agents spawned while a step was worked Examples: - GET /tasks/{taskID}/plan - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan Hints: - taskID is the task\u0026#x27;s lowercase uuid; there are no other parameters. - steps are in the agent\u0026#x27;s order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan. - earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds. - The task\u0026#x27;s plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found. - Use getTask instead for the plan\u0026#x27;s counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names. - Any member of the task\u0026#x27;s organization may read it, a viewer included, and an agent host\u0026#x27;s grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller\u0026#x27;s reach is 404 not_found; 503 when the membership check is unavailable.\">\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=\"Get a task\u0026#x27;s plan - Aether\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reads the task\u0026#x27;s whole current plan: its steps, each with its work and checks, and the earlier steps it replaced. Use this tool when you need to: - See every step of a task\u0026#x27;s plan, which one is in progress and what is left - Find the checks run and the tool calls or cloud agents spawned while a step was worked Examples: - GET /tasks/{taskID}/plan - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan Hints: - taskID is the task\u0026#x27;s lowercase uuid; there are no other parameters. - steps are in the agent\u0026#x27;s order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan. - earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds. - The task\u0026#x27;s plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found. - Use getTask instead for the plan\u0026#x27;s counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names. - Any member of the task\u0026#x27;s organization may read it, a viewer included, and an agent host\u0026#x27;s grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller\u0026#x27;s reach is 404 not_found; 503 when the membership check is unavailable.\">\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/tasks/get-tasks-by-taskid-plan\">\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=Tasks\u0026amp;title=Get+a+task%27s+plan\u0026amp;description=Reads+the+task%27s+whole+current+plan%3A+its+steps%2C+each+with+its+work+and+checks%2C+and+the+earlier+steps+it+replaced.%0A%0AUse+this+tool+when+you+need+to%3A%0A-+See+every+s\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=7a6d8de550536c43c73875f723e60343779aa04dc52df246c27cc5783c0c779c\">\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=\"Get a task\u0026#x27;s plan - Aether\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reads the task\u0026#x27;s whole current plan: its steps, each with its work and checks, and the earlier steps it replaced. Use this tool when you need to: - See every step of a task\u0026#x27;s plan, which one is in progress and what is left - Find the checks run and the tool calls or cloud agents spawned while a step was worked Examples: - GET /tasks/{taskID}/plan - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan Hints: - taskID is the task\u0026#x27;s lowercase uuid; there are no other parameters. - steps are in the agent\u0026#x27;s order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan. - earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds. - The task\u0026#x27;s plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found. - Use getTask instead for the plan\u0026#x27;s counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names. - Any member of the task\u0026#x27;s organization may read it, a viewer included, and an agent host\u0026#x27;s grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller\u0026#x27;s reach is 404 not_found; 503 when the membership check is unavailable.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aether-c4587800.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Get+a+task%27s+plan\u0026amp;description=Reads+the+task%27s+whole+current+plan%3A+its+steps%2C+each+with+its+work+and+checks%2C+and+the+earlier+steps+it+replaced.%0A%0AUse+this+tool+when+you+need+to%3A%0A-+See+every+s\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=7a6d8de550536c43c73875f723e60343779aa04dc52df246c27cc5783c0c779c\">\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/tasks/get-tasks-by-taskid-plan\">\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/tasks/get-tasks-by-taskid-plan.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/tasks/get-tasks-by-taskid-plan#webpage\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan\",\"name\":\"Get a task's plan\",\"description\":\"Reads the task's whole current plan: its steps, each with its work and checks, and the earlier steps it replaced. Use this tool when you need to: - See every step of a task's plan, which one is in progress and what is left - Find the checks run and the tool calls or cloud agents spawned while a step was worked Examples: - GET /tasks/{taskID}/plan - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan Hints: - taskID is the task's lowercase uuid; there are no other parameters. - steps are in the agent's order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan. - earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds. - The task's plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found. - Use getTask instead for the plan's counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names. - Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.\",\"dateModified\":\"2026-10-29T13:40:00.085Z\",\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tasks\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-orgs-by-orgid-tasks\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a task's plan\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan#apireference\",\"headline\":\"Get a task's plan\",\"name\":\"Get a task's plan\",\"description\":\"Reads the task's whole current plan: its steps, each with its work and checks, and the earlier steps it replaced. Use this tool when you need to: - See every step of a task's plan, which one is in progress and what is left - Find the checks run and the tool calls or cloud agents spawned while a step was worked Examples: - GET /tasks/{taskID}/plan - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/plan Hints: - taskID is the task's lowercase uuid; there are no other parameters. - steps are in the agent's order, each with content, status (pending, in_progress or completed), active_form when the agent gave one, checks (each kind with its latest outcome, passed or failed) and work (the ledger_tool_call_ids and cloud_agent_task_ids spawned while it was worked); completed, total, current_step, explanation and updated_at summarize the plan. - earlier_steps are the steps that left the plan, reworded or dropped, with work of their own, in the order they were started; unclaimed_work is the work no step holds. - The task's plan_progress (getTask) says whether it has one; a task with no plan is 404 not_found. - Use getTask instead for the plan's counts alone, and listTaskSubagents for the sub-agents and tool runs a ledger_tool_call_ids entry names. - Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/tasks/get-tasks-by-taskid-plan#webpage\"},\"dateModified\":\"2026-10-29T13:40:00.085Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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":"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":"Connect to a workspace","openapi":"api-reference/openapi.json POST /workspaces/{workspaceID}/connect","href":"/api-reference/endpoints/workspaces/post-workspaces-by-workspaceid-connect"},{"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","description":"Answers the task a task's main chat was forked from, if any, and every task forked from it.\n\nUse this tool when you need to:\n- Follow a forked task back to the conversation it started from\n- List the forks a task's conversation has, to compare the approaches they took\n\nExamples:\n- GET /tasks/{taskID}/lineage\n- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/lineage\n\nHints:\n- taskID is the task's lowercase uuid; there are no other parameters and forks is not paged.\n- forked_from is the task whose main chat this task's main chat was forked from, null for a task that is no fork or whose source was deleted. forks is every task whose main chat was forked from this task's main chat, newest first. Each is the Task object listTasks and getTask return, archived ones included.\n- Use forkTask to fork a task, and getTaskTree instead for the cloud agents a task spawned.\n- Any member of the task's organization may read it, a viewer included; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, an agent host's grant with 403 agent_host_route_not_allowed, and a task the caller cannot see is 404; 503 when the membership check is unavailable.","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","description":"Reads how the task runs: the MCP servers its harness is given and why it lacks the others its repository declares, the slash commands its harness reported, its agent segments and runtime intervals, its workspace's latest warning and its turn-end hold.\n\nUse this tool when you need to:\n- Check which MCP servers a task's agent can call, and why a server its repository declares is missing\n- List the slash commands a task's harness offers\n- See when a task's agent and workspace ran and what the workspace last warned about\n\nExamples:\n- GET /tasks/{taskID}/runtime\n- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/runtime\n\nHints:\n- taskID is the task's lowercase uuid; there are no other parameters.\n- mcp_servers are the project's catalog servers, then the repository's, each by key; repo_mcp_server_notes say why each other server the repository declares is not given, and repo_mcp_server_skips are the declarations Aether cannot use. The repository's declarations come from the commit the task pinned at creation; which it can use, and the catalog servers, are read as the project stands now.\n- agent_segments are the agent's runs, each with what it ran on, its start, end, tokens and end reason; runtime_intervals are the stretches a machine ran the task's workspace, with its hardware and end reason.\n- slash_commands is what the harness last reported, absent until it reports; latest_workspace_warning is absent when the workspace raised none; idle_turn_hold_until, absent when no hold applies, is when the turn-end hold that keeps the workspace running ends.\n- Use getTask instead for the task's status and settings, and getTaskRuntimeUsage for what its metered runs have used and cost.\n- Any member of the task's organization may read it, a viewer included, and an agent host's grant is admitted; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.\n- A task backed by a work tree, which lives on its creator's computer and has no VM, is refused with 409 task_backed_by_work_tree.","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 a checkout's terminal chats","openapi":"api-reference/openapi.json GET /tasks/{taskID}/terminal-chats","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-terminal-chats"},{"title":"Stop a terminal chat's turn at its next tool call","openapi":"api-reference/openapi.json POST /tasks/{taskID}/terminal-chats/{chatID}/stop","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-terminal-chats-by-chatid-stop"},{"title":"Archive or restore a terminal chat","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}/terminal-chats/{chatID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid-terminal-chats-by-chatid"},{"title":"Answer a terminal chat's permission prompt","openapi":"api-reference/openapi.json POST /tasks/{taskID}/terminal-chats/{chatID}/answer","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-terminal-chats-by-chatid-answer"},{"title":"Continue a terminal chat in the cloud","openapi":"api-reference/openapi.json POST /tasks/{taskID}/terminal-chats/{chatID}/continue-in-cloud","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-terminal-chats-by-chatid-continue-in-cloud"},{"title":"Continue a terminal chat on one of your computers","openapi":"api-reference/openapi.json POST /tasks/{taskID}/terminal-chats/{chatID}/continue-on-computer","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-terminal-chats-by-chatid-continue-on-computer"},{"title":"Remove a terminal chat from Aether","openapi":"api-reference/openapi.json DELETE /tasks/{taskID}/terminal-chats/{chatID}","href":"/api-reference/endpoints/tasks/delete-tasks-by-taskid-terminal-chats-by-chatid"},{"title":"Send a terminal chat a message","openapi":"api-reference/openapi.json POST /tasks/{taskID}/terminal-chats/{chatID}/messages","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-terminal-chats-by-chatid-messages"},{"title":"Read a message sent to a terminal chat","openapi":"api-reference/openapi.json GET /tasks/{taskID}/terminal-chats/{chatID}/messages/{messageID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-terminal-chats-by-chatid-messages-by-messageid"},{"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 inside its task's workspace","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":"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":"Archive or restore 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":"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":"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":"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":"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":"Fork a task's chat to one of your computers","openapi":"api-reference/openapi.json POST /tasks/{taskID}/fork-to-computer","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-fork-to-computer"},{"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"},{"title":"Start a task on one of your computers","openapi":"api-reference/openapi.json POST /orgs/{orgID}/tasks/on-computer","href":"/api-reference/endpoints/tasks/post-orgs-by-orgid-tasks-on-computer"}]},{"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":"MCP Servers","pages":[{"title":"List the organization's MCP servers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-servers"},{"title":"Probe how a remote MCP server authenticates","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers/probe","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers-probe"},{"title":"Add an MCP server to the organization's catalog","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers"},{"title":"Update an MCP server","openapi":"api-reference/openapi.json PATCH /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/patch-mcp-servers-by-mcpserverid"},{"title":"Delete an MCP server","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid"},{"title":"Preview updating a directory server from its entry","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update-preview","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update-preview"},{"title":"Update a directory server to the revision its preview showed","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update"},{"title":"List the MCP servers a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-servers"},{"title":"Check whether your tasks in a project can start","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-server-readiness","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-server-readiness"},{"title":"Enable an MCP server on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/put-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"Disable an MCP server on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"List your MCP server connections and the organization's","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-server-connections","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-server-connections"},{"title":"Connect an MCP server with your API key","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-connection"},{"title":"Disconnect your MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-connection"},{"title":"Connect an MCP server for the organization","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-org-connection"},{"title":"Disconnect the organization's MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-org-connection"},{"title":"Connect an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-connection-oauth"},{"title":"Connect an MCP server with OAuth for the organization","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/org-connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-org-connection-oauth"},{"title":"Finish connecting an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/oauth/callback","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-oauth-callback"},{"title":"List the organization's OAuth apps","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps"},{"title":"Read the redirect URI an OAuth app registers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps/redirect-uri","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps-redirect-uri"},{"title":"Save the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json PUT /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/put-orgs-by-orgid-mcp-oauth-apps"},{"title":"Delete the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/delete-orgs-by-orgid-mcp-oauth-apps"}]},{"group":"Plugins","pages":[{"title":"List the official plugin marketplaces","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugin-marketplaces","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugin-marketplaces"},{"title":"List the plugins a marketplace offers","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugin-marketplaces/browse","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugin-marketplaces-browse"},{"title":"List the organization's plugins","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugins"},{"title":"Install a plugin in the organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugins"},{"title":"Preview updating a plugin","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update-preview","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update-preview"},{"title":"Update a plugin to the revision its preview showed","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update"},{"title":"Change a plugin's organization-wide defaults","openapi":"api-reference/openapi.json PATCH /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/patch-plugins-by-pluginid"},{"title":"Uninstall a plugin","openapi":"api-reference/openapi.json DELETE /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-plugins-by-pluginid"},{"title":"List the plugins a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/plugins","href":"/api-reference/endpoints/plugins/get-projects-by-projectid-plugins"},{"title":"Enable a plugin on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/put-projects-by-projectid-plugins-by-pluginid"},{"title":"Disable a plugin on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-projects-by-projectid-plugins-by-pluginid"},{"title":"List Aether's integration directory","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-directory","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-directory"},{"title":"Search integrations by name","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search"},{"title":"Search the MCP registry","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search/registry","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search-registry"},{"title":"Install an integration of Aether's integration directory","openapi":"api-reference/openapi.json POST /orgs/{orgID}/integration-directory/{key}/install","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-integration-directory-by-key-install"}]},{"group":"Usage","pages":[{"title":"Get usage summary","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/summary","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-summary"},{"title":"List the tasks that used anything in a range","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/tasks","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-tasks"}]},{"group":"Profile","pages":[{"title":"Get profile","openapi":"api-reference/openapi.json GET /profile","href":"/api-reference/endpoints/profile/get-profile"},{"title":"Delete your account","openapi":"api-reference/openapi.json DELETE /profile","href":"/api-reference/endpoints/profile/delete-profile"},{"title":"Complete onboarding","openapi":"api-reference/openapi.json POST /profile/onboarding/complete","href":"/api-reference/endpoints/profile/post-profile-onboarding-complete"},{"title":"Launch the onboarding task","openapi":"api-reference/openapi.json POST /profile/onboarding/launch","href":"/api-reference/endpoints/profile/post-profile-onboarding-launch"},{"title":"Set up the onboarding repository","openapi":"api-reference/openapi.json POST /profile/onboarding/repo","href":"/api-reference/endpoints/profile/post-profile-onboarding-repo"}]},{"group":"Organizations","pages":[{"title":"List my organizations","openapi":"api-reference/openapi.json GET /orgs","href":"/api-reference/endpoints/orgs/get-orgs"},{"title":"Create a team organization","openapi":"api-reference/openapi.json POST /orgs","href":"/api-reference/endpoints/orgs/post-orgs"},{"title":"Change organization settings","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid"},{"title":"Delete a team organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid"},{"title":"Get an organization's teardown","openapi":"api-reference/openapi.json GET /orgs/{orgID}/teardown","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-teardown"},{"title":"List organization members","openapi":"api-reference/openapi.json GET /orgs/{orgID}/members","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-members"},{"title":"Change an organization member's role","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid-members-by-userid"},{"title":"Remove an organization member","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-by-userid"},{"title":"Leave an organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/me","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-me"},{"title":"Ask the organization's admins for a seat","openapi":"api-reference/openapi.json POST /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-seat-requests"},{"title":"List the organization's seat requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-seat-requests"},{"title":"List the organization's invitations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-invites"},{"title":"Invite a user to an organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites"},{"title":"Revoke an organization invitation","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/invites/{inviteID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-invites-by-inviteid"},{"title":"Resend an organization invitation","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites/{inviteID}/resend","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites-by-inviteid-resend"},{"title":"List my open organization invitations (pending or expired)","openapi":"api-reference/openapi.json GET /invites","href":"/api-reference/endpoints/orgs/get-invites"},{"title":"Accept an organization invitation","openapi":"api-reference/openapi.json POST /invites/{inviteID}/accept","href":"/api-reference/endpoints/orgs/post-invites-by-inviteid-accept"}]},{"group":"User Discovery","pages":[{"title":"Get dismissed discovery keys","openapi":"api-reference/openapi.json GET /user/discovery","href":"/api-reference/endpoints/user-discovery/get-user-discovery"},{"title":"Dismiss a discovery key","openapi":"api-reference/openapi.json PUT /user/discovery/dismissed-keys/{discoveryKey}","href":"/api-reference/endpoints/user-discovery/put-user-discovery-dismissed-keys-by-discoverykey"}]},{"group":"User Flags","pages":[{"title":"Get your feature flags","openapi":"api-reference/openapi.json GET /user/flags","href":"/api-reference/endpoints/user-flags/get-user-flags"}]},{"group":"Pull Requests","pages":[{"title":"List the organization's pull requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests"},{"title":"Count the organization's pull requests per section","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests/sections","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests-sections"},{"title":"Get one pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid"},{"title":"Get one pull request's review","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review"},{"title":"Get one file's content at a reviewed commit of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/file","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-file"},{"title":"Get the snapshot of a pull request head: its changed files against the base tip, their patches and their contents at the head","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/head-snapshot","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-head-snapshot"},{"title":"Retry the capture of a pull request head's snapshot that gave up","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/head-snapshot/capture","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-head-snapshot-capture"},{"title":"Get the whole stack a reviewed pull request belongs to","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/stack","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-stack"},{"title":"Request an Aether review of a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/runs","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-runs"},{"title":"Dispatch pull request feedback to Aether","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/dispatch","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-dispatch"},{"title":"List Aether feedback dispatches for a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/dispatches","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-dispatches"},{"title":"Get a pull request's merge box and checks","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github"},{"title":"Post a top-level comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments"},{"title":"Reply to a review comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/replies","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-replies"},{"title":"Resolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/resolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-resolve"},{"title":"Unresolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/unresolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-unresolve"},{"title":"Get a pull request's changed files with unified-diff patches","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/diff","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-diff"},{"title":"Merge a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/merge","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-merge"},{"title":"Convert a pull request to a draft","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/draft","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-draft"},{"title":"Mark a draft pull request ready for review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/ready","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-ready"},{"title":"Close a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/close","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-close"},{"title":"Reopen a closed pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reopen","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reopen"},{"title":"Request a reviewer on a pull request","openapi":"api-reference/openapi.json PUT /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/put-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Withdraw a reviewer's request on a pull request","openapi":"api-reference/openapi.json DELETE /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/delete-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Submit a human pull request review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reviews","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reviews"},{"title":"List a pull request's review threads","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/threads","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-threads"},{"title":"List a pull request's activity","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/activity","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-activity"},{"title":"List a pull request's recorded verification events","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/verification-events","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-verification-events"},{"title":"Get everything recorded as proof of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-proof"},{"title":"Change who may watch a pull request's proof","openapi":"api-reference/openapi.json PATCH /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/patch-pull-requests-by-pullrequestid-proof"},{"title":"Resolve a pull request by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number"},{"title":"Resolve a pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number-proof"},{"title":"Get a public pull request's proof","openapi":"api-reference/openapi.json GET /public/pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-pull-requests-by-pullrequestid-proof"},{"title":"Resolve where a task's public proof is watched","openapi":"api-reference/openapi.json GET /public/tasks/{taskID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-tasks-by-taskid-proof"},{"title":"Resolve a public pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /public/repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-public-repos-by-owner-by-repo-pulls-by-number-proof"}]},{"group":"Push Tokens","pages":[{"title":"Register an Expo push token for the current user","openapi":"api-reference/openapi.json POST /user/push-tokens","href":"/api-reference/endpoints/push-tokens/post-user-push-tokens"},{"title":"Unregister an Expo push token for the current user","openapi":"api-reference/openapi.json DELETE /user/push-tokens/{pushToken}","href":"/api-reference/endpoints/push-tokens/delete-user-push-tokens-by-pushtoken"}]},{"group":"Computers","pages":[{"title":"List your computers","openapi":"api-reference/openapi.json GET /computers","href":"/api-reference/endpoints/computers/get-computers"},{"title":"Register a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid"},{"title":"Update a computer","openapi":"api-reference/openapi.json PATCH /computers/{computerID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid"},{"title":"Remove a computer","openapi":"api-reference/openapi.json DELETE /computers/{computerID}","href":"/api-reference/endpoints/computers/delete-computers-by-computerid"},{"title":"Find or create the task of a checkout","openapi":"api-reference/openapi.json POST /computers/{computerID}/work-tree-tasks","href":"/api-reference/endpoints/computers/post-computers-by-computerid-work-tree-tasks"},{"title":"List the repositories mirrored from a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/repositories","href":"/api-reference/endpoints/computers/get-computers-by-computerid-repositories"},{"title":"Find or create the chat of a terminal session","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Report a terminal chat's status","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Read what Aether holds of a terminal chat's session file","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Ship a range of a terminal chat's session file","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Read a stop sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report how a stop sent to a computer settled","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report a terminal chat's prompt","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Wait for a terminal chat prompt's answer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Close a terminal chat's prompt","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Read a continuation sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Report a continuation a computer carried out","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Read a message sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-deliveries-by-deliveryid"},{"title":"Report what became of a message sent to a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","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"}]},{"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":"Get a task's plan - Aether","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}