> ## 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. # Reconnect a connection > Replaces a connection's credential with one of its option, keeping its id, its name and every task, profile and default on it, and clears its need to re-authenticate; your agent restarts when it runs on the connection and the credential changed. A ChatGPT plan reconnects through its device sign-in instead. Any signed-in user may call it for a connection they hold. Refused (409 connection_option_mismatch) for a credential of another option than the connection's, (404 connection_not_found) for a connection you do not hold, and (422) for a credential its vendor's format refuses. ## OpenAPI ````yaml api-reference/openapi.json POST /connections/{connectionID}/reconnect openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /connections/{connectionID}/reconnect: post: tags: - connections summary: Reconnect a connection description: >- Replaces a connection's credential with one of its option, keeping its id, its name and every task, profile and default on it, and clears its need to re-authenticate; your agent restarts when it runs on the connection and the credential changed. A ChatGPT plan reconnects through its device sign-in instead. Any signed-in user may call it for a connection they hold. Refused (409 connection_option_mismatch) for a credential of another option than the connection's, (404 connection_not_found) for a connection you do not hold, and (422) for a credential its vendor's format refuses. operationId: reconnectConnection parameters: - description: The connection's id. in: path name: connectionID required: true schema: description: The connection's id. format: uuid type: string requestBody: content: application/json: schema: discriminator: mapping: anthropic_api_key: '#/components/schemas/ReconnectAnthropicAPIKeyConnection' claude_plan: '#/components/schemas/ReconnectClaudePlanConnection' openai_api_key: '#/components/schemas/ReconnectOpenAIAPIKeyConnection' opencode_auth_file: '#/components/schemas/ReconnectOpencodeAuthFileConnection' openrouter_api_key: '#/components/schemas/ReconnectOpenRouterAPIKeyConnection' propertyName: option oneOf: - $ref: '#/components/schemas/ReconnectClaudePlanConnection' - $ref: '#/components/schemas/ReconnectAnthropicAPIKeyConnection' - $ref: '#/components/schemas/ReconnectOpenAIAPIKeyConnection' - $ref: '#/components/schemas/ReconnectOpenRouterAPIKeyConnection' - $ref: '#/components/schemas/ReconnectOpencodeAuthFileConnection' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/Connection' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Not Found '409': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Conflict '422': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ConnectionsErrorResponse' description: Internal Server Error components: schemas: ReconnectAnthropicAPIKeyConnection: additionalProperties: false properties: api_key: minLength: 20 pattern: ^\s*sk-ant-api\S{10,}\s*$ type: string option: enum: - anthropic_api_key type: string required: - option - api_key type: object ReconnectClaudePlanConnection: additionalProperties: false properties: option: enum: - claude_plan type: string token: description: The setup token claude setup-token prints. minLength: 20 pattern: ^\s*sk-ant-oat\S{10,}\s*$ type: string required: - option - token type: object ReconnectOpenAIAPIKeyConnection: additionalProperties: false properties: api_key: minLength: 4 pattern: ^\s*sk-\S+\s*$ type: string option: enum: - openai_api_key type: string required: - option - api_key type: object ReconnectOpencodeAuthFileConnection: additionalProperties: false properties: contents: description: Your ~/.local/share/opencode/auth.json, verbatim. minLength: 1 type: string option: enum: - opencode_auth_file type: string required: - option - contents type: object ReconnectOpenRouterAPIKeyConnection: additionalProperties: false properties: api_key: minLength: 7 pattern: ^\s*sk-or-\S+\s*$ type: string option: enum: - openrouter_api_key type: string required: - option - api_key type: object Connection: description: >- One connection you hold, a variant per option: which credential it holds, qualified by its vendor. reauth is null while the stored credential works. discriminator: mapping: anthropic_api_key: '#/components/schemas/AnthropicApiKeyConnection' chatgpt_host_plan: '#/components/schemas/ChatgptHostPlanConnection' chatgpt_plan: '#/components/schemas/ChatgptPlanConnection' claude_plan: '#/components/schemas/ClaudePlanConnection' openai_api_key: '#/components/schemas/OpenaiApiKeyConnection' opencode_auth_file: '#/components/schemas/OpencodeAuthFileConnection' openrouter_api_key: '#/components/schemas/OpenrouterApiKeyConnection' propertyName: option oneOf: - $ref: '#/components/schemas/ClaudePlanConnection' - $ref: '#/components/schemas/AnthropicApiKeyConnection' - $ref: '#/components/schemas/ChatgptPlanConnection' - $ref: '#/components/schemas/ChatgptHostPlanConnection' - $ref: '#/components/schemas/OpenaiApiKeyConnection' - $ref: '#/components/schemas/OpenrouterApiKeyConnection' - $ref: '#/components/schemas/OpencodeAuthFileConnection' 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 AnthropicApiKeyConnection: additionalProperties: false description: An Anthropic API key. properties: id: format: uuid type: string key_suffix: description: The key's last four characters, for a key of at least eight. minLength: 1 type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - anthropic_api_key type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth type: object ChatgptHostPlanConnection: additionalProperties: false description: >- The ChatGPT login your agent did on its own host. Read-only: your agent signs in on its host, so no operation adds or reconnects it, and only your agent runs on it. properties: email: description: The ChatGPT account's email, when its token names one. minLength: 1 type: string id: format: uuid type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - chatgpt_host_plan type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth type: object ChatgptPlanConnection: additionalProperties: false description: A ChatGPT plan's tokens. properties: email: description: The ChatGPT account's email, when its token names one. minLength: 1 type: string id: format: uuid type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - chatgpt_plan type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth type: object ClaudePlanConnection: additionalProperties: false description: A Claude plan's setup token. properties: id: format: uuid type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - claude_plan type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth type: object OpenaiApiKeyConnection: additionalProperties: false description: An OpenAI API key. properties: id: format: uuid type: string key_suffix: description: The key's last four characters, for a key of at least eight. minLength: 1 type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - openai_api_key type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth type: object OpencodeAuthFileConnection: additionalProperties: false description: An OpenCode auth file. properties: id: format: uuid type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - opencode_auth_file type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array providers: description: The model providers the auth file signs in to. items: minLength: 1 type: string type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth - providers type: object OpenrouterApiKeyConnection: additionalProperties: false description: An OpenRouter API key. properties: id: format: uuid type: string key_suffix: description: The key's last four characters, for a key of at least eight. minLength: 1 type: string limits: description: >- The vendor limits this connection has spent, excluding markers whose reset time has passed. items: discriminator: mapping: credits: '#/components/schemas/ConnectionCreditsLimit' model: '#/components/schemas/ConnectionModelLimit' session: '#/components/schemas/ConnectionSessionLimit' usage: '#/components/schemas/ConnectionUsageLimit' weekly: '#/components/schemas/ConnectionWeeklyLimit' propertyName: scope oneOf: - $ref: '#/components/schemas/ConnectionSessionLimit' - $ref: '#/components/schemas/ConnectionWeeklyLimit' - $ref: '#/components/schemas/ConnectionModelLimit' - $ref: '#/components/schemas/ConnectionCreditsLimit' - $ref: '#/components/schemas/ConnectionUsageLimit' type: array name: description: >- The name you gave the connection, unique among your connections of its option. minLength: 1 type: string option: enum: - openrouter_api_key type: string profiles: description: The agent profiles that run on the connection. items: $ref: '#/components/schemas/ConnectionProfile' type: array reauth: anyOf: - $ref: '#/components/schemas/ConnectionReauth' - type: 'null' required: - option - id - name - reauth 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 ConnectionCreditsLimit: additionalProperties: false properties: reason: minLength: 1 type: string scope: enum: - credits type: string until: format: date-time type: - string - 'null' required: - scope - until - reason type: object ConnectionModelLimit: additionalProperties: false properties: model: minLength: 1 type: string reason: minLength: 1 type: string scope: enum: - model type: string until: format: date-time type: - string - 'null' required: - scope - until - reason - model type: object ConnectionSessionLimit: additionalProperties: false properties: reason: minLength: 1 type: string scope: enum: - session type: string until: format: date-time type: - string - 'null' required: - scope - until - reason type: object ConnectionUsageLimit: additionalProperties: false properties: reason: minLength: 1 type: string scope: enum: - usage type: string until: format: date-time type: - string - 'null' required: - scope - until - reason type: object ConnectionWeeklyLimit: additionalProperties: false properties: reason: minLength: 1 type: string scope: enum: - weekly type: string until: format: date-time type: - string - 'null' required: - scope - until - reason type: object ConnectionProfile: additionalProperties: false properties: id: format: uuid type: string name: minLength: 1 type: string org: description: The name of the organization the profile belongs to. minLength: 1 type: string required: - id - name - org type: object ConnectionReauth: additionalProperties: false properties: reason: description: Why the stored credential failed, as the vendor said. minLength: 1 type: string required: - reason type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.