> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke a connection

> Safely remove access to a connected Account.

Revoke a connection to immediately remove your workspace's authority over a connected Account. The connected Account keeps its Book, environments, and history — only your workspace's access ends.

## Before you start

* You must be an **organization admin**. Members can view a connected Account but cannot revoke the connection.
* Know which connection you want to revoke. The drill-down page shows the Account name, access level, and billing responsibility before you confirm.

<Warning>
  Revocation is immediate and irreversible for this workspace. To restore access, create a new connection request. The connected Account's administrator must accept it again.
</Warning>

## Steps

<Steps>
  <Step title="Open the connected Account">
    In the sidebar, open **Accounts** and click the Account name to open its drill-down page. See [Work in a connected Account](/accounts/work-in-a-connected-account).
  </Step>

  <Step title="Scroll to the Connection section">
    If you are an admin, the drill-down shows a **Connection** section near the bottom. The description reads: "Revocation removes this workspace's authority immediately without changing the Account's records."
  </Step>

  <Step title="Click Revoke connection">
    Click **Revoke connection** to begin. A confirmation panel replaces the button.
  </Step>

  <Step title="Review the consequences and confirm">
    The confirmation panel states: "Access ends immediately. The connected Account keeps its Book, environments, and history."

    Click **Confirm revoke** to proceed, or **Keep connection** to cancel.
  </Step>
</Steps>

## Success

You are redirected to the Accounts portfolio. The revoked Account no longer appears in the reachable portfolio. Deep links to the Account fail closed with the same not-available result as a foreign or malformed Account ID.

## What revocation does

| Effect                          | What happens                                                                                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **HQ access**                   | The connected Account disappears from the portfolio. Deep links fail closed.                                                                                  |
| **API access**                  | Machine requests targeting the connected Account through your workspace fail with the same unavailable shape.                                                 |
| **Connected Account's records** | The Account keeps its Book, environments, and history. Nothing is deleted.                                                                                    |
| **Billing**                     | Future Live Book use is no longer attributed to your workspace. Existing usage that was already attributed remains on the effective billing Account's record. |
| **Credentials**                 | The connected Account's API keys, webhook endpoints, and component installations remain owned by the Account. Your workspace can no longer address them.      |

## What revocation does not do

* Revocation does **not** delete the connected Account, its Book, or its history.
* Revocation does **not** change the connected Account's own Clerk Organization or direct access.
* Revocation does **not** delete or modify Quotes, Commitments, or audit records owned by the connected Account.
* Revocation does **not** affect other workspaces that may have their own connections to the same Account.

## If it does not work

<Accordion>
  <AccordionItem title="Revoke connection button not visible">
    The Connection section only appears for organization admins. If you are a member, ask an admin to revoke the connection.
  </AccordionItem>

  <AccordionItem title="Connection has already been revoked">
    If the Account is no longer in the portfolio, the connection may have already been revoked. Revoked connections do not appear in the portfolio.
  </AccordionItem>

  <AccordionItem title="Confirm revoke fails">
    If the request fails, the connection may have changed since you loaded the page (for example, another admin already revoked it). The revocation uses an optimistic row version to prevent stale confirmations. Refresh the portfolio and check the Account's status.
  </AccordionItem>
</Accordion>

## Next

<CardGroup cols={2}>
  <Card title="Monitor connected Accounts" icon="layout-grid" href="/accounts/monitor-connected-accounts">
    Inspect readiness and status across the portfolio.
  </Card>

  <Card title="Connect an existing Account" icon="link" href="/accounts/connect-an-existing-account">
    Connect a different Account when you are ready.
  </Card>
</CardGroup>