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

# apiKeys.revoke()

> Revoke a Mesa API key by ID.

Revoke an API key. Revocation is irreversible.

**Required scope: `admin`**

```ts theme={null}
await mesa.apiKeys.revoke({ id: 'key_123' });
```

## Options

<ParamField path="id" type="string" required>
  API key ID.
</ParamField>

<ParamField path="org" type="string | undefined">
  Organization override.
</ParamField>

## Response

<ResponseField name="success" type="true">
  Whether the operation succeeded.
</ResponseField>