Skip to main content

​
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

{
  "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"
    }
  }
}