> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # List your connection defaults > Lists the caller's default per harness that has one: what their Claude Code, Codex and OpenCode tasks run on when nothing else says. Use this tool when you need to: - Read what a harness's tasks run on by default, and the fallback a task on a plan continues on - Check a default before changing it with setDefaultConnection Examples: - GET /connections/defaults Hints: - Takes no parameters. Each default carries harness and runs_on: aether, or stored with the connection_id it runs on, and its fallback where one is set. - A harness with no entry has no configured default: none was chosen, or, for OpenCode, its last connection was disconnected; Claude Code and Codex tasks then run on Aether inference. - Use setDefaultConnection instead to change a default, and listConnections to read the connections a default can name. - 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. ## OpenAPI ````yaml api-reference/openapi.json GET /connections/defaults openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /connections/defaults: get: tags: - connections summary: List your connection defaults description: >- Lists the caller's default per harness that has one: what their Claude Code, Codex and OpenCode tasks run on when nothing else says. Use this tool when you need to: - Read what a harness's tasks run on by default, and the fallback a task on a plan continues on - Check a default before changing it with setDefaultConnection Examples: - GET /connections/defaults Hints: - Takes no parameters. Each default carries harness and runs_on: aether, or stored with the connection_id it runs on, and its fallback where one is set. - A harness with no entry has no configured default: none was chosen, or, for OpenCode, its last connection was disconnected; Claude Code and Codex tasks then run on Aether inference. - Use setDefaultConnection instead to change a default, and listConnections to read the connections a default can name. - 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. operationId: listConnectionDefaults responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListConnectionDefault' description: OK '401': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '500': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Internal Server Error components: schemas: ListConnectionDefault: additionalProperties: false properties: items: items: $ref: '#/components/schemas/ConnectionDefault' type: array required: - items type: object ConnectionsErrorResponse: 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 - 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 - 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 error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code type: object ConnectionDefault: additionalProperties: false properties: connection_id: description: The connection a stored default runs on. format: uuid type: string fallback: description: >- What a task on one of your plans for the harness continues on, once, when the plan's window is spent. Absent: nothing happens. oneOf: - $ref: '#/components/schemas/ConnectionFallbackAether' - $ref: '#/components/schemas/ConnectionFallbackStored' - $ref: '#/components/schemas/ConnectionFallbackDisconnected' harness: $ref: '#/components/schemas/AgentType' runs_on: description: >- aether, Aether inference, paid from your organization's balance; stored, the connection connection_id names. enum: - aether - stored type: string required: - harness - runs_on type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ConnectionFallbackAether: additionalProperties: false properties: runs_on: description: Aether inference, paid from your organization's balance. enum: - aether type: string required: - runs_on type: object ConnectionFallbackStored: additionalProperties: false properties: connection_id: format: uuid type: string held: enum: - true type: boolean runs_on: description: >- The connection connection_id names; held false once it was disconnected. enum: - stored type: string required: - runs_on - held - connection_id type: object ConnectionFallbackDisconnected: additionalProperties: false properties: held: enum: - false type: boolean runs_on: description: >- The connection connection_id names; held false once it was disconnected. enum: - stored type: string required: - runs_on - held type: object AgentType: description: >- The agent harness that runs a task, a profile or a connection: claude-code is Claude Code, codex is Codex, opencode is OpenCode. enum: - codex - claude-code - opencode type: string securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.