Hanzo AI
OpenapiProvider

List providers

Lists the USER-plane provider cards. It is not the org catalog at /v1/provider and the two are not a duplicate of one another: a provider declares its…

GET /v1/connection/providers

Addresshttps://api.hanzo.ai/v1/connection/providers
MethodGET
Operationget_connection_providers
AuthAuthorization: Bearer $HANZO_API_KEY

Lists the USER-plane provider cards. It is not the org catalog at /v1/provider and the two are not a duplicate of one another: a provider declares its custody plane, and the planes are disjoint, so a user-scoped provider 404s on the org surface and vice versa. Hence the catalog of what a user can connect, and how. Modes derive from capabilities (Device/Adopt/Verify — Mount asserts at least one), never from a parallel kind enum.

Request

GET /v1/connection/providers takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200provider.userCatalogOutok
defaultproblem-detailsrefused

200 body — 18 fields.

FieldInTypeAlwaysDescription
providersbodyprovider.providerView[]Providers is every USER-scoped provider, sorted by id.
providers[].availablebodybooleanAvailable is whether THIS DEPLOYMENT has the provider's app credentials, so connect can succeed.
providers[].categorybodystringCategory groups the card ("Communication", "Developer", "Marketing").
providers[].connectedbodybooleanConnected is whether this org has a live connection to the provider.
providers[].connectionbodyprovider.connectionView
providers[].connection.accountbodystringAccount is the human label of the connected third-party account (the Slack team name, the GitHub org login).
providers[].connection.connectedAtbodystringConnectedAt is when the connection was last (re)established, RFC 3339 UTC.
providers[].connection.expiresAtbodystringExpiresAt is when the access token expires, RFC 3339 UTC; empty for a credential that does not expire.
providers[].connection.externalIdbodystringExternalID is the provider's own id for the account (Slack team.id, GitHub installation_id) — the value inbound webhooks are mapped back to this org by.
providers[].connection.idbodystringID is provider + ":" + label, the address every connection route takes.
providers[].connection.labelbodystringLabel is the caller's own name for this connection ("default", "work").
providers[].connection.providerbodystringProvider is the connected provider's registry id.
providers[].connection.scopesbodystring[]Scopes are the permissions the provider granted.
providers[].descriptionbodystringDescription is the one-line pitch the console card shows.
providers[].idbodystringID is the provider's registry id and the :provider path segment ("slack").
providers[].modesbodystring[]Modes are the ways this provider can be connected, derived from what it actually declares — "managed", "oauth", "apikey", "device", "mcp".
providers[].namebodystringName is the provider's display name ("Slack").
providers[].scopesbodystring[]Scopes are the permissions a connection will ask for.

Failure carries the platform error shape — see Errors.

Examples

hanzo connection providers

Provider API · All Hanzo APIs · Interactive reference

How is this guide?

On this page