> For the complete documentation index, see [llms.txt](https://docs.khotan.com/llms.txt). A markdown version of any page is available at its `index.md` URL.

# Integrations

Use the `khotan` CLI to operate Khotan integrations. Add `--json` for machine-readable output; results go to stdout, diagnostics to stderr.

## Commands

### khotan integrations connect

Usage: `khotan integrations connect [--provider <string>]`

Begin a mailbox connection and return a URL a human opens in a browser to authorize (OAuth consent cannot be completed headlessly).

Arguments & options:
- `--provider` — The provider to connect. Defaults to google. (optional, body)

### khotan integrations delete

Usage: `khotan integrations delete <integrationId>`

Permanently disconnect a mailbox integration (revokes the stored credentials).

Arguments & options:
- `<integrationId>` — The integration id. (required, path)

Safety: destructive — prompts for confirmation in a terminal and refuses in non-interactive sessions unless you pass `--yes`.

### khotan integrations get

Usage: `khotan integrations get <integrationId>`

Get one integration by id (no token material).

Arguments & options:
- `<integrationId>` — The integration id. (required, path)

### khotan integrations list

Usage: `khotan integrations list`

List the organization's connected mailbox integrations (no token material).

### khotan integrations rename

Usage: `khotan integrations rename <integrationId> --name <string>`

Set an integration's display name. Pass an empty value to clear it.

Arguments & options:
- `<integrationId>` — The integration id. (required, path)
- `--name` — The display name (empty to clear). (required, body)

### khotan integrations token

Usage: `khotan integrations token <integrationId>`

Mint a fresh OAuth access token for the integration so a service can call the provider on the user's behalf. Secret-bearing; explicit-only.

Arguments & options:
- `<integrationId>` — The integration id. (required, path)

Safety: secret — returns credential-bearing values; never shown in list/table output.

<!-- generated from khotan catalog v2026-10-30 (adapter 0.10.0); do not edit by hand -->
