Files
zeekayandHanzo Dev b55332704a feat: Hanzo Cloud SDK for Kotlin (generated from OpenAPI v8.0.0)
Coroutine-native client covering the full Hanzo /v1 cloud surface, for JVM and
Android. Generated with openapi-generator kotlin (library=jvm-okhttp4,
useCoroutines=true). Coordinate: ai.hanzo:sdk. Base URL: https://api.hanzo.ai.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-25 07:10:32 -07:00

18 KiB

OAuthApi

All URIs are relative to https://api.hanzo.ai

Method HTTP request Description
chatGetOauthApple GET /oauth/apple Initiate Apple OAuth
chatGetOauthDiscord GET /oauth/discord Initiate Discord OAuth
chatGetOauthDiscordCallback GET /oauth/discord/callback Discord OAuth callback
chatGetOauthError GET /oauth/error OAuth error handler
chatGetOauthFacebook GET /oauth/facebook Initiate Facebook OAuth
chatGetOauthFacebookCallback GET /oauth/facebook/callback Facebook OAuth callback
chatGetOauthGithub GET /oauth/github Initiate GitHub OAuth
chatGetOauthGithubCallback GET /oauth/github/callback GitHub OAuth callback
chatGetOauthGoogle GET /oauth/google Initiate Google OAuth
chatGetOauthGoogleCallback GET /oauth/google/callback Google OAuth callback
chatGetOauthOpenid GET /oauth/openid Initiate OpenID Connect login
chatGetOauthOpenidCallback GET /oauth/openid/callback OpenID Connect callback
chatGetOauthSaml GET /oauth/saml Initiate SAML login
chatPostOauthAppleCallback POST /oauth/apple/callback Apple OAuth callback
chatPostOauthSamlCallback POST /oauth/saml/callback SAML callback
integrationsConnectProvider POST /v1/integrations/{provider}/connect Begin an OAuth flow (returns the provider authorize URL)
integrationsDisconnectProvider POST /v1/integrations/{provider}/disconnect Revoke and forget an org's connection (idempotent)
integrationsProviderCallback GET /v1/integrations/{provider}/callback OAuth return — seal tokens and redirect to console

chatGetOauthApple

chatGetOauthApple()

Initiate Apple OAuth

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthApple()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthApple")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthApple")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthDiscord

chatGetOauthDiscord()

Initiate Discord OAuth

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthDiscord()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthDiscord")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthDiscord")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthDiscordCallback

chatGetOauthDiscordCallback()

Discord OAuth callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthDiscordCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthDiscordCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthDiscordCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthError

chatGetOauthError()

OAuth error handler

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthError()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthError")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthError")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthFacebook

chatGetOauthFacebook()

Initiate Facebook OAuth

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthFacebook()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthFacebook")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthFacebook")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthFacebookCallback

chatGetOauthFacebookCallback()

Facebook OAuth callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthFacebookCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthFacebookCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthFacebookCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthGithub

chatGetOauthGithub()

Initiate GitHub OAuth

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthGithub()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthGithub")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthGithub")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthGithubCallback

chatGetOauthGithubCallback()

GitHub OAuth callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthGithubCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthGithubCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthGithubCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthGoogle

chatGetOauthGoogle()

Initiate Google OAuth

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthGoogle()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthGoogle")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthGoogle")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthGoogleCallback

chatGetOauthGoogleCallback()

Google OAuth callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthGoogleCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthGoogleCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthGoogleCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthOpenid

chatGetOauthOpenid()

Initiate OpenID Connect login

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthOpenid()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthOpenid")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthOpenid")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthOpenidCallback

chatGetOauthOpenidCallback()

OpenID Connect callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthOpenidCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthOpenidCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthOpenidCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatGetOauthSaml

chatGetOauthSaml()

Initiate SAML login

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatGetOauthSaml()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatGetOauthSaml")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatGetOauthSaml")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatPostOauthAppleCallback

chatPostOauthAppleCallback()

Apple OAuth callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatPostOauthAppleCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatPostOauthAppleCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatPostOauthAppleCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

chatPostOauthSamlCallback

chatPostOauthSamlCallback()

SAML callback

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
try {
    apiInstance.chatPostOauthSamlCallback()
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#chatPostOauthSamlCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#chatPostOauthSamlCallback")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

integrationsConnectProvider

IntegrationsConnectProvider200Response integrationsConnectProvider(provider)

Begin an OAuth flow (returns the provider authorize URL)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
val provider : kotlin.String = provider_example // kotlin.String | 
try {
    val result : IntegrationsConnectProvider200Response = apiInstance.integrationsConnectProvider(provider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#integrationsConnectProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#integrationsConnectProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
provider kotlin.String

Return type

IntegrationsConnectProvider200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

integrationsDisconnectProvider

IntegrationsDisconnectProvider200Response integrationsDisconnectProvider(provider)

Revoke and forget an org's connection (idempotent)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
val provider : kotlin.String = provider_example // kotlin.String | 
try {
    val result : IntegrationsDisconnectProvider200Response = apiInstance.integrationsDisconnectProvider(provider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#integrationsDisconnectProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#integrationsDisconnectProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
provider kotlin.String

Return type

IntegrationsDisconnectProvider200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

integrationsProviderCallback

integrationsProviderCallback(provider, state, code, error)

OAuth return — seal tokens and redirect to console

Public, state-authed. The org comes only from the signed, single-use state. Always 302s back to the console (success or labeled failure).

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = OAuthApi()
val provider : kotlin.String = provider_example // kotlin.String | 
val state : kotlin.String = state_example // kotlin.String | 
val code : kotlin.String = code_example // kotlin.String | 
val error : kotlin.String = error_example // kotlin.String | 
try {
    apiInstance.integrationsProviderCallback(provider, state, code, error)
} catch (e: ClientException) {
    println("4xx response calling OAuthApi#integrationsProviderCallback")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling OAuthApi#integrationsProviderCallback")
    e.printStackTrace()
}

Parameters

| provider | kotlin.String| | | | state | kotlin.String| | | | code | kotlin.String| | [optional] |

Name Type Description Notes
error kotlin.String [optional]

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined