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

14 KiB

FilesApi

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

Method HTTP request Description
chatDeleteFiles DELETE /v1/chat/files Delete files
chatGetFiles GET /v1/chat/files List user files
chatGetFilesAgentByagentId GET /v1/chat/files/agent/{agent_id} Get files for an agent
chatGetFilesCodeDownloadBysessionIdByfileid GET /v1/chat/files/code/download/{session_id}/{fileId} Download code execution output
chatGetFilesConfig GET /v1/chat/files/config Get file upload configuration
chatGetFilesDownloadByuseridByfileId GET /v1/chat/files/download/{userId}/{file_id} Download a file
chatPostFiles POST /v1/chat/files Upload a file
execDownloadFile GET /v1/download/{id} Download a produced file by id
execListSessionFiles GET /v1/files/{session_id} List the files produced in a session
execUploadFile POST /v1/upload Upload a file into a session

chatDeleteFiles

kotlin.Any chatDeleteFiles(chatDeleteFilesRequest)

Delete files

Example

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

val apiInstance = FilesApi()
val chatDeleteFilesRequest : ChatDeleteFilesRequest =  // ChatDeleteFilesRequest | 
try {
    val result : kotlin.Any = apiInstance.chatDeleteFiles(chatDeleteFilesRequest)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatDeleteFiles")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatDeleteFiles")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
chatDeleteFilesRequest ChatDeleteFilesRequest

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

chatGetFiles

kotlin.collections.List<ChatFile> chatGetFiles()

List user files

Example

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

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

Parameters

This endpoint does not need any parameter.

Return type

kotlin.collections.List<ChatFile>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetFilesAgentByagentId

kotlin.collections.List<ChatFile> chatGetFilesAgentByagentId(agentId)

Get files for an agent

Example

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

val apiInstance = FilesApi()
val agentId : kotlin.String = agentId_example // kotlin.String | 
try {
    val result : kotlin.collections.List<ChatFile> = apiInstance.chatGetFilesAgentByagentId(agentId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatGetFilesAgentByagentId")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatGetFilesAgentByagentId")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
agentId kotlin.String

Return type

kotlin.collections.List<ChatFile>

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

chatGetFilesCodeDownloadBysessionIdByfileid

java.io.File chatGetFilesCodeDownloadBysessionIdByfileid(sessionId, fileId)

Download code execution output

Example

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

val apiInstance = FilesApi()
val sessionId : kotlin.String = sessionId_example // kotlin.String | 
val fileId : kotlin.String = fileId_example // kotlin.String | 
try {
    val result : java.io.File = apiInstance.chatGetFilesCodeDownloadBysessionIdByfileid(sessionId, fileId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatGetFilesCodeDownloadBysessionIdByfileid")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatGetFilesCodeDownloadBysessionIdByfileid")
    e.printStackTrace()
}

Parameters

| sessionId | kotlin.String| | |

Name Type Description Notes
fileId kotlin.String

Return type

java.io.File

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/octet-stream

chatGetFilesConfig

kotlin.Any chatGetFilesConfig()

Get file upload configuration

Example

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

val apiInstance = FilesApi()
try {
    val result : kotlin.Any = apiInstance.chatGetFilesConfig()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatGetFilesConfig")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatGetFilesConfig")
    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

chatGetFilesDownloadByuseridByfileId

java.io.File chatGetFilesDownloadByuseridByfileId(userId, fileId)

Download a file

Example

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

val apiInstance = FilesApi()
val userId : kotlin.String = userId_example // kotlin.String | 
val fileId : kotlin.String = fileId_example // kotlin.String | 
try {
    val result : java.io.File = apiInstance.chatGetFilesDownloadByuseridByfileId(userId, fileId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatGetFilesDownloadByuseridByfileId")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatGetFilesDownloadByuseridByfileId")
    e.printStackTrace()
}

Parameters

| userId | kotlin.String| | |

Name Type Description Notes
fileId kotlin.String

Return type

java.io.File

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/octet-stream

chatPostFiles

ChatFile chatPostFiles(file, fileId, endpoint, agentId, toolResource, messageFile)

Upload a file

Example

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

val apiInstance = FilesApi()
val file : java.io.File = BINARY_DATA_HERE // java.io.File | 
val fileId : kotlin.String = fileId_example // kotlin.String | 
val endpoint : kotlin.String = endpoint_example // kotlin.String | 
val agentId : kotlin.String = agentId_example // kotlin.String | 
val toolResource : kotlin.String = toolResource_example // kotlin.String | 
val messageFile : kotlin.String = messageFile_example // kotlin.String | 
try {
    val result : ChatFile = apiInstance.chatPostFiles(file, fileId, endpoint, agentId, toolResource, messageFile)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#chatPostFiles")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#chatPostFiles")
    e.printStackTrace()
}

Parameters

| file | java.io.File| | | | fileId | kotlin.String| | [optional] | | endpoint | kotlin.String| | [optional] | | agentId | kotlin.String| | [optional] | | toolResource | kotlin.String| | [optional] |

Name Type Description Notes
messageFile kotlin.String [optional]

Return type

ChatFile

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

execDownloadFile

java.io.File execDownloadFile(id)

Download a produced file by id

Example

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

val apiInstance = FilesApi()
val id : kotlin.String = id_example // kotlin.String | 
try {
    val result : java.io.File = apiInstance.execDownloadFile(id)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#execDownloadFile")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#execDownloadFile")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
id kotlin.String

Return type

java.io.File

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/octet-stream, application/json

execListSessionFiles

ExecListSessionFiles200Response execListSessionFiles(sessionId)

List the files produced in a session

Example

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

val apiInstance = FilesApi()
val sessionId : kotlin.String = sessionId_example // kotlin.String | 
try {
    val result : ExecListSessionFiles200Response = apiInstance.execListSessionFiles(sessionId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#execListSessionFiles")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#execListSessionFiles")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
sessionId kotlin.String

Return type

ExecListSessionFiles200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

execUploadFile

ExecUploadFile200Response execUploadFile(file, sessionId)

Upload a file into a session

Example

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

val apiInstance = FilesApi()
val file : java.io.File = BINARY_DATA_HERE // java.io.File | 
val sessionId : kotlin.String = sessionId_example // kotlin.String | 
try {
    val result : ExecUploadFile200Response = apiInstance.execUploadFile(file, sessionId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling FilesApi#execUploadFile")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling FilesApi#execUploadFile")
    e.printStackTrace()
}

Parameters

| file | java.io.File| | [optional] |

Name Type Description Notes
sessionId kotlin.String [optional]

Return type

ExecUploadFile200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json