Provider

The hanzo connection commands.

Also for this capability: API · CLI · MCP · SDKs

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

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

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

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

Was this page useful?

PreviousDestination NextO11y