Hanzo
OpenapiAi

Begins an OAuth connection for the caller's org: it binds the org into a signed…

Begins an OAuth connection for the caller's org: it binds the org into a signed state and sends the caller to the provider's authorize URL.

GET /v1/ai/connections/{provider}/authorize

Addresshttps://api.hanzo.ai/v1/ai/connections/{provider}/authorize
MethodGET
Operationget_ai_connections_by_provider_authorize
AuthAuthorization: Bearer $HANZO_API_KEY

Begins an OAuth connection for the caller's org: it binds the org into a signed state and sends the caller to the provider's authorize URL. By default it 302-redirects (a top-level browser "connect your login" click); a SPA/BFF that needs to drive the redirect itself passes ?format=json and gets {authorizeUrl} in the standard envelope. The org is the VERIFIED principal, so only the caller's own connection can result.

Request

1 field.

FieldInTypeRequiredDescription
providerpathstringyes

Response

The document declares no response body for this operation. It answers 200 on success and the platform error shape on failure — see Errors.

Examples

hanzo ai connections authorize <provider>

AI API · All Hanzo APIs · Interactive reference

How is this guide?

On this page