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 →
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 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…
Command What it does hanzo provider callback <provider>OAuth return for any connector
Command What it does hanzo provider connect <provider>Acquires the org's credential for one provider.
Command What 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…
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.
Command What 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.
Command What 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
Command What it does hanzo provider forge webhookForge workflow_job webhook
Command What it does hanzo provider get <provider>Returns ONE provider with this org's connection status — the same view list carries, for a single id.
Command What 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
Command What it does hanzo provider gitlab projectsLists the projects the org's GitLab connection can reach — membership projects, most recently active first.
Command What 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
Command What it does hanzo provider openrouter webhookReceive OpenRouter Broadcast traces as usage rows
Command What 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…
Command What it does hanzo connection rm <id>Forgets a connector: every custodied secret, then the row.
Command What 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.
Command What 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
Command What 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
Command What it does hanzo connection token <id>Hands the custodied access token to its owner — the ONE place custody exits.
Command What it does hanzo provider verify <provider>Re-checks a CONNECTED apikey connector's stored credential against the provider, live (hanzo connector verify).
Command What it does hanzo provider whatsapp webhook createWhatsApp Cloud API webhook hanzo provider whatsapp webhook getWhatsApp Cloud API subscription challenge
How is this guide?
Good Bad