Files
sdk/docs/ProviderAPIApi.md
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

20 KiB

ProviderAPIApi

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

Method HTTP request Description
cloudApiControllerAddProvider POST /v1/cloud/add-provider Api Controller Add Provider
cloudApiControllerDeleteProvider POST /v1/cloud/delete-provider Api Controller Delete Provider
cloudApiControllerGetGlobalProviders GET /v1/cloud/get-global-providers Api Controller Get Global Providers
cloudApiControllerGetProvider GET /v1/cloud/get-provider Api Controller Get Provider
cloudApiControllerGetProviders GET /v1/cloud/get-providers Api Controller Get Providers
cloudApiControllerRefreshMcpTools POST /v1/cloud/refresh-mcp-tools Api Controller Refresh Mcp Tools
cloudApiControllerUpdateProvider POST /v1/cloud/update-provider Api Controller Update Provider
nexusAddProvider POST /v1/nexus/add-provider add Provider
nexusDeleteProvider POST /v1/nexus/delete-provider delete Provider
nexusGetGlobalProviders GET /v1/nexus/get-global-providers get Global Providers
nexusGetProvider GET /v1/nexus/get-provider get Provider
nexusGetProviders GET /v1/nexus/get-providers get Providers
nexusRefreshMcpTools POST /v1/nexus/refresh-mcp-tools refresh Mcp Tools
nexusUpdateProvider POST /v1/nexus/update-provider update Provider

cloudApiControllerAddProvider

CloudControllersResponse cloudApiControllerAddProvider(cloudObjectProvider)

Api Controller Add Provider

add provider

Example

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

val apiInstance = ProviderAPIApi()
val cloudObjectProvider : CloudObjectProvider =  // CloudObjectProvider | The details of the provider
try {
    val result : CloudControllersResponse = apiInstance.cloudApiControllerAddProvider(cloudObjectProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerAddProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerAddProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
cloudObjectProvider CloudObjectProvider The details of the provider

Return type

CloudControllersResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerDeleteProvider

CloudControllersResponse cloudApiControllerDeleteProvider(cloudObjectProvider)

Api Controller Delete Provider

delete provider

Example

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

val apiInstance = ProviderAPIApi()
val cloudObjectProvider : CloudObjectProvider =  // CloudObjectProvider | The details of the provider
try {
    val result : CloudControllersResponse = apiInstance.cloudApiControllerDeleteProvider(cloudObjectProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerDeleteProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerDeleteProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
cloudObjectProvider CloudObjectProvider The details of the provider

Return type

CloudControllersResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerGetGlobalProviders

kotlin.collections.List<CloudObjectProvider> cloudApiControllerGetGlobalProviders()

Api Controller Get Global Providers

get global providers

Example

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

val apiInstance = ProviderAPIApi()
try {
    val result : kotlin.collections.List<CloudObjectProvider> = apiInstance.cloudApiControllerGetGlobalProviders()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerGetGlobalProviders")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerGetGlobalProviders")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.collections.List<CloudObjectProvider>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerGetProvider

CloudObjectProvider cloudApiControllerGetProvider(id)

Api Controller Get Provider

get provider

Example

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

val apiInstance = ProviderAPIApi()
val id : kotlin.String = id_example // kotlin.String | The id of provider
try {
    val result : CloudObjectProvider = apiInstance.cloudApiControllerGetProvider(id)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerGetProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerGetProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
id kotlin.String The id of provider

Return type

CloudObjectProvider

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerGetProviders

kotlin.collections.List<CloudObjectProvider> cloudApiControllerGetProviders()

Api Controller Get Providers

get providers

Example

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

val apiInstance = ProviderAPIApi()
try {
    val result : kotlin.collections.List<CloudObjectProvider> = apiInstance.cloudApiControllerGetProviders()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerGetProviders")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerGetProviders")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.collections.List<CloudObjectProvider>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerRefreshMcpTools

CloudControllersResponse cloudApiControllerRefreshMcpTools(cloudObjectProvider)

Api Controller Refresh Mcp Tools

refresh Mcp tools

Example

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

val apiInstance = ProviderAPIApi()
val cloudObjectProvider : CloudObjectProvider =  // CloudObjectProvider | The details of the provider
try {
    val result : CloudControllersResponse = apiInstance.cloudApiControllerRefreshMcpTools(cloudObjectProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerRefreshMcpTools")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerRefreshMcpTools")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
cloudObjectProvider CloudObjectProvider The details of the provider

Return type

CloudControllersResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

cloudApiControllerUpdateProvider

CloudControllersResponse cloudApiControllerUpdateProvider(id, cloudObjectProvider)

Api Controller Update Provider

update provider

Example

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

val apiInstance = ProviderAPIApi()
val id : kotlin.String = id_example // kotlin.String | The id (owner/name) of the provider
val cloudObjectProvider : CloudObjectProvider =  // CloudObjectProvider | The details of the provider
try {
    val result : CloudControllersResponse = apiInstance.cloudApiControllerUpdateProvider(id, cloudObjectProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#cloudApiControllerUpdateProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#cloudApiControllerUpdateProvider")
    e.printStackTrace()
}

Parameters

| id | kotlin.String| The id (owner/name) of the provider | |

Name Type Description Notes
cloudObjectProvider CloudObjectProvider The details of the provider

Return type

CloudControllersResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusAddProvider

NexusResponse nexusAddProvider(nexusProvider)

add Provider

Add a provider

Example

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

val apiInstance = ProviderAPIApi()
val nexusProvider : NexusProvider =  // NexusProvider | The details of the provider
try {
    val result : NexusResponse = apiInstance.nexusAddProvider(nexusProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusAddProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusAddProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
nexusProvider NexusProvider The details of the provider

Return type

NexusResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusDeleteProvider

NexusResponse nexusDeleteProvider(nexusProvider)

delete Provider

Delete a provider

Example

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

val apiInstance = ProviderAPIApi()
val nexusProvider : NexusProvider =  // NexusProvider | The details of the provider
try {
    val result : NexusResponse = apiInstance.nexusDeleteProvider(nexusProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusDeleteProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusDeleteProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
nexusProvider NexusProvider The details of the provider

Return type

NexusResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusGetGlobalProviders

kotlin.collections.List<NexusProvider> nexusGetGlobalProviders()

get Global Providers

Get global providers

Example

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

val apiInstance = ProviderAPIApi()
try {
    val result : kotlin.collections.List<NexusProvider> = apiInstance.nexusGetGlobalProviders()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusGetGlobalProviders")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusGetGlobalProviders")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.collections.List<NexusProvider>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusGetProvider

NexusProvider nexusGetProvider(id)

get Provider

Get a provider

Example

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

val apiInstance = ProviderAPIApi()
val id : kotlin.String = id_example // kotlin.String | The id of the provider
try {
    val result : NexusProvider = apiInstance.nexusGetProvider(id)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusGetProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusGetProvider")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
id kotlin.String The id of the provider

Return type

NexusProvider

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusGetProviders

kotlin.collections.List<NexusProvider> nexusGetProviders()

get Providers

Get providers

Example

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

val apiInstance = ProviderAPIApi()
try {
    val result : kotlin.collections.List<NexusProvider> = apiInstance.nexusGetProviders()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusGetProviders")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusGetProviders")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.collections.List<NexusProvider>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusRefreshMcpTools

NexusResponse nexusRefreshMcpTools(nexusProvider)

refresh Mcp Tools

Refresh MCP tools for a provider

Example

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

val apiInstance = ProviderAPIApi()
val nexusProvider : NexusProvider =  // NexusProvider | The details of the provider
try {
    val result : NexusResponse = apiInstance.nexusRefreshMcpTools(nexusProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusRefreshMcpTools")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusRefreshMcpTools")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
nexusProvider NexusProvider The details of the provider

Return type

NexusResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

nexusUpdateProvider

NexusResponse nexusUpdateProvider(id, nexusProvider)

update Provider

Update a provider

Example

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

val apiInstance = ProviderAPIApi()
val id : kotlin.String = id_example // kotlin.String | The id (owner/name) of the provider
val nexusProvider : NexusProvider =  // NexusProvider | The details of the provider
try {
    val result : NexusResponse = apiInstance.nexusUpdateProvider(id, nexusProvider)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling ProviderAPIApi#nexusUpdateProvider")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling ProviderAPIApi#nexusUpdateProvider")
    e.printStackTrace()
}

Parameters

| id | kotlin.String| The id (owner/name) of the provider | |

Name Type Description Notes
nexusProvider NexusProvider The details of the provider

Return type

NexusResponse

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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