# Provider

URL: https://docs.hanzo.ai/docs/cli/provider

> The `hanzo connection` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/provider) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/provider) · [SDKs](https://docs.hanzo.ai/docs/sdks)

How your org connects third-party accounts like Slack, and revokes them.

[API reference →](https://docs.hanzo.ai/docs/openapi/provider)

```bash
hanzo provider list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                                  | What it does                                                                                                                                           |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo connection credential <provider>` | The direct intake path: a customer-held token/setup-token (Verify) or an externally obtained OAuth bundle from the CLI's local PKCE (Adopt).           |
| `hanzo connection list`                  | Lists the caller's OWN connectors across every provider — the set `hanzo connector ls` prints.                                                         |
| `hanzo connection providers`             | Lists the USER-plane provider cards.                                                                                                                   |
| `hanzo connection refresh <id>`          | Forces a token rotation for a connected connector, ahead of the automatic rotation a token read would do inside the expiry window.                     |
| `hanzo connection rm <id>`               | Forgets a connector: every custodied secret, then the row.                                                                                             |
| `hanzo connection token <id>`            | Hands the custodied access token to its owner — the ONE place custody exits.                                                                           |
| `hanzo provider callback <provider>`     | OAuth return for any connector                                                                                                                         |
| `hanzo provider connect <provider>`      | Acquires the org's credential for one provider.                                                                                                        |
| `hanzo provider disconnect <provider>`   | Revokes (best-effort) and forgets an org's connection: it deletes every custodied KMS secret and the connection row.                                   |
| `hanzo provider get <provider>`          | Returns ONE provider with this org's connection status — the same view list carries, for a single id.                                                  |
| `hanzo provider list`                    | Returns every registered integration provider together with THIS org's connection status for it — the catalog the console's Integrations page renders. |
| `hanzo provider verify <provider>`       | Re-checks a CONNECTED apikey connector's stored credential against the provider, live (`hanzo connector verify`).                                      |

### Device

| Command                                          | What it does                                                                                   |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| `hanzo connection device create <provider>`      | Begins a device sign-in and returns the code to show the user plus how to poll for completion. |
| `hanzo connection device poll <provider> <flow>` | Advances a device sign-in.                                                                     |

### Discord

| Command                                | What it does                               |
| -------------------------------------- | ------------------------------------------ |
| `hanzo provider discord interactions`  | Discord interactions endpoint              |
| `hanzo provider discord link callback` | Complete the Discord account link          |
| `hanzo provider discord link discord`  | Discord sign-in return leg                 |
| `hanzo provider discord link get`      | Begin linking a Hanzo account from Discord |

### Forge

| Command                        | What it does                |
| ------------------------------ | --------------------------- |
| `hanzo provider forge webhook` | Forge workflow\_job webhook |

### GitHub

| Command                                            | What it does                                                                                                                                |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo provider github fork`                       | Forks a granted repository.                                                                                                                 |
| `hanzo provider github installations`              | Lists the GitHub accounts the caller may see the App installed on, each confirmed against the App's own list, plus where to add another.    |
| `hanzo provider github issues backfill`            | Seeds the native todo with the EXISTING issues across the org's granted repos (default state=open); the webhook keeps them live thereafter. |
| `hanzo provider github repos import`               | Imports the selected (or all) granted repos into git.hanzo.ai.                                                                              |
| `hanzo provider github repos list`                 | Lists the GitHub repositories the caller may work on, most recently pushed first, searched and paged on the server.                         |
| `hanzo provider github repos pages builds <repo>`  | Requests a Pages rebuild and returns the queued build's status.                                                                             |
| `hanzo provider github repos pages clear <repo>`   | Deletes the repo's Pages site.                                                                                                              |
| `hanzo provider github repos pages create <repo>`  | Creates the repo's Pages site and answers 201 Created with it.                                                                              |
| `hanzo provider github repos pages get <repo>`     | Returns the repo's Pages status, live URL, custom domain and build source.                                                                  |
| `hanzo provider github repos pages replace <repo>` | Sets or clears the custom domain (cname) and updates HTTPS enforcement, build type, or source.                                              |
| `hanzo provider github search`                     | Finds repositories on GitHub.                                                                                                               |
| `hanzo provider github webhook`                    | GitHub App webhook                                                                                                                          |

### GitLab

| Command                          | What it does                                                                                                |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `hanzo provider gitlab projects` | Lists the projects the org's GitLab connection can reach — membership projects, most recently active first. |

### Linear

| Command                                 | What it does                                                                                                                                 |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo provider linear claim`           | Binds the caller's Linear organization to the org and seals the webhook secret.                                                              |
| `hanzo provider linear comments`        | Posts a comment on a Linear issue with the caller's own key, so it carries their name.                                                       |
| `hanzo provider linear issues backfill` | Seeds the native todo with the EXISTING Linear issues the caller's key can see (default state=open); the webhook keeps them live thereafter. |
| `hanzo provider linear webhook`         | Linear webhook                                                                                                                               |

### OpenRouter

| Command                             | What it does                                      |
| ----------------------------------- | ------------------------------------------------- |
| `hanzo provider openrouter webhook` | Receive OpenRouter Broadcast traces as usage rows |

### Slack

| Command                                 | What it does                                                               |
| --------------------------------------- | -------------------------------------------------------------------------- |
| `hanzo provider slack channels`         | Lists Slack conversations for the caller's connected workspace.            |
| `hanzo provider slack commands`         | Slack slash command webhook                                                |
| `hanzo provider slack events`           | Slack Events API webhook                                                   |
| `hanzo provider slack file`             | Read one Slack file's bytes.                                               |
| `hanzo provider slack install`          | Install the Hanzo app into a Slack workspace                               |
| `hanzo provider slack join`             | Joins every public channel in the caller org's workspace.                  |
| `hanzo provider slack link callback`    | Complete the Slack account link                                            |
| `hanzo provider slack link get`         | Begin linking a Hanzo account from Slack                                   |
| `hanzo provider slack link slack`       | Slack sign-in return leg                                                   |
| `hanzo provider slack messages clear`   | Takes back one of this app's messages: DELETE /v1/provider/slack/messages. |
| `hanzo provider slack messages create`  | Posts as Hanzo to the caller's connected Slack workspace.                  |
| `hanzo provider slack messages get`     | Reads recent messages from a named Slack channel such as #hanzo-gtm.       |
| `hanzo provider slack messages replace` | Rewrites one of this app's messages: PUT /v1/provider/slack/messages.      |
| `hanzo provider slack reactions`        | Adds an emoji reaction: POST /v1/provider/slack/reactions.                 |
| `hanzo provider slack search`           | Answers a workspace question: POST /v1/provider/slack/search.              |

### Teams

| Command                              | What it does                             |
| ------------------------------------ | ---------------------------------------- |
| `hanzo provider teams events`        | Microsoft Teams Bot Framework webhook    |
| `hanzo provider teams link aad`      | Microsoft sign-in return leg             |
| `hanzo provider teams link callback` | Complete the Teams account link          |
| `hanzo provider teams link get`      | Begin linking a Hanzo account from Teams |

### Telegram

| Command                                 | What it does                                                                                                           |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `hanzo provider telegram connect`       | Mints a short, single-use deep-link code bound to the caller's org and returns the t.me link the console navigates to. |
| `hanzo provider telegram link auth`     | Telegram Login Widget return leg                                                                                       |
| `hanzo provider telegram link callback` | Complete the Telegram account link                                                                                     |
| `hanzo provider telegram link get`      | Begin linking a Hanzo account from Telegram                                                                            |
| `hanzo provider telegram webhook`       | Telegram Bot API webhook                                                                                               |

### WhatsApp

| Command                                  | What it does                              |
| ---------------------------------------- | ----------------------------------------- |
| `hanzo provider whatsapp webhook create` | WhatsApp Cloud API webhook                |
| `hanzo provider whatsapp webhook get`    | WhatsApp Cloud API subscription challenge |