connector_unavailable

The Gate couldn’t reach the connector’s system.

HTTP 503 · api_error · safe to retry

What happened

The Gate couldn’t reach the connector’s system. The tool call didn’t run.

What to do

Check the connector in Console › Connectors, then retry. A 503 is never stored for idempotent replay, so a retry with the same Idempotency-Key runs again.

Example

HTTP 503 · connector_unavailable

{
  "error": {
    "type": "api_error",
    "code": "connector_unavailable",
    "message": "The connector isn't reachable right now. Check Console › Connectors, then retry.",
    "param": null,
    "request_id": "req_01j9zr3m5k8q2w7x4t6v0b1c9d",
    "doc_url": "https://docs.deedglass.com/errors/connector_unavailable"
  }
}

The message is for a person and can get more exact over time: branch on type and code, never on the message.

In the SDKs

SDK	Raised as
TypeScript (@deedglass/sdk)	APIError with code === "connector_unavailable"
Python (deedglass)	deedglass.APIError with .code == "connector_unavailable"

Related

• upstream_error
• timeout
• internal_error
• service_unavailable
• vault_unavailable
• upstream_auth_failed
• Every error code