DocsError codes

destination_auth_failed

The credential for this destination is gone. It must be reconnected.

On this page
502HTTP 502 · Destination Auth Failed

What it means#

The credential for this destination is gone. It must be reconnected.

Do not retry

The identical request will fail the same way every time. Change it first.

What causes it#

  • An OAuth grant was revoked or expired.
  • An API key stored for the destination was rotated on the other side.

How to fix it#

  • Reconnect the integration in the dashboard.
  • Retrying cannot help — this is a credential, not a blip.

What the response looks like#

502 application/problem+json
{
  "error": {
    "code": "destination_auth_failed",
    "message": "The credential for this destination is gone. It must be reconnected",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/destination_auth_failed",
  "title": "Destination Auth Failed",
  "status": 502,
  "detail": "The credential for this destination is gone. It must be reconnected",
  "instance": "/api/agents/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}

Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.

Still stuck#

Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.

Something unclear or missing? Tell us and we’ll fix it.