> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryaeris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner connection expired (CONNECTION_EXPIRED)

> A partner OAuth grant (Google, Meta, Microsoft, ...) has lapsed and needs to be re-authorised.

## What it means

Aeris authenticated the caller fine, but the downstream partner connection the tool needs (Google Ads, Meta, Microsoft, TikTok, and similar) has expired or been revoked. Aeris cannot refresh it silently — the account owner must complete OAuth again on the partner.

`details.reconnect_url` points to the exact reconnect flow.

## How to fix

* Surface `details.reconnect_url` to the user (deep link into the Aeris connections page).
* After they reconnect, retry the original tool call.
* If reconnection keeps failing, check whether the partner account itself was suspended — that's outside Aeris' control.

## Response envelope

```json theme={"dark"}
{
  "ok": false,
  "error_envelope": {
    "code": "CONNECTION_EXPIRED",
    "message": "The partner connection has expired — reconnect required.",
    "docs_url": "https://tryaeris.ai/docs/mcp/errors/connection-expired",
    "retryable": false,
    "retry_after_ms": null,
    "details": {
      "channel": "google_ads",
      "reconnect_url": "https://tryaeris.ai/settings/connections/google_ads/reconnect"
    }
  }
}
```

## Related

* [`AUTH_EXPIRED`](/mcp/errors/auth-expired) — the Aeris bearer expired; distinct from a partner grant.
* [`UPSTREAM_UNAVAILABLE`](/mcp/errors/upstream-unavailable) — partner is up but their side is failing.
