Hanzo AI

Provider

The `hanzo connection` commands.

Also for this capability: API · CLI · SDKs

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

API reference →

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.

CommandWhat it does
hanzo connection listLists the caller's OWN connectors across every provider — the set hanzo connector ls prints.
hanzo connection providersLists the USER-plane provider cards.
hanzo provider listReturns every registered integration provider together with THIS org's connection status for it — the catalog the…

callback

CommandWhat it does
hanzo provider callback <provider>OAuth return for any connector

connect

CommandWhat it does
hanzo provider connect <provider>Acquires the org's credential for one provider.

credential

CommandWhat it does
hanzo connection credential <provider>Is the direct intake path: a customer-held token/setup-token (Verify) or an externally obtained OAuth bundle from the…

device

CommandWhat 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.

disconnect

CommandWhat it does
hanzo provider disconnect <provider>Revokes (best-effort) and forgets an org's connection: it deletes every custodied KMS secret and the connection row.

discord

CommandWhat it does
hanzo provider discord interactionsDiscord interactions endpoint
hanzo provider discord link callbackComplete the Discord account link
hanzo provider discord link discordDiscord sign-in return leg
hanzo provider discord link getBegin linking a Hanzo account from Discord

forge

CommandWhat it does
hanzo provider forge webhookForge workflow_job webhook

get

CommandWhat it does
hanzo provider get <provider>Returns ONE provider with this org's connection status — the same view list carries, for a single id.

github

CommandWhat it does
hanzo provider github claimBinds installations the App ALREADY holds to the org the caller is acting in — the reconciliation for a grant that…
hanzo provider github forkForks a granted repository.
hanzo provider github installationsLists the GitHub accounts the caller may see the App installed on, each confirmed against the App's own list, plus…
hanzo provider github issues backfillSeeds the native todo with the EXISTING issues across the org's granted repos (default state=open); the webhook keeps…
hanzo provider github repos importImports the selected (or all) granted repos into git.hanzo.ai.
hanzo provider github repos listLists the org's granted GitHub repositories, each annotated with its native import + sync status from the git object…
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 searchFinds repositories on GitHub.
hanzo provider github webhookGitHub App webhook

gitlab

CommandWhat it does
hanzo provider gitlab projectsLists the projects the org's GitLab connection can reach — membership projects, most recently active first.

linear

CommandWhat it does
hanzo provider linear claimBinds the caller's Linear organization to the org and seals the webhook secret.
hanzo provider linear commentsPosts a comment on a Linear issue with the caller's own key, so it carries their name.
hanzo provider linear issues backfillSeeds the native todo with the EXISTING Linear issues the caller's key can see (default state=open); the webhook keeps…
hanzo provider linear webhookLinear webhook

openrouter

CommandWhat it does
hanzo provider openrouter webhookReceive OpenRouter Broadcast traces as usage rows

refresh

CommandWhat it does
hanzo connection refresh <id>Forces a token rotation for a connected connector, ahead of the automatic rotation a token read would do inside the…

rm

CommandWhat it does
hanzo connection rm <id>Forgets a connector: every custodied secret, then the row.

slack

CommandWhat it does
hanzo provider slack channelsLists Slack conversations for the caller's connected workspace.
hanzo provider slack commandsSlack slash command webhook
hanzo provider slack eventsSlack Events API webhook
hanzo provider slack fileRead one Slack file's bytes.
hanzo provider slack installInstall the Hanzo app into a Slack workspace
hanzo provider slack joinJoins every public channel in the caller org's workspace.
hanzo provider slack link callbackComplete the Slack account link
hanzo provider slack link getBegin linking a Hanzo account from Slack
hanzo provider slack link slackSlack sign-in return leg
hanzo provider slack messages clearTakes back one of this app's messages: DELETE /v1/provider/slack/messages.
hanzo provider slack messages createPosts as Hanzo to the caller's connected Slack workspace.
hanzo provider slack messages getReads recent messages from a named Slack channel such as #hanzo-gtm.
hanzo provider slack messages replaceRewrites one of this app's messages: PUT /v1/provider/slack/messages.
hanzo provider slack reactionsAdds an emoji reaction: POST /v1/provider/slack/reactions.
hanzo provider slack searchAnswers a workspace question: POST /v1/provider/slack/search.

teams

CommandWhat it does
hanzo provider teams eventsMicrosoft Teams Bot Framework webhook
hanzo provider teams link aadMicrosoft sign-in return leg
hanzo provider teams link callbackComplete the Teams account link
hanzo provider teams link getBegin linking a Hanzo account from Teams

telegram

CommandWhat it does
hanzo provider telegram connectMints 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 authTelegram Login Widget return leg
hanzo provider telegram link callbackComplete the Telegram account link
hanzo provider telegram link getBegin linking a Hanzo account from Telegram
hanzo provider telegram webhookTelegram Bot API webhook

token

CommandWhat it does
hanzo connection token <id>Hands the custodied access token to its owner — the ONE place custody exits.

verify

CommandWhat it does
hanzo provider verify <provider>Re-checks a CONNECTED apikey connector's stored credential against the provider, live (hanzo connector verify).

whatsapp

CommandWhat it does
hanzo provider whatsapp webhook createWhatsApp Cloud API webhook
hanzo provider whatsapp webhook getWhatsApp Cloud API subscription challenge

How is this guide?