Skip to main content

​
What it means

Aeris tried to reach a partner service (Google Ads, Meta, Microsoft, BigQuery, Stripe, …) and got a 5xx, a DNS error, or a TLS handshake failure. This is a transient upstream fault, not a client bug — the same request will most likely succeed shortly.

​
How to fix

  • Wait at least retry_after_ms (default 5000ms) and retry.
  • If retries keep failing over minutes, check the partner’s public status page — details.upstream tells you which one.
  • For write actions with an idempotency_key, safely retry the exact same call; Aeris will not double-apply.
retry_after_ms is currently advisory. The Worker may honour it directly or apply its own circuit-breaker logic in front of it.

​
Response envelope

{
  "ok": false,
  "error_envelope": {
    "code": "UPSTREAM_UNAVAILABLE",
    "message": "The upstream service is currently unavailable.",
    "docs_url": "https://tryaeris.ai/docs/mcp/errors/upstream-unavailable",
    "retryable": true,
    "retry_after_ms": 5000,
    "details": {
      "upstream": "google_ads"
    }
  }
}
  • TIMEOUT — upstream never answered inside our budget.
  • CONNECTION_EXPIRED — upstream refused because auth is stale.
  • INTERNAL — fault inside Aeris, not the partner.