Set the fallback of a harness's default connection
Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default.
Use this tool when you need to:
- Set or change the fallback a task continues on when its plan's window is spent
- Clear the fallback, so a task on a spent plan stops
Examples:
- PATCH /connections/defaults/codex {"fallback": {"mode": "any_usable", "then": {"runs_on": "aether"}}}
- PATCH /connections/defaults/claude-code {"fallback": {"mode": "none"}}
Hints:
- harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written.
- A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too.
- Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults.
- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.
- Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.
PATCH
/
connections
/
defaults
/
{harness}
Set the fallback of a harness's default connection
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
harness
enum<string>
required
The agent harness that runs a task, a profile or a connection: claude-code or claude_code is Claude Code, codex is Codex, opencode is OpenCode.
Available options:
codex,
claude-code,
opencode,
claude_code
Body
application/json
fallback
object
required
What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.
Option 1
Option 2
Option 3
Option 4
Show child attributes
Response
OK
fallback
object
required
What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.
Option 1
Option 2
Option 3
Option 4
Show child attributes
harness
enum<string>
required
The agent harness that runs a task, a profile or a connection: claude-code or claude_code is Claude Code, codex is Codex, opencode is OpenCode.
Available options:
codex,
claude-code,
opencode,
claude_code
runs_on
enum<string>
required
aether, Aether inference, paid from your organization's balance; stored, the connection connection_id names.
Available options:
aether,
stored
connection_id
string<uuid>
The connection a stored default runs on.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Aether","colors":{"primary":"#9184ff","light":"#b3a9ff","dark":"#9184ff"},"logo":{"light":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/logo/light.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=cdf40b8647da8a5d82a91e289a1958f7","dark":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/logo/dark.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=ff1a5d20e563918957a5f0eba367dee4","href":"https://www.runaether.dev"},"favicon":"https://mintcdn.com/aether-c4587800/hrC9bOYLpJ53VNbo/favicon.svg?fit=max\u0026auto=format\u0026n=hrC9bOYLpJ53VNbo\u0026q=85\u0026s=26bfe1ec698456a716b64fb50a5848be","api":{"openapi":"api-reference/openapi.json"},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#f4f3ef","dark":"#08080b"}},"navbar":{"links":[{"href":"https://www.runaether.dev/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Open Aether","href":"https://app.runaether.dev"}},"footer":{"socials":{"x":"https://x.com/pranavctl","github":"https://github.com/Aether-Runtime"}},"fonts":{"family":"Geist"},"styling":{"codeblocks":"dark","latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aether-c4587800","hasAudioNarration":false,"actualSubdomain":"aether-c4587800","customDomains":["docs.runaether.dev"],"gitSource":{"type":"github","owner":"aether-runtime","repo":"aether","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6affc0b8a27afa133802f733","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":339},{"language":"default","tag":"Tasks","count":51},{"language":"default","tag":"CLI Reference","count":42},{"language":"default","tag":"Pull Requests","count":35},{"language":"default","tag":"Guides","count":29},{"language":"default","tag":"Computers","count":29},{"language":"default","tag":"Using Aether","count":25},{"language":"default","tag":"MCP Servers","count":23},{"language":"default","tag":"Concepts","count":22},{"language":"default","tag":"Agent","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{color-scheme:dark}::selection{background:rgba(145, 132, 255, 0.25)}"}]}
{"page":{"pagePath":"api-reference/endpoints/connections/patch-connections-defaults-by-harness","slug":"/api-reference/endpoints/connections/patch-connections-defaults-by-harness","pageMetadata":{"title":"Set the fallback of a harness's default connection","openapi":"api-reference/openapi.json PATCH /connections/defaults/{harness}","description":"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default.\n\nUse this tool when you need to:\n- Set or change the fallback a task continues on when its plan's window is spent\n- Clear the fallback, so a task on a spent plan stops\n\nExamples:\n- PATCH /connections/defaults/codex {\"fallback\": {\"mode\": \"any_usable\", \"then\": {\"runs_on\": \"aether\"}}}\n- PATCH /connections/defaults/claude-code {\"fallback\": {\"mode\": \"none\"}}\n\nHints:\n- harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written.\n- A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too.\n- Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults.\n- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.\n- Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.","href":"/api-reference/endpoints/connections/patch-connections-defaults-by-harness"},"description":"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default.\n\nUse this tool when you need to:\n- Set or change the fallback a task continues on when its plan's window is spent\n- Clear the fallback, so a task on a spent plan stops\n\nExamples:\n- PATCH /connections/defaults/codex {\"fallback\": {\"mode\": \"any_usable\", \"then\": {\"runs_on\": \"aether\"}}}\n- PATCH /connections/defaults/claude-code {\"fallback\": {\"mode\": \"none\"}}\n\nHints:\n- harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written.\n- A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too.\n- Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults.\n- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.\n- Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.","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":"Set the fallback of a harness's default connection","openapi":"api-reference/openapi.json PATCH /connections/defaults/{harness}","description":"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default.\n\nUse this tool when you need to:\n- Set or change the fallback a task continues on when its plan's window is spent\n- Clear the fallback, so a task on a spent plan stops\n\nExamples:\n- PATCH /connections/defaults/codex {\"fallback\": {\"mode\": \"any_usable\", \"then\": {\"runs_on\": \"aether\"}}}\n- PATCH /connections/defaults/claude-code {\"fallback\": {\"mode\": \"none\"}}\n\nHints:\n- harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written.\n- A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too.\n- Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults.\n- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.\n- Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.","href":"/api-reference/endpoints/connections/patch-connections-defaults-by-harness"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default.\n\nUse this tool when you need to:\n- Set or change the fallback a task continues on when its plan's window is spent\n- Clear the fallback, so a task on a spent plan stops\n\nExamples:\n- PATCH /connections/defaults/codex {\"fallback\": {\"mode\": \"any_usable\", \"then\": {\"runs_on\": \"aether\"}}}\n- PATCH /connections/defaults/claude-code {\"fallback\": {\"mode\": \"none\"}}\n\nHints:\n- harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written.\n- A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too.\n- Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults.\n- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.\n- Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.","operationId":"patchDefaultConnection","parameters":["eba4e632-7a2e-4485-96ba-d77c161db0eb"],"requestBody":"f7e534c0-0bf2-446b-b487-ac609688bd35","responses":{"200":"a307d552-c1fc-4b68-a3a2-ffe43cda82f3","400":"e4c8d37d-885e-4f68-a14d-3d86af21359c","401":"3bc42d51-ff5f-40a2-9adc-565dd74f14f6","403":"15f1f6ff-7559-4ea5-846a-ed6ee2ef9fad","404":"940807bc-273a-44b7-a1b4-58fc545f4eff","409":"68442f2e-e04a-49e6-999b-506c207f9da1","410":"6d0963d2-84d4-424a-93eb-35d1aef254bd","422":"64edf22a-a04d-4fd7-9f93-2ad04ed2046e","500":"07455948-1605-413a-abac-c5df93e60575"},"summary":"Set the fallback of a harness's default connection","tags":["connections"],"x-aether-access":{"principal":"user","kinds":["jwt","api_key"],"scope":"write","org":"person"},"x-aether-label":"connections.defaults.patch","x-aether-path-ids":{"harness":"-"},"method":"patch","type":"path","servers":["70ecc424-f8a8-4f75-bfbf-2bb9b4664f43"],"security":["370a0152-9b1d-41e3-ad0c-b4211125a98a"],"path":"/connections/defaults/{harness}","baseUrlOptions":["https://api.runaether.dev"],"title":"Set the fallback of a harness's default connection","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"eba4e632-7a2e-4485-96ba-d77c161db0eb":{"in":"path","name":"harness","required":true,"schema":{"description":"The agent harness that runs a task, a profile or a connection: claude-code or claude_code is Claude Code, codex is Codex, opencode is OpenCode.","enum":["codex","claude-code","opencode","claude_code"],"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"fallback":{"oneOf":[{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.","required":["mode"],"properties":{"mode":{"enum":["none"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.0","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.","required":["mode","runs_on"],"properties":{"mode":{"enum":["named"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.1.mode","typeLabel":"enum\u003cstring>"},"runs_on":{"description":"Aether inference, paid from your organization's balance: Claude Code and Codex only.","enum":["aether"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.1.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.1","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.","required":["mode","runs_on","connection_id"],"properties":{"connection_id":{"description":"A connection you hold that works with the harness.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.2.connection_id","typeLabel":"string\u003cuuid>"},"mode":{"enum":["named"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.2.mode","typeLabel":"enum\u003cstring>"},"runs_on":{"description":"The connection connection_id names.","enum":["stored"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.2.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.2","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.","required":["mode"],"properties":{"mode":{"enum":["any_usable"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.mode","typeLabel":"enum\u003cstring>"},"then":{"oneOf":[{"type":"object","required":["runs_on"],"properties":{"runs_on":{"description":"Aether inference, paid from your organization's balance: Claude Code and Codex only.","enum":["aether"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.then.oneOf.0.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"fallback.oneOf.3.then.oneOf.0","typeLabel":"object"},{"type":"object","required":["runs_on","connection_id"],"properties":{"connection_id":{"description":"A connection you hold that works with the harness.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.then.oneOf.1.connection_id","typeLabel":"string\u003cuuid>"},"runs_on":{"description":"The connection connection_id names.","enum":["stored"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.then.oneOf.1.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"fallback.oneOf.3.then.oneOf.1","typeLabel":"object"}],"uniqueKey":"fallback.oneOf.3.then","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"fallback","typeLabel":"object"}},"required":["fallback"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fallback":{"mode":"none"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a307d552-c1fc-4b68-a3a2-ffe43cda82f3":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"fallback":{"oneOf":[{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.","required":["mode"],"properties":{"mode":{"enum":["none"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.0","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.","required":["mode","runs_on"],"properties":{"mode":{"enum":["named"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.1.mode","typeLabel":"enum\u003cstring>"},"runs_on":{"description":"Aether inference, paid from your organization's balance: Claude Code and Codex only.","enum":["aether"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.1.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.1","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.","required":["mode","runs_on"],"properties":{"mode":{"enum":["named"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.2.mode","typeLabel":"enum\u003cstring>"},"runs_on":{"description":"The connection connection_id names.","enum":["stored"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.2.runs_on","typeLabel":"enum\u003cstring>"},"connection_id":{"description":"A connection you hold that works with the harness.","format":"uuid","type":"string","uniqueKey":"fallback.oneOf.2.connection_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.2","typeLabel":"object"},{"type":"object","description":"What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.","required":["mode"],"properties":{"mode":{"enum":["any_usable"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.mode","typeLabel":"enum\u003cstring>"},"then":{"oneOf":[{"type":"object","required":["runs_on"],"properties":{"runs_on":{"description":"Aether inference, paid from your organization's balance: Claude Code and Codex only.","enum":["aether"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.then.oneOf.0.runs_on","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"fallback.oneOf.3.then.oneOf.0","typeLabel":"object"},{"type":"object","required":["runs_on"],"properties":{"runs_on":{"description":"The connection connection_id names.","enum":["stored"],"type":"string","isRequired":true,"uniqueKey":"fallback.oneOf.3.then.oneOf.1.runs_on","typeLabel":"enum\u003cstring>"},"connection_id":{"description":"A connection you hold that works with the harness.","format":"uuid","type":"string","uniqueKey":"fallback.oneOf.3.then.oneOf.1.connection_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"uniqueKey":"fallback.oneOf.3.then.oneOf.1","typeLabel":"object"}],"uniqueKey":"fallback.oneOf.3.then","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"fallback.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"fallback","typeLabel":"object"},"harness":{"description":"The agent harness that runs a task, a profile or a connection: claude-code or claude_code is Claude Code, codex is Codex, opencode is OpenCode.","enum":["codex","claude-code","opencode","claude_code"],"type":"string","isRequired":true,"uniqueKey":"harness","typeLabel":"enum\u003cstring>"},"runs_on":{"description":"aether, Aether inference, paid from your organization's balance; stored, the connection connection_id names.","enum":["aether","stored"],"type":"string","isRequired":true,"uniqueKey":"runs_on","typeLabel":"enum\u003cstring>"},"connection_id":{"description":"The connection a stored default runs on.","format":"uuid","type":"string","uniqueKey":"connection_id","typeLabel":"string\u003cuuid>"}},"required":["harness","runs_on","fallback"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fallback":{"mode":"none"},"harness":"codex","runs_on":"aether","connection_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"e4c8d37d-885e-4f68-a14d-3d86af21359c":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"3bc42d51-ff5f-40a2-9adc-565dd74f14f6":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"15f1f6ff-7559-4ea5-846a-ed6ee2ef9fad":{"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"},"940807bc-273a-44b7-a1b4-58fc545f4eff":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"},"68442f2e-e04a-49e6-999b-506c207f9da1":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Conflict","exampleType":"generated"},"6d0963d2-84d4-424a-93eb-35d1aef254bd":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Gone","exampleType":"generated"},"64edf22a-a04d-4fd7-9f93-2ad04ed2046e":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"},"07455948-1605-413a-abac-c5df93e60575":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"code":{"enum":["aether_inference_unavailable","aether_inference_unserved","agent_credential_unreadable","agent_host_account_deleting","agent_host_command_not_found","agent_host_creation_disabled","agent_host_exists","agent_host_illegal_transition","agent_host_not_allowlisted","agent_host_not_found","agent_host_other_provider_app","agent_host_project_not_eligible","agent_host_provisioning_failed","agent_host_state_changed","agent_host_wake_failed","agent_line_unavailable","bad_gateway","bad_request","cli_upgrade_required","client_outdated","conflict","connection_account_held","connection_agent_only","connection_harness_mismatch","connection_is_default","connection_name_taken","connection_not_found","connection_option_mismatch","connection_runs_agent","connection_runs_profiles","device_auth_not_found","fallback_is_own_connection","forbidden","gateway_timeout","gone","internal_error","line_exists","line_not_found","line_not_imessage","method_not_allowed","no_default_connection","not_acceptable","not_found","not_implemented","payment_required","precondition_failed","rate_limited","request_canceled","request_timeout","request_too_large","service_unavailable","unauthenticated","unsupported_media_type","validation_failed","whatsapp_not_enabled"],"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":"aether_inference_unavailable","error":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"370a0152-9b1d-41e3-ad0c-b4211125a98a":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"70ecc424-f8a8-4f75-bfbf-2bb9b4664f43":{"url":"https://api.runaether.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"aether-c4587800","siteName":"Aether","title":"Set the fallback of a harness's default connection - Aether","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T18:21:45.462Z","originalFileLocation":"api-reference/endpoints/connections/patch-connections-defaults-by-harness.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=\"Writes the fallback a task on one of the caller\u0026#x27;s plans for a harness continues on when the plan\u0026#x27;s window is spent, and keeps the harness\u0026#x27;s default. Use this tool when you need to: - Set or change the fallback a task continues on when its plan\u0026#x27;s window is spent - Clear the fallback, so a task on a spent plan stops Examples: - PATCH /connections/defaults/codex {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;any_usable\u0026quot;, \u0026quot;then\u0026quot;: {\u0026quot;runs_on\u0026quot;: \u0026quot;aether\u0026quot;}}} - PATCH /connections/defaults/claude-code {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;none\u0026quot;}} Hints: - harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller\u0026#x27;s held connections of this harness that no limit blocks for the task\u0026#x27;s model, then its optional named then hop. Returns the harness\u0026#x27;s default with the fallback as written. - A task born on a profile that pins a plan follows that profile\u0026#x27;s fallback, none included, while it fails on the profile\u0026#x27;s pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile\u0026#x27;s fallback); moved off that path, it reads this one. The fallback is read when a plan\u0026#x27;s window is spent, so the change reaches the caller\u0026#x27;s existing tasks on a plan too. - Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults. - Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host\u0026#x27;s grant with 403 agent_host_route_not_allowed. - Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default\u0026#x27;s own connection.\">\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=\"Set the fallback of a harness\u0026#x27;s default connection - Aether\">\u003cmeta data-mint-head property=\"og:description\" content=\"Writes the fallback a task on one of the caller\u0026#x27;s plans for a harness continues on when the plan\u0026#x27;s window is spent, and keeps the harness\u0026#x27;s default. Use this tool when you need to: - Set or change the fallback a task continues on when its plan\u0026#x27;s window is spent - Clear the fallback, so a task on a spent plan stops Examples: - PATCH /connections/defaults/codex {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;any_usable\u0026quot;, \u0026quot;then\u0026quot;: {\u0026quot;runs_on\u0026quot;: \u0026quot;aether\u0026quot;}}} - PATCH /connections/defaults/claude-code {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;none\u0026quot;}} Hints: - harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller\u0026#x27;s held connections of this harness that no limit blocks for the task\u0026#x27;s model, then its optional named then hop. Returns the harness\u0026#x27;s default with the fallback as written. - A task born on a profile that pins a plan follows that profile\u0026#x27;s fallback, none included, while it fails on the profile\u0026#x27;s pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile\u0026#x27;s fallback); moved off that path, it reads this one. The fallback is read when a plan\u0026#x27;s window is spent, so the change reaches the caller\u0026#x27;s existing tasks on a plan too. - Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults. - Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host\u0026#x27;s grant with 403 agent_host_route_not_allowed. - Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default\u0026#x27;s own connection.\">\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/connections/patch-connections-defaults-by-harness\">\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=Connections\u0026amp;title=Set+the+fallback+of+a+harness%27s+default+connection\u0026amp;description=Writes+the+fallback+a+task+on+one+of+the+caller%27s+plans+for+a+harness+continues+on+when+the+plan%27s+window+is+spent%2C+and+keeps+the+harness%27s+default.%0A%0AUse+this+t\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=95cd5146d9debcd378b942cb0c5e59f9b43f8b7aff7477d2a856a96621ac8948\">\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=\"Set the fallback of a harness\u0026#x27;s default connection - Aether\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Writes the fallback a task on one of the caller\u0026#x27;s plans for a harness continues on when the plan\u0026#x27;s window is spent, and keeps the harness\u0026#x27;s default. Use this tool when you need to: - Set or change the fallback a task continues on when its plan\u0026#x27;s window is spent - Clear the fallback, so a task on a spent plan stops Examples: - PATCH /connections/defaults/codex {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;any_usable\u0026quot;, \u0026quot;then\u0026quot;: {\u0026quot;runs_on\u0026quot;: \u0026quot;aether\u0026quot;}}} - PATCH /connections/defaults/claude-code {\u0026quot;fallback\u0026quot;: {\u0026quot;mode\u0026quot;: \u0026quot;none\u0026quot;}} Hints: - harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller\u0026#x27;s held connections of this harness that no limit blocks for the task\u0026#x27;s model, then its optional named then hop. Returns the harness\u0026#x27;s default with the fallback as written. - A task born on a profile that pins a plan follows that profile\u0026#x27;s fallback, none included, while it fails on the profile\u0026#x27;s pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile\u0026#x27;s fallback); moved off that path, it reads this one. The fallback is read when a plan\u0026#x27;s window is spent, so the change reaches the caller\u0026#x27;s existing tasks on a plan too. - Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults. - Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host\u0026#x27;s grant with 403 agent_host_route_not_allowed. - Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default\u0026#x27;s own connection.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aether-c4587800.mintlify.site/_mintlify/api/og/v2?division=Connections\u0026amp;title=Set+the+fallback+of+a+harness%27s+default+connection\u0026amp;description=Writes+the+fallback+a+task+on+one+of+the+caller%27s+plans+for+a+harness+continues+on+when+the+plan%27s+window+is+spent%2C+and+keeps+the+harness%27s+default.%0A%0AUse+this+t\u0026amp;theme=4d7da90d8d97040f7873a8b8\u0026amp;signature=95cd5146d9debcd378b942cb0c5e59f9b43f8b7aff7477d2a856a96621ac8948\">\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/connections/patch-connections-defaults-by-harness\">\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/connections/patch-connections-defaults-by-harness.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/connections/patch-connections-defaults-by-harness#webpage\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness\",\"name\":\"Set the fallback of a harness's default connection\",\"description\":\"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default. Use this tool when you need to: - Set or change the fallback a task continues on when its plan's window is spent - Clear the fallback, so a task on a spent plan stops Examples: - PATCH /connections/defaults/codex {\\\"fallback\\\": {\\\"mode\\\": \\\"any_usable\\\", \\\"then\\\": {\\\"runs_on\\\": \\\"aether\\\"}}} - PATCH /connections/defaults/claude-code {\\\"fallback\\\": {\\\"mode\\\": \\\"none\\\"}} Hints: - harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written. - A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too. - Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults. - Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed. - Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.\",\"dateModified\":\"2026-11-08T18:21:45.462Z\",\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connections\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/connections/get-connections\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set the fallback of a harness's default connection\",\"item\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness#apireference\",\"headline\":\"Set the fallback of a harness's default connection\",\"name\":\"Set the fallback of a harness's default connection\",\"description\":\"Writes the fallback a task on one of the caller's plans for a harness continues on when the plan's window is spent, and keeps the harness's default. Use this tool when you need to: - Set or change the fallback a task continues on when its plan's window is spent - Clear the fallback, so a task on a spent plan stops Examples: - PATCH /connections/defaults/codex {\\\"fallback\\\": {\\\"mode\\\": \\\"any_usable\\\", \\\"then\\\": {\\\"runs_on\\\": \\\"aether\\\"}}} - PATCH /connections/defaults/claude-code {\\\"fallback\\\": {\\\"mode\\\": \\\"none\\\"}} Hints: - harness is claude-code, codex or opencode (the schema answers 422 for any other). fallback is required: mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. Returns the harness's default with the fallback as written. - A task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one there (patchAgentProfile sets a profile's fallback); moved off that path, it reads this one. The fallback is read when a plan's window is spent, so the change reaches the caller's existing tasks on a plan too. - Use setDefaultConnection instead to choose the default itself, with or without its fallback, and listConnectionDefaults to read the current defaults. - Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed. - Refused with 409 no_default_connection on a harness without a default, and for the named hop as setDefaultConnection refuses a default: 409 aether_inference_unserved, 409 aether_inference_unavailable, 404 connection_not_found, 409 connection_harness_mismatch, 409 connection_agent_only (or 500 where its stored row does not read), and 409 fallback_is_own_connection for a fallback naming the default's own connection.\",\"url\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runaether.dev/api-reference/endpoints/connections/patch-connections-defaults-by-harness#webpage\"},\"dateModified\":\"2026-11-08T18:21:45.462Z\",\"publisher\":{\"@id\":\"https://docs.runaether.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.runaether.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aether\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Aether\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoints/connections/patch-connections-defaults-by-harness.md","siteName":"Aether","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Release Notes","href":"/api-reference/release-notes"}]},{"group":"Projects","pages":[{"title":"List projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/projects","href":"/api-reference/endpoints/projects/get-orgs-by-orgid-projects"},{"title":"Create project","openapi":"api-reference/openapi.json POST /orgs/{orgID}/projects","href":"/api-reference/endpoints/projects/post-orgs-by-orgid-projects"},{"title":"Get project","openapi":"api-reference/openapi.json GET /projects/{projectID}","href":"/api-reference/endpoints/projects/get-projects-by-projectid"},{"title":"Get project runtime options","openapi":"api-reference/openapi.json GET /projects/{projectID}/runtime-options","href":"/api-reference/endpoints/projects/get-projects-by-projectid-runtime-options"},{"title":"List the ways a task of a project can start","openapi":"api-reference/openapi.json GET /projects/{projectID}/start-options","href":"/api-reference/endpoints/projects/get-projects-by-projectid-start-options"},{"title":"Get project seed failure","openapi":"api-reference/openapi.json GET /projects/{projectID}/seed-failure","href":"/api-reference/endpoints/projects/get-projects-by-projectid-seed-failure"},{"title":"Update project","openapi":"api-reference/openapi.json PATCH /projects/{projectID}","href":"/api-reference/endpoints/projects/patch-projects-by-projectid"}]},{"group":"Workspaces","pages":[{"title":"List workspaces for a project","openapi":"api-reference/openapi.json GET /projects/{projectID}/workspaces","href":"/api-reference/endpoints/workspaces/get-projects-by-projectid-workspaces"},{"title":"List workspaces across all projects","openapi":"api-reference/openapi.json GET /orgs/{orgID}/workspaces","href":"/api-reference/endpoints/workspaces/get-orgs-by-orgid-workspaces"},{"title":"Get a workspace","openapi":"api-reference/openapi.json GET /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/get-workspaces-by-workspaceid"},{"title":"Get a workspace's disk hydration","openapi":"api-reference/openapi.json GET /workspaces/{workspaceID}/hydration","href":"/api-reference/endpoints/workspaces/get-workspaces-by-workspaceid-hydration"},{"title":"Update workspace settings","openapi":"api-reference/openapi.json PATCH /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/patch-workspaces-by-workspaceid"},{"title":"Delete a workspace","openapi":"api-reference/openapi.json DELETE /workspaces/{workspaceID}","href":"/api-reference/endpoints/workspaces/delete-workspaces-by-workspaceid"},{"title":"Create an authenticated preview","openapi":"api-reference/openapi.json POST /workspaces/{workspaceID}/preview-auth","href":"/api-reference/endpoints/workspaces/post-workspaces-by-workspaceid-preview-auth"},{"title":"Stop a workspace","openapi":"api-reference/openapi.json POST /workspaces/{workspaceID}/stop","href":"/api-reference/endpoints/workspaces/post-workspaces-by-workspaceid-stop"}]},{"group":"Tasks","pages":[{"title":"List tasks","openapi":"api-reference/openapi.json GET /orgs/{orgID}/tasks","href":"/api-reference/endpoints/tasks/get-orgs-by-orgid-tasks"},{"title":"Search conversations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/tasks/search","href":"/api-reference/endpoints/tasks/get-orgs-by-orgid-tasks-search"},{"title":"Create a task","openapi":"api-reference/openapi.json POST /orgs/{orgID}/tasks","href":"/api-reference/endpoints/tasks/post-orgs-by-orgid-tasks"},{"title":"Save a task to GitHub","openapi":"api-reference/openapi.json POST /tasks/{taskID}/repository","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-repository"},{"title":"Download a task's work as a zip","openapi":"api-reference/openapi.json GET /tasks/{taskID}/download","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-download"},{"title":"Get a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid"},{"title":"Get the tree containing a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/tree","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-tree"},{"title":"Get what a task was forked from and what was forked from it","openapi":"api-reference/openapi.json GET /tasks/{taskID}/lineage","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-lineage"},{"title":"Get a task's plan","openapi":"api-reference/openapi.json GET /tasks/{taskID}/plan","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-plan"},{"title":"Get how a task runs","openapi":"api-reference/openapi.json GET /tasks/{taskID}/runtime","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-runtime"},{"title":"List a task's activity","openapi":"api-reference/openapi.json GET /tasks/{taskID}/activity","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-activity"},{"title":"List media captured for a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/media","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-media"},{"title":"Hide a capture from the proof page and the Verify panel, or return it to them","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}/media/{mediaID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid-media-by-mediaid"},{"title":"Get one HTML render of a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/html-renders/{renderID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-html-renders-by-renderid"},{"title":"List the cloud devices a task is currently holding","openapi":"api-reference/openapi.json GET /tasks/{taskID}/device-sessions","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-device-sessions"},{"title":"List the provider-native subagents a task owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/subagents","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-subagents"},{"title":"Read one subagent's transcript","openapi":"api-reference/openapi.json GET /tasks/{taskID}/subagents/{toolCallID}/events","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-subagents-by-toolcallid-events"},{"title":"Get the content of one referenced conversation attachment","openapi":"api-reference/openapi.json GET /tasks/{taskID}/messages/{messageID}/attachments/{index}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-messages-by-messageid-attachments-by-index"},{"title":"Get the image one of a task's screen captures returned","openapi":"api-reference/openapi.json GET /tasks/{taskID}/captures/{toolCallID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-captures-by-toolcallid"},{"title":"Change a task","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid"},{"title":"Read accepted open messages and their canonical replacements","openapi":"api-reference/openapi.json GET /tasks/{taskID}/conversation/live","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-conversation-live"},{"title":"Read one task's model spend by what paid for it","openapi":"api-reference/openapi.json GET /tasks/{taskID}/spend","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-spend"},{"title":"Read what one task's metered runs have used so far","openapi":"api-reference/openapi.json GET /tasks/{taskID}/runtime-usage","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-runtime-usage"},{"title":"List a task's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns"},{"title":"Get a task conversation turn","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns/{turnID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns-by-turnid"},{"title":"List the messages a task conversation turn owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/turns/{turnID}/messages","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-turns-by-turnid-messages"},{"title":"List a task's chats","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats"},{"title":"List the ways a chat of a task can run","openapi":"api-reference/openapi.json GET /tasks/{taskID}/start-options","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-start-options"},{"title":"Read a task's recorded diff","openapi":"api-reference/openapi.json GET /tasks/{taskID}/diff","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-diff"},{"title":"Start a chat in a task's workspace","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats"},{"title":"Fork a chat into a new chat of its task, or a new task in a sandbox or on one of your computers","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/fork","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-fork"},{"title":"List where a chat can be forked","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/fork-options","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-fork-options"},{"title":"Read one chat of a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid"},{"title":"Change a chat of a task","openapi":"api-reference/openapi.json PATCH /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/patch-tasks-by-taskid-chats-by-chatid"},{"title":"Remove a chat from Aether","openapi":"api-reference/openapi.json DELETE /tasks/{taskID}/chats/{chatID}","href":"/api-reference/endpoints/tasks/delete-tasks-by-taskid-chats-by-chatid"},{"title":"Send a chat a message","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/messages","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-messages"},{"title":"Answer what a chat's agent is asking","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/answer","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-answer"},{"title":"Stop a chat's running turn","openapi":"api-reference/openapi.json POST /tasks/{taskID}/chats/{chatID}/stop","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-chats-by-chatid-stop"},{"title":"List a chat's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns"},{"title":"Read one of a chat's conversation turns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns/{turnID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns-by-turnid"},{"title":"List the messages one of a chat's turns owns","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/turns/{turnID}/messages","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-turns-by-turnid-messages"},{"title":"Read a chat's open messages and their canonical replacements","openapi":"api-reference/openapi.json GET /tasks/{taskID}/chats/{chatID}/conversation/live","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-chats-by-chatid-conversation-live"},{"title":"Remove a queued message from a task","openapi":"api-reference/openapi.json DELETE /tasks/{taskID}/messages/{messageID}","href":"/api-reference/endpoints/tasks/delete-tasks-by-taskid-messages-by-messageid"},{"title":"Read a message sent to a task","openapi":"api-reference/openapi.json GET /tasks/{taskID}/messages/{messageID}","href":"/api-reference/endpoints/tasks/get-tasks-by-taskid-messages-by-messageid"},{"title":"Send a task a message","openapi":"api-reference/openapi.json POST /tasks/{taskID}/messages","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-messages"},{"title":"Stop a running task","openapi":"api-reference/openapi.json POST /tasks/{taskID}/stop","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-stop"},{"title":"Open a live connection to a task's machine","openapi":"api-reference/openapi.json POST /tasks/{taskID}/connect","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-connect"},{"title":"Keep a task's full context","openapi":"api-reference/openapi.json POST /tasks/{taskID}/idle-compaction/keep","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-idle-compaction-keep"},{"title":"Compact a task's conversation now","openapi":"api-reference/openapi.json POST /tasks/{taskID}/idle-compaction/compact","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-idle-compaction-compact"},{"title":"Fork a task's chat into a new task","openapi":"api-reference/openapi.json POST /tasks/{taskID}/fork","href":"/api-reference/endpoints/tasks/post-tasks-by-taskid-fork"},{"title":"Create a task from an imported Codex session","openapi":"api-reference/openapi.json POST /orgs/{orgID}/tasks/teleport","href":"/api-reference/endpoints/tasks/post-orgs-by-orgid-tasks-teleport"}]},{"group":"Environment Variables","pages":[{"title":"List project environment variables","openapi":"api-reference/openapi.json GET /projects/{projectID}/env-vars","href":"/api-reference/endpoints/env-vars/get-projects-by-projectid-env-vars"},{"title":"Import project environment variables","openapi":"api-reference/openapi.json POST /projects/{projectID}/env-vars/import","href":"/api-reference/endpoints/env-vars/post-projects-by-projectid-env-vars-import"},{"title":"Get project environment variable","openapi":"api-reference/openapi.json GET /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/get-projects-by-projectid-env-vars-by-key"},{"title":"Set project environment variable","openapi":"api-reference/openapi.json PUT /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/put-projects-by-projectid-env-vars-by-key"},{"title":"Delete project environment variable","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/env-vars/{key}","href":"/api-reference/endpoints/env-vars/delete-projects-by-projectid-env-vars-by-key"}]},{"group":"Secret Files","pages":[{"title":"List project secret files","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files"},{"title":"Bulk upload project secret files","openapi":"api-reference/openapi.json POST /projects/{projectID}/secret-files/bulk","href":"/api-reference/endpoints/secret-files/post-projects-by-projectid-secret-files-bulk"},{"title":"Get project secret file","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files-by-filekey"},{"title":"Get project secret file content","openapi":"api-reference/openapi.json GET /projects/{projectID}/secret-files/{fileKey}/content","href":"/api-reference/endpoints/secret-files/get-projects-by-projectid-secret-files-by-filekey-content"},{"title":"Set project secret file","openapi":"api-reference/openapi.json PUT /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/put-projects-by-projectid-secret-files-by-filekey"},{"title":"Delete project secret file","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/secret-files/{fileKey}","href":"/api-reference/endpoints/secret-files/delete-projects-by-projectid-secret-files-by-filekey"}]},{"group":"Skills","pages":[{"title":"List project skills","openapi":"api-reference/openapi.json GET /projects/{projectID}/skills","href":"/api-reference/endpoints/skills/get-projects-by-projectid-skills"},{"title":"List user skills","openapi":"api-reference/openapi.json GET /skills","href":"/api-reference/endpoints/skills/get-skills"},{"title":"Upload user skill","openapi":"api-reference/openapi.json POST /skills","href":"/api-reference/endpoints/skills/post-skills"},{"title":"Get user skill","openapi":"api-reference/openapi.json GET /skills/{slug}","href":"/api-reference/endpoints/skills/get-skills-by-slug"},{"title":"List user skill files","openapi":"api-reference/openapi.json GET /skills/{slug}/files","href":"/api-reference/endpoints/skills/get-skills-by-slug-files"},{"title":"Delete user skill","openapi":"api-reference/openapi.json DELETE /skills/{slug}","href":"/api-reference/endpoints/skills/delete-skills-by-slug"},{"title":"List a project's default skills","openapi":"api-reference/openapi.json GET /projects/{projectID}/default-skills","href":"/api-reference/endpoints/skills/get-projects-by-projectid-default-skills"},{"title":"Enable a default skill on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/default-skills/{slug}","href":"/api-reference/endpoints/skills/put-projects-by-projectid-default-skills-by-slug"},{"title":"Disable a default skill on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/default-skills/{slug}","href":"/api-reference/endpoints/skills/delete-projects-by-projectid-default-skills-by-slug"}]},{"group":"Automations","pages":[{"title":"List automations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/automations","href":"/api-reference/endpoints/automations/get-orgs-by-orgid-automations"},{"title":"List project automations","openapi":"api-reference/openapi.json GET /projects/{projectID}/automations","href":"/api-reference/endpoints/automations/get-projects-by-projectid-automations"},{"title":"Get automation","openapi":"api-reference/openapi.json GET /automations/{automationID}","href":"/api-reference/endpoints/automations/get-automations-by-automationid"},{"title":"Delete automation","openapi":"api-reference/openapi.json DELETE /automations/{automationID}","href":"/api-reference/endpoints/automations/delete-automations-by-automationid"},{"title":"Update automation","openapi":"api-reference/openapi.json PATCH /automations/{automationID}","href":"/api-reference/endpoints/automations/patch-automations-by-automationid"},{"title":"List automation runs","openapi":"api-reference/openapi.json GET /automations/{automationID}/runs","href":"/api-reference/endpoints/automations/get-automations-by-automationid-runs"},{"title":"Create project automation","openapi":"api-reference/openapi.json POST /projects/{projectID}/automations","href":"/api-reference/endpoints/automations/post-projects-by-projectid-automations"}]},{"group":"Agent Profiles","pages":[{"title":"List agent profiles","openapi":"api-reference/openapi.json GET /orgs/{orgID}/agent-profiles","href":"/api-reference/endpoints/agent-profiles/get-orgs-by-orgid-agent-profiles"},{"title":"Create agent profile","openapi":"api-reference/openapi.json POST /orgs/{orgID}/agent-profiles","href":"/api-reference/endpoints/agent-profiles/post-orgs-by-orgid-agent-profiles"},{"title":"Get agent profile","openapi":"api-reference/openapi.json GET /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/get-agent-profiles-by-profileid"},{"title":"Update agent profile","openapi":"api-reference/openapi.json PATCH /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/patch-agent-profiles-by-profileid"},{"title":"Delete agent profile","openapi":"api-reference/openapi.json DELETE /agent-profiles/{profileID}","href":"/api-reference/endpoints/agent-profiles/delete-agent-profiles-by-profileid"}]},{"group":"Agent Choices","pages":[{"title":"List each agent's models, thinking levels and modes","openapi":"api-reference/openapi.json GET /agent-choices","href":"/api-reference/endpoints/agent-choices/get-agent-choices"}]},{"group":"MCP Servers","pages":[{"title":"List the organization's MCP servers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-servers"},{"title":"Probe how a remote MCP server authenticates","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers/probe","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers-probe"},{"title":"Add an MCP server to the organization's catalog","openapi":"api-reference/openapi.json POST /orgs/{orgID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/post-orgs-by-orgid-mcp-servers"},{"title":"Update an MCP server","openapi":"api-reference/openapi.json PATCH /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/patch-mcp-servers-by-mcpserverid"},{"title":"Delete an MCP server","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid"},{"title":"Preview updating a directory server from its entry","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update-preview","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update-preview"},{"title":"Update a directory server to the revision its preview showed","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/directory-update","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-directory-update"},{"title":"List the MCP servers a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-servers","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-servers"},{"title":"Check whether your tasks in a project can start","openapi":"api-reference/openapi.json GET /projects/{projectID}/mcp-server-readiness","href":"/api-reference/endpoints/mcp-servers/get-projects-by-projectid-mcp-server-readiness"},{"title":"Enable an MCP server on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/put-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"Disable an MCP server on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/mcp-servers/{mcpServerID}","href":"/api-reference/endpoints/mcp-servers/delete-projects-by-projectid-mcp-servers-by-mcpserverid"},{"title":"List your MCP server connections and the organization's","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-server-connections","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-server-connections"},{"title":"Connect an MCP server with your API key","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-connection"},{"title":"Disconnect your MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-connection"},{"title":"Connect an MCP server for the organization","openapi":"api-reference/openapi.json PUT /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/put-mcp-servers-by-mcpserverid-org-connection"},{"title":"Disconnect the organization's MCP server connection","openapi":"api-reference/openapi.json DELETE /mcp-servers/{mcpServerID}/org-connection","href":"/api-reference/endpoints/mcp-servers/delete-mcp-servers-by-mcpserverid-org-connection"},{"title":"Connect an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-connection-oauth"},{"title":"Connect an MCP server with OAuth for the organization","openapi":"api-reference/openapi.json POST /mcp-servers/{mcpServerID}/org-connection/oauth","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-by-mcpserverid-org-connection-oauth"},{"title":"Finish connecting an MCP server with OAuth","openapi":"api-reference/openapi.json POST /mcp-servers/oauth/callback","href":"/api-reference/endpoints/mcp-servers/post-mcp-servers-oauth-callback"},{"title":"List the organization's OAuth apps","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps"},{"title":"Read the redirect URI an OAuth app registers","openapi":"api-reference/openapi.json GET /orgs/{orgID}/mcp-oauth-apps/redirect-uri","href":"/api-reference/endpoints/mcp-servers/get-orgs-by-orgid-mcp-oauth-apps-redirect-uri"},{"title":"Save the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json PUT /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/put-orgs-by-orgid-mcp-oauth-apps"},{"title":"Delete the organization's OAuth app for an issuer","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/mcp-oauth-apps","href":"/api-reference/endpoints/mcp-servers/delete-orgs-by-orgid-mcp-oauth-apps"}]},{"group":"Plugins","pages":[{"title":"List the official plugin marketplaces","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugin-marketplaces","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugin-marketplaces"},{"title":"List the plugins a marketplace offers","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugin-marketplaces/browse","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugin-marketplaces-browse"},{"title":"List the organization's plugins","openapi":"api-reference/openapi.json GET /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-plugins"},{"title":"Install a plugin in the organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/plugins","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-plugins"},{"title":"Preview updating a plugin","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update-preview","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update-preview"},{"title":"Update a plugin to the revision its preview showed","openapi":"api-reference/openapi.json POST /plugins/{pluginID}/update","href":"/api-reference/endpoints/plugins/post-plugins-by-pluginid-update"},{"title":"Change a plugin's organization-wide defaults","openapi":"api-reference/openapi.json PATCH /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/patch-plugins-by-pluginid"},{"title":"Uninstall a plugin","openapi":"api-reference/openapi.json DELETE /plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-plugins-by-pluginid"},{"title":"List the plugins a project enables","openapi":"api-reference/openapi.json GET /projects/{projectID}/plugins","href":"/api-reference/endpoints/plugins/get-projects-by-projectid-plugins"},{"title":"Enable a plugin on a project","openapi":"api-reference/openapi.json PUT /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/put-projects-by-projectid-plugins-by-pluginid"},{"title":"Disable a plugin on a project","openapi":"api-reference/openapi.json DELETE /projects/{projectID}/plugins/{pluginID}","href":"/api-reference/endpoints/plugins/delete-projects-by-projectid-plugins-by-pluginid"},{"title":"List Aether's integration directory","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-directory","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-directory"},{"title":"Search integrations by name","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search"},{"title":"Search the MCP registry","openapi":"api-reference/openapi.json GET /orgs/{orgID}/integration-search/registry","href":"/api-reference/endpoints/plugins/get-orgs-by-orgid-integration-search-registry"},{"title":"Install an integration of Aether's integration directory","openapi":"api-reference/openapi.json POST /orgs/{orgID}/integration-directory/{key}/install","href":"/api-reference/endpoints/plugins/post-orgs-by-orgid-integration-directory-by-key-install"}]},{"group":"Usage","pages":[{"title":"Get usage summary","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/summary","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-summary"},{"title":"List the tasks that used anything in a range","openapi":"api-reference/openapi.json GET /orgs/{orgID}/usage/tasks","href":"/api-reference/endpoints/usage/get-orgs-by-orgid-usage-tasks"}]},{"group":"Profile","pages":[{"title":"Get profile","openapi":"api-reference/openapi.json GET /profile","href":"/api-reference/endpoints/profile/get-profile"},{"title":"Delete your account","openapi":"api-reference/openapi.json DELETE /profile","href":"/api-reference/endpoints/profile/delete-profile"},{"title":"Complete onboarding","openapi":"api-reference/openapi.json POST /profile/onboarding/complete","href":"/api-reference/endpoints/profile/post-profile-onboarding-complete"},{"title":"Launch the onboarding task","openapi":"api-reference/openapi.json POST /profile/onboarding/launch","href":"/api-reference/endpoints/profile/post-profile-onboarding-launch"},{"title":"Set up the onboarding repository","openapi":"api-reference/openapi.json POST /profile/onboarding/repo","href":"/api-reference/endpoints/profile/post-profile-onboarding-repo"}]},{"group":"Organizations","pages":[{"title":"List my organizations","openapi":"api-reference/openapi.json GET /orgs","href":"/api-reference/endpoints/orgs/get-orgs"},{"title":"Create a team organization","openapi":"api-reference/openapi.json POST /orgs","href":"/api-reference/endpoints/orgs/post-orgs"},{"title":"Change organization settings","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid"},{"title":"Delete a team organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid"},{"title":"Get an organization's teardown","openapi":"api-reference/openapi.json GET /orgs/{orgID}/teardown","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-teardown"},{"title":"List organization members","openapi":"api-reference/openapi.json GET /orgs/{orgID}/members","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-members"},{"title":"Change an organization member's role","openapi":"api-reference/openapi.json PATCH /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/patch-orgs-by-orgid-members-by-userid"},{"title":"Remove an organization member","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/{userID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-by-userid"},{"title":"Leave an organization","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/members/me","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-members-me"},{"title":"Ask the organization's admins for a seat","openapi":"api-reference/openapi.json POST /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-seat-requests"},{"title":"List the organization's seat requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/seat-requests","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-seat-requests"},{"title":"List the organization's invitations","openapi":"api-reference/openapi.json GET /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/get-orgs-by-orgid-invites"},{"title":"Invite a user to an organization","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites"},{"title":"Revoke an organization invitation","openapi":"api-reference/openapi.json DELETE /orgs/{orgID}/invites/{inviteID}","href":"/api-reference/endpoints/orgs/delete-orgs-by-orgid-invites-by-inviteid"},{"title":"Resend an organization invitation","openapi":"api-reference/openapi.json POST /orgs/{orgID}/invites/{inviteID}/resend","href":"/api-reference/endpoints/orgs/post-orgs-by-orgid-invites-by-inviteid-resend"},{"title":"List my open organization invitations (pending or expired)","openapi":"api-reference/openapi.json GET /invites","href":"/api-reference/endpoints/orgs/get-invites"},{"title":"Accept an organization invitation","openapi":"api-reference/openapi.json POST /invites/{inviteID}/accept","href":"/api-reference/endpoints/orgs/post-invites-by-inviteid-accept"}]},{"group":"User Discovery","pages":[{"title":"Get dismissed discovery keys","openapi":"api-reference/openapi.json GET /user/discovery","href":"/api-reference/endpoints/user-discovery/get-user-discovery"},{"title":"Dismiss a discovery key","openapi":"api-reference/openapi.json PUT /user/discovery/dismissed-keys/{discoveryKey}","href":"/api-reference/endpoints/user-discovery/put-user-discovery-dismissed-keys-by-discoverykey"}]},{"group":"User Flags","pages":[{"title":"Get your feature flags","openapi":"api-reference/openapi.json GET /user/flags","href":"/api-reference/endpoints/user-flags/get-user-flags"}]},{"group":"Pull Requests","pages":[{"title":"List the organization's pull requests","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests"},{"title":"Count the organization's pull requests per section","openapi":"api-reference/openapi.json GET /orgs/{orgID}/pull-requests/sections","href":"/api-reference/endpoints/pull-requests/get-orgs-by-orgid-pull-requests-sections"},{"title":"Get one pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid"},{"title":"Get one pull request's review","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review"},{"title":"Get one file's content at a reviewed commit of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/file","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-file"},{"title":"Get the snapshot of a pull request head: its changed files against the base tip, their patches and their contents at the head","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/head-snapshot","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-head-snapshot"},{"title":"Retry the capture of a pull request head's snapshot that gave up","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/head-snapshot/capture","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-head-snapshot-capture"},{"title":"Get the whole stack a reviewed pull request belongs to","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/review/stack","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-review-stack"},{"title":"Request an Aether review of a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/review/runs","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-review-runs"},{"title":"Dispatch pull request feedback to Aether","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/dispatch","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-dispatch"},{"title":"List Aether feedback dispatches for a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/dispatches","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-dispatches"},{"title":"Get a pull request's merge box and checks","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github"},{"title":"Post a top-level comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments"},{"title":"Reply to a review comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/replies","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-replies"},{"title":"Resolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/resolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-resolve"},{"title":"Unresolve the review thread containing a comment on a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/comments/{githubCommentID}/unresolve","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-comments-by-githubcommentid-unresolve"},{"title":"Get a pull request's changed files with unified-diff patches","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/diff","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-diff"},{"title":"Merge a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/merge","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-merge"},{"title":"Convert a pull request to a draft","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/draft","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-draft"},{"title":"Mark a draft pull request ready for review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/ready","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-ready"},{"title":"Close a pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/close","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-close"},{"title":"Reopen a closed pull request","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reopen","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reopen"},{"title":"Request a reviewer on a pull request","openapi":"api-reference/openapi.json PUT /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/put-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Withdraw a reviewer's request on a pull request","openapi":"api-reference/openapi.json DELETE /pull-requests/{pullRequestID}/github/reviewers/{kind}/{name}","href":"/api-reference/endpoints/pull-requests/delete-pull-requests-by-pullrequestid-github-reviewers-by-kind-by-name"},{"title":"Submit a human pull request review","openapi":"api-reference/openapi.json POST /pull-requests/{pullRequestID}/github/reviews","href":"/api-reference/endpoints/pull-requests/post-pull-requests-by-pullrequestid-github-reviews"},{"title":"List a pull request's review threads","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/github/threads","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-github-threads"},{"title":"List a pull request's activity","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/activity","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-activity"},{"title":"List a pull request's recorded verification events","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/verification-events","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-verification-events"},{"title":"Get everything recorded as proof of a pull request","openapi":"api-reference/openapi.json GET /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-pull-requests-by-pullrequestid-proof"},{"title":"Change who may watch a pull request's proof","openapi":"api-reference/openapi.json PATCH /pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/patch-pull-requests-by-pullrequestid-proof"},{"title":"Resolve a pull request by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number"},{"title":"Resolve a pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-repos-by-owner-by-repo-pulls-by-number-proof"},{"title":"Get a public pull request's proof","openapi":"api-reference/openapi.json GET /public/pull-requests/{pullRequestID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-pull-requests-by-pullrequestid-proof"},{"title":"Resolve where a task's public proof is watched","openapi":"api-reference/openapi.json GET /public/tasks/{taskID}/proof","href":"/api-reference/endpoints/pull-requests/get-public-tasks-by-taskid-proof"},{"title":"Resolve a public pull request's proof by repository and number","openapi":"api-reference/openapi.json GET /public/repos/{owner}/{repo}/pulls/{number}/proof","href":"/api-reference/endpoints/pull-requests/get-public-repos-by-owner-by-repo-pulls-by-number-proof"}]},{"group":"Push Tokens","pages":[{"title":"Register an Expo push token for the current user","openapi":"api-reference/openapi.json POST /user/push-tokens","href":"/api-reference/endpoints/push-tokens/post-user-push-tokens"},{"title":"Unregister an Expo push token for the current user","openapi":"api-reference/openapi.json DELETE /user/push-tokens/{pushToken}","href":"/api-reference/endpoints/push-tokens/delete-user-push-tokens-by-pushtoken"}]},{"group":"Computers","pages":[{"title":"List your computers","openapi":"api-reference/openapi.json GET /computers","href":"/api-reference/endpoints/computers/get-computers"},{"title":"Register a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid"},{"title":"Update a computer","openapi":"api-reference/openapi.json PATCH /computers/{computerID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid"},{"title":"Remove a computer","openapi":"api-reference/openapi.json DELETE /computers/{computerID}","href":"/api-reference/endpoints/computers/delete-computers-by-computerid"},{"title":"Find or create the task of a checkout","openapi":"api-reference/openapi.json POST /computers/{computerID}/work-tree-tasks","href":"/api-reference/endpoints/computers/post-computers-by-computerid-work-tree-tasks"},{"title":"List the repositories mirrored from a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/repositories","href":"/api-reference/endpoints/computers/get-computers-by-computerid-repositories"},{"title":"Find or create the chat of a terminal session","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Report a terminal chat's status","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid"},{"title":"Read what Aether holds of a terminal chat's session file","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Ship a range of a terminal chat's session file","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/session-files/{file}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-session-files-by-file"},{"title":"Read a stop sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report how a stop sent to a computer settled","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-stops/{stopID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-stops-by-stopid"},{"title":"Report a terminal chat's prompt","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Wait for a terminal chat prompt's answer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Close a terminal chat's prompt","openapi":"api-reference/openapi.json PATCH /computers/{computerID}/terminal-chats/{sessionID}/prompts/{promptID}","href":"/api-reference/endpoints/computers/patch-computers-by-computerid-terminal-chats-by-sessionid-prompts-by-promptid"},{"title":"Read a continuation sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Report a continuation a computer carried out","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-continuations/{continuationID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-continuations-by-continuationid"},{"title":"Read a message sent to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-deliveries-by-deliveryid"},{"title":"Report what became of a message sent to a computer","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-deliveries/{deliveryID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-deliveries-by-deliveryid"},{"title":"Report a turn a computer runs with a message","openapi":"api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-runs/{deliveryID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-terminal-chat-runs-by-deliveryid"},{"title":"List the turns a computer runs or holds","openapi":"api-reference/openapi.json GET /computers/{computerID}/terminal-chat-runs","href":"/api-reference/endpoints/computers/get-computers-by-computerid-terminal-chat-runs"},{"title":"Export a chat's Claude Code session file to a computer","openapi":"api-reference/openapi.json GET /computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file","href":"/api-reference/endpoints/computers/get-computers-by-computerid-tasks-by-taskid-chats-by-chatid-session-file"},{"title":"Record that a folder's next terminal chat is a fork of a chat","openapi":"api-reference/openapi.json POST /computers/{computerID}/pending-terminal-forks","href":"/api-reference/endpoints/computers/post-computers-by-computerid-pending-terminal-forks"},{"title":"List the tasks a computer is to start","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts"},{"title":"Read a task a computer is to start","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts/{startID}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts-by-startid"},{"title":"Report a task a computer started","openapi":"api-reference/openapi.json PUT /computers/{computerID}/task-starts/{startID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-task-starts-by-startid"},{"title":"Read a file a fork started on a computer places","openapi":"api-reference/openapi.json GET /computers/{computerID}/task-starts/{startID}/files/{file}","href":"/api-reference/endpoints/computers/get-computers-by-computerid-task-starts-by-startid-files-by-file"},{"title":"Read what a computer diffs a task's work tree by","openapi":"api-reference/openapi.json GET /computers/{computerID}/tasks/{taskID}/work-tree","href":"/api-reference/endpoints/computers/get-computers-by-computerid-tasks-by-taskid-work-tree"},{"title":"Record a task's diff","openapi":"api-reference/openapi.json PUT /computers/{computerID}/tasks/{taskID}/diffs/{diffID}","href":"/api-reference/endpoints/computers/put-computers-by-computerid-tasks-by-taskid-diffs-by-diffid"}]},{"group":"Agent","pages":[{"title":"Get your agent","openapi":"api-reference/openapi.json GET /agent","href":"/api-reference/endpoints/agent/get-agent"},{"title":"List your agent's events","openapi":"api-reference/openapi.json GET /agent/events","href":"/api-reference/endpoints/agent/get-agent-events"},{"title":"List your conversation with your agent","openapi":"api-reference/openapi.json GET /agent/messages","href":"/api-reference/endpoints/agent/get-agent-messages"},{"title":"Send your agent a message","openapi":"api-reference/openapi.json POST /agent/messages","href":"/api-reference/endpoints/agent/post-agent-messages"},{"title":"Get your agent's memory","openapi":"api-reference/openapi.json GET /agent/memory","href":"/api-reference/endpoints/agent/get-agent-memory"},{"title":"Edit your agent's memory","openapi":"api-reference/openapi.json POST /agent/memory/edits","href":"/api-reference/endpoints/agent/post-agent-memory-edits"},{"title":"Get an edit of your agent's memory","openapi":"api-reference/openapi.json GET /agent/memory/edits/{editID}","href":"/api-reference/endpoints/agent/get-agent-memory-edits-by-editid"},{"title":"List your agent's tool calls this month","openapi":"api-reference/openapi.json GET /agent/tool-usage","href":"/api-reference/endpoints/agent/get-agent-tool-usage"},{"title":"Change your agent","openapi":"api-reference/openapi.json PATCH /agent","href":"/api-reference/endpoints/agent/patch-agent"},{"title":"Issue a single-use link","openapi":"api-reference/openapi.json POST /agent/links","href":"/api-reference/endpoints/agent/post-agent-links"},{"title":"Redeem a single-use link","openapi":"api-reference/openapi.json POST /agent/links/redeem","href":"/api-reference/endpoints/agent/post-agent-links-redeem"},{"title":"Paste a code on a single-use link","openapi":"api-reference/openapi.json POST /agent/links/paste","href":"/api-reference/endpoints/agent/post-agent-links-paste"},{"title":"Pick up the code pasted on a single-use link","openapi":"api-reference/openapi.json POST /agent/links/pickup","href":"/api-reference/endpoints/agent/post-agent-links-pickup"},{"title":"Get a connector","openapi":"api-reference/openapi.json GET /agent/connectors/{key}","href":"/api-reference/endpoints/agent/get-agent-connectors-by-key"},{"title":"Get your phone link","openapi":"api-reference/openapi.json GET /agent/phone","href":"/api-reference/endpoints/agent/get-agent-phone"},{"title":"Ask for a code to link your phone","openapi":"api-reference/openapi.json POST /agent/phone/verification","href":"/api-reference/endpoints/agent/post-agent-phone-verification"},{"title":"Delete your agent","openapi":"api-reference/openapi.json DELETE /agent","href":"/api-reference/endpoints/agent/delete-agent"}]},{"group":"Connections","pages":[{"title":"List your connections","openapi":"api-reference/openapi.json GET /connections","href":"/api-reference/endpoints/connections/get-connections"},{"title":"Add a connection: Claude plan","openapi":"api-reference/openapi.json POST /connections/claude-plan","href":"/api-reference/endpoints/connections/post-connections-claude-plan"},{"title":"Add a connection: Anthropic API key","openapi":"api-reference/openapi.json POST /connections/anthropic-api-key","href":"/api-reference/endpoints/connections/post-connections-anthropic-api-key"},{"title":"Add a connection: OpenAI API key","openapi":"api-reference/openapi.json POST /connections/openai-api-key","href":"/api-reference/endpoints/connections/post-connections-openai-api-key"},{"title":"Add a connection: OpenRouter API key","openapi":"api-reference/openapi.json POST /connections/openrouter-api-key","href":"/api-reference/endpoints/connections/post-connections-openrouter-api-key"},{"title":"Add a connection: OpenCode auth file","openapi":"api-reference/openapi.json POST /connections/opencode-auth-file","href":"/api-reference/endpoints/connections/post-connections-opencode-auth-file"},{"title":"Start a ChatGPT plan device sign-in","openapi":"api-reference/openapi.json POST /connections/chatgpt-plan/device-auths","href":"/api-reference/endpoints/connections/post-connections-chatgpt-plan-device-auths"},{"title":"Read a ChatGPT plan device sign-in","openapi":"api-reference/openapi.json GET /connections/chatgpt-plan/device-auths/{deviceAuthID}","href":"/api-reference/endpoints/connections/get-connections-chatgpt-plan-device-auths-by-deviceauthid"},{"title":"Reconnect a connection","openapi":"api-reference/openapi.json POST /connections/{connectionID}/reconnect","href":"/api-reference/endpoints/connections/post-connections-by-connectionid-reconnect"},{"title":"Rename a connection","openapi":"api-reference/openapi.json PATCH /connections/{connectionID}","href":"/api-reference/endpoints/connections/patch-connections-by-connectionid"},{"title":"Disconnect a connection","openapi":"api-reference/openapi.json DELETE /connections/{connectionID}","href":"/api-reference/endpoints/connections/delete-connections-by-connectionid"},{"title":"List your connection defaults","openapi":"api-reference/openapi.json GET /connections/defaults","href":"/api-reference/endpoints/connections/get-connections-defaults"},{"title":"Set a harness's default connection","openapi":"api-reference/openapi.json PUT /connections/defaults/{harness}","description":"Sets what the caller's new tasks for a harness run on when neither the task nor its profile says otherwise, and optionally the fallback a task on a plan continues on when its profile's fallback does not govern it.\n\nUse this tool when you need to:\n- Make one of the caller's connections the default for Claude Code, Codex or OpenCode tasks\n- Put Claude Code or Codex tasks back on Aether inference\n- Choose a default and its fallback in one write\n\nExamples:\n- PUT /connections/defaults/claude-code {\"runs_on\": \"stored\", \"connection_id\": \"6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21\"}\n- PUT /connections/defaults/codex {\"runs_on\": \"aether\", \"fallback\": {\"mode\": \"none\"}}\n\nHints:\n- harness is claude-code, codex or opencode (the schema answers 422 for any other). The body is runs_on aether (Aether inference, Claude Code and Codex only) or runs_on stored with the connection_id of a connection the caller holds, either with an optional fallback; the schema answers 422 for any other shape. Returns the harness's default as written.\n- fallback is what a task on one of the caller's plans for the harness continues on when the plan's window is spent, unless its profile decides: a task born on a profile that pins a plan follows that profile's fallback, none included, while it fails on the profile's pin or where a move under that profile put it, and never reads this one; patchAgentProfile sets a profile's fallback. absent keeps it; mode none stops; named takes its connection or Aether inference as a last hop; any_usable tries the caller's held connections of this harness that no limit blocks for the task's model, then its optional named then hop. The named hop is refused as the default is, and never names the default's own connection. Without fallback the saved fallback is kept, but for one naming the new default's connection, which is cleared (a fallback onto itself means nothing).\n- The default affects new tasks only: existing tasks keep the connection they started on through every turn and follow-up. The fallback is read when a plan's window is spent, so a change to it reaches the caller's existing tasks on a plan too, but for those their profile's fallback governs (see patchAgentProfile).\n- Disconnecting the fallback's connection leaves it disconnected (connection_id absent) and a task's move onto it refused.\n- Use patchDefaultConnection instead to write the fallback alone and keep the default, listConnectionDefaults to read the current defaults, listConnections for the connection ids, and patchTask, patchAgentProfile or patchAgent (each by its runs_on field) to choose what one task, a profile or the caller's agent runs on.\n- Any signed-in user, for their own defaults; through a platform API key pinned to an org where the caller is a viewer or billing member it is refused with 403 org_role_insufficient, and an agent host's grant with 403 agent_host_route_not_allowed.\n- Refused (the default is checked before its fallback) with 409 aether_inference_unserved for Aether inference on OpenCode, 409 aether_inference_unavailable where this deployment serves no Aether inference, 404 connection_not_found for a connection the caller does not hold (or a connection_id that is not a canonical lowercase uuid), 409 connection_harness_mismatch for a connection that does not work with the harness, 409 connection_agent_only (or 500 where its stored row does not read) for the caller's agent's own ChatGPT login, and 409 fallback_is_own_connection for a fallback naming the default's own connection.","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","description":"Returns the slack.com URL that installs Aether's Slack app in a workspace for the organization, with a state signed for the caller and the organization.\n\nUse this tool when you need to:\n- Connect a Slack workspace to the organization so mentions of Aether in its channels can start tasks\n- Reconnect a workspace whose status has needs_reconnect true, so it grants the commands scope behind /aether and Send to Aether\n- Move the organization to another Slack workspace\n\nExamples:\n- GET /orgs/{orgID}/auth/slack/url\n- GET /orgs/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/auth/slack/url?redirect_to=aether://slack-connected\n\nHints:\n- orgID is the org's uuid; redirect_to is optional, at most 512 characters, and the schema answers 422 for a longer one or one that does not parse as a URL.\n- Open the URL in a browser: the install happens on slack.com, and Slack must redirect back to Aether within 15 minutes of the URL being issued. Aether then returns to redirect_to once the install succeeds, if it is on Aether's own web origin or is the mobile app's aether://slack-connected; otherwise, and on any failure, it goes to the web settings page.\n- The installer must still be an owner or admin when Slack redirects back. Reinstalling the same workspace keeps its routes, linked identities and default actor; installing another workspace deletes the previous one's routes and links; a workspace another organization has installed is refused (team_already_connected on the settings page).\n- Use getSlackStatus instead to read whether Slack is connected or needs_reconnect, and disconnectSlack to remove it.\n- Owners and admins only, with a session or a platform API key: a member, viewer or billing member is refused with 403 org_role_insufficient before redirect_to is validated, a non-member with 403 org_membership_required, an orgID that is not a uuid with 400, and an agent host's grant with 403 agent_host_route_not_allowed. A deployment without a Slack app answers 404 (getSlackStatus reads unavailable).","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":"Set the fallback of a harness's default connection - Aether","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}