Reconnect and resume your task
Sign the agent in again, refresh a stale tool list, and pick up the same purchase without paying twice.
When a result asks the user to reconnect (HTTP: next.action is reconnect), the host signs the user in to Envoy again through its connector. Then read the purchase you were working on. Follow its next. A reconnect proves who you are. It never changes a purchase or authorizes another payment.
Support revision: envoy@2026-10. Last updated: 3 November 2026.
When to reconnect
| You see | Do |
|---|---|
A plain sentence asking the user to reconnect (HTTP: UNAUTHENTICATED, 401, next.action reconnect) | The token is missing, expired or revoked. Renew once with your refresh token if you hold one; if renewal fails or you have none, reconnect, then retry the call. |
| Token renewal fails, or its reply was lost | Reconnect. Never resend a refresh token that may already have been used. |
Renewal refused with refresh_resource_mismatch | The connection was authorized before Envoy's resource identifier changed on 2026-10-06 and cannot renew. Reconnect once; do not retry renewal. |
retry same_call (HTTP: RATE_LIMITED or a retryable UNAVAILABLE) | Not a sign-in problem. Wait next.wait_seconds (HTTP: next.after_seconds) and repeat the call. |
| The host lists a different catalog than expected for that host | Refresh the tool list (below). Reconnect only if the host cannot refresh. |
Reconnect the same account
- Keep the purchase reference (
purchase_idoridempotency_key). Keep tokens, card details and OTPs out of notes. - Start the host's own sign-in for the Envoy connector, for example its Connect or Reconnect control. The user signs in on the first-party page and approves; the agent never handles the OTP, code or callback URL.
- Check that the host shows the connection as signed in, and that it is the same account. If the account differs, stop: a missing purchase under another account says nothing about the original.
- Read
get_purchase_statuswith your saved reference, or callget_accountand use itsactive_purchase. - Follow that reply's
next. Do not start a new purchase to recover.
No card is released after a disconnect. Only the connection that started a purchase receives its card; another connection of the same agent can read or report it. Cancellation is available before a checkout report, and again when Envoy reopens the card after a failed report. Removing a connection does not end its purchases. Read the purchase from the new connection and follow next. The full procedure is in Recover a purchase.
A connection created with an installation key keeps that key. If the key is lost, sign in again as a new connection; you cannot attach a different key to the old one.
Refresh a stale tool list
The default profile lists thirteen tools: get_account, list_transactions, list_purchases, start_purchase, get_purchase_status, answer_purchase_question, submit_answer (its deprecated name), report_checkout_result, report_checkout_step, cancel_purchase, list_gift_card_merchants, get_merchants (its deprecated name) and search_products. A connection Envoy identifies as Claude lists nine and omits report_checkout_result, report_checkout_step, submit_answer and get_merchants; one identified as ChatGPT lists eight and also omits list_gift_card_merchants. If the catalog differs from the expected list for that host, or an MCP InvalidParams error reports an unknown tool, refresh the catalog.
Use the host's refresh control for the connector, or remove and re-add it, then start a fresh task and list the tools again. Refreshing does not sign you out or change a purchase. Per-host steps are in the host installation guide; see also Follow next and refresh tools.
If access still fails, contact support with the support_ref (HTTP: the error code and request_id) and your purchase reference.