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

5.4 KiB

TopicsApi

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

Method HTTP request Description
streamCreateTopic POST /v1/stream/topics Create a topic
streamDeleteTopic DELETE /v1/stream/topics/{topic} Delete a topic
streamGetTopicMetadata GET /v1/stream/topics/{topic} Get topic metadata
streamListTopics GET /v1/stream/topics List topics

streamCreateTopic

StreamTopic streamCreateTopic(streamCreateTopicRequest)

Create a topic

Create a new Kafka topic. Under the hood, this creates one PubSub JetStream stream per partition.

Example

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

val apiInstance = TopicsApi()
val streamCreateTopicRequest : StreamCreateTopicRequest = {"name":"events","partitions":3,"replication_factor":1} // StreamCreateTopicRequest | 
try {
    val result : StreamTopic = apiInstance.streamCreateTopic(streamCreateTopicRequest)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling TopicsApi#streamCreateTopic")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling TopicsApi#streamCreateTopic")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
streamCreateTopicRequest StreamCreateTopicRequest

Return type

StreamTopic

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

streamDeleteTopic

streamDeleteTopic(topic)

Delete a topic

Delete a topic and all associated JetStream streams.

Example

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

val apiInstance = TopicsApi()
val topic : kotlin.String = topic_example // kotlin.String | 
try {
    apiInstance.streamDeleteTopic(topic)
} catch (e: ClientException) {
    println("4xx response calling TopicsApi#streamDeleteTopic")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling TopicsApi#streamDeleteTopic")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
topic kotlin.String

Return type

null (empty response body)

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

streamGetTopicMetadata

StreamTopicMetadata streamGetTopicMetadata(topic)

Get topic metadata

Returns topic configuration and partition details.

Example

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

val apiInstance = TopicsApi()
val topic : kotlin.String = topic_example // kotlin.String | 
try {
    val result : StreamTopicMetadata = apiInstance.streamGetTopicMetadata(topic)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling TopicsApi#streamGetTopicMetadata")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling TopicsApi#streamGetTopicMetadata")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
topic kotlin.String

Return type

StreamTopicMetadata

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

streamListTopics

StreamListTopics200Response streamListTopics()

List topics

List all Kafka topics managed by Hanzo Stream.

Example

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

val apiInstance = TopicsApi()
try {
    val result : StreamListTopics200Response = apiInstance.streamListTopics()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling TopicsApi#streamListTopics")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling TopicsApi#streamListTopics")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

StreamListTopics200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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