Disconnect or remove Envoy
Four separate actions to stop using Envoy with a host, what each one does, and what none of them does.
Read this page when you want to stop using Envoy with an agent host. Disconnecting is four separate actions. Do the ones you need.
Support revision: envoy@2026-10. Last updated: 1 November 2026.
Who this is for: account owners and agent builders.
Prerequisites: access to the host, or to the Envoy app.
Success: the host can no longer read the account, and you know the state of any open purchase.
Recovery: if a step is unclear, contact Envoy support. Share the support_ref when you ask for help.
If a purchase is open, check its state before you revoke access. Follow Handle an open purchase first when you need to stop it.
1. Remove skills from the host
Disable or uninstall Envoy's plugin or skills through the host's supported controls. Follow the host removal steps.
- This removes the installed instructions. A connected host may still discover and call Envoy's tools.
- This does not change account access. The connection stays active until you revoke it.
2. Revoke account access
Pick one way.
- Use the host's disconnect or revoke control. Removing a server configuration alone may not revoke the account connection.
- In Envoy's browser agent pages, press Disconnect.
- Revoke the connection in the Envoy app.
- For HTTP clients, send
POST /disconnectwith the current bearer token. A key-bound connection also sends a fresh proof.
After revoke, the agent can no longer read the account or request purchases.
- Revoking does not cancel an open purchase.
- Revoking does not close a card that Envoy already released. Cancel the purchase first if you want to stop it.
3. Handle an open purchase
An open purchase stays open after you disconnect.
- Open the Envoy app and check the purchase's current state.
- Use the cancellation action there when it is available and you want to stop the purchase.
Before any checkout report, you can call cancel_purchase before you revoke. After a report, Envoy refuses cancellation unless it reopens the card. Read status and let the purchase reconcile. Cancelling is not proof that a card is blocked.
4. Merchant orders and refunds
Envoy cannot change an order at a merchant. If a merchant already took payment, contact the merchant for the order.
- Cancelling a purchase in Envoy is not a refund.
- Refunds come from the merchant. Envoy shows the result in your transactions.