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

11 KiB

AssistantsV2Api

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

Method HTTP request Description
chatDeleteAssistantsV2Byid DELETE /v1/chat/assistants/v2/{id} Delete an assistant (v2)
chatGetAssistantsV2 GET /v1/chat/assistants/v2 List assistants (v2)
chatGetAssistantsV2Byid GET /v1/chat/assistants/v2/{id} Retrieve an assistant (v2)
chatGetAssistantsV2Documents GET /v1/chat/assistants/v2/documents Get assistant documents (v2)
chatGetAssistantsV2Tools GET /v1/chat/assistants/v2/tools List available assistant tools (v2)
chatPatchAssistantsV2Byid PATCH /v1/chat/assistants/v2/{id} Modify an assistant (v2)
chatPostAssistantsV2 POST /v1/chat/assistants/v2 Create an assistant (v2)
chatPostAssistantsV2Chat POST /v1/chat/assistants/v2/chat Chat with an assistant (v2)
chatPostAssistantsV2ChatAbort POST /v1/chat/assistants/v2/chat/abort Abort assistant chat (v2)

chatDeleteAssistantsV2Byid

kotlin.Any chatDeleteAssistantsV2Byid(id)

Delete an assistant (v2)

Example

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

val apiInstance = AssistantsV2Api()
val id : kotlin.String = id_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.chatDeleteAssistantsV2Byid(id)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatDeleteAssistantsV2Byid")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatDeleteAssistantsV2Byid")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
id kotlin.String

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetAssistantsV2

kotlin.Any chatGetAssistantsV2()

List assistants (v2)

Example

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

val apiInstance = AssistantsV2Api()
try {
    val result : kotlin.Any = apiInstance.chatGetAssistantsV2()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatGetAssistantsV2")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatGetAssistantsV2")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetAssistantsV2Byid

kotlin.Any chatGetAssistantsV2Byid(id)

Retrieve an assistant (v2)

Example

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

val apiInstance = AssistantsV2Api()
val id : kotlin.String = id_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.chatGetAssistantsV2Byid(id)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatGetAssistantsV2Byid")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatGetAssistantsV2Byid")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
id kotlin.String

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetAssistantsV2Documents

kotlin.Any chatGetAssistantsV2Documents()

Get assistant documents (v2)

Example

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

val apiInstance = AssistantsV2Api()
try {
    val result : kotlin.Any = apiInstance.chatGetAssistantsV2Documents()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatGetAssistantsV2Documents")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatGetAssistantsV2Documents")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetAssistantsV2Tools

kotlin.Any chatGetAssistantsV2Tools()

List available assistant tools (v2)

Example

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

val apiInstance = AssistantsV2Api()
try {
    val result : kotlin.Any = apiInstance.chatGetAssistantsV2Tools()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatGetAssistantsV2Tools")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatGetAssistantsV2Tools")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatPatchAssistantsV2Byid

kotlin.Any chatPatchAssistantsV2Byid(id, body)

Modify an assistant (v2)

Example

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

val apiInstance = AssistantsV2Api()
val id : kotlin.String = id_example // kotlin.String | 
val body : kotlin.Any = Object // kotlin.Any | 
try {
    val result : kotlin.Any = apiInstance.chatPatchAssistantsV2Byid(id, body)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatPatchAssistantsV2Byid")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatPatchAssistantsV2Byid")
    e.printStackTrace()
}

Parameters

| id | kotlin.String| | |

Name Type Description Notes
body kotlin.Any

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatPostAssistantsV2

kotlin.Any chatPostAssistantsV2(body)

Create an assistant (v2)

Example

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

val apiInstance = AssistantsV2Api()
val body : kotlin.Any = Object // kotlin.Any | 
try {
    val result : kotlin.Any = apiInstance.chatPostAssistantsV2(body)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatPostAssistantsV2")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatPostAssistantsV2")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
body kotlin.Any

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatPostAssistantsV2Chat

kotlin.String chatPostAssistantsV2Chat(body)

Chat with an assistant (v2)

Example

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

val apiInstance = AssistantsV2Api()
val body : kotlin.Any = Object // kotlin.Any | 
try {
    val result : kotlin.String = apiInstance.chatPostAssistantsV2Chat(body)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatPostAssistantsV2Chat")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatPostAssistantsV2Chat")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
body kotlin.Any

Return type

kotlin.String

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatPostAssistantsV2ChatAbort

kotlin.Any chatPostAssistantsV2ChatAbort()

Abort assistant chat (v2)

Example

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

val apiInstance = AssistantsV2Api()
try {
    val result : kotlin.Any = apiInstance.chatPostAssistantsV2ChatAbort()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling AssistantsV2Api#chatPostAssistantsV2ChatAbort")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling AssistantsV2Api#chatPostAssistantsV2ChatAbort")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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