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

6.1 KiB

IdentityResolutionApi

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

Method HTTP request Description
didLinkIdentity POST /v1/did/profiles/{profile_id}/identities Link an external identity
didListLinkedIdentities GET /v1/did/profiles/{profile_id}/identities List linked identities
didResolveIdentity GET /v1/did/resolve Resolve identity across providers
didUnlinkIdentity DELETE /v1/did/profiles/{profile_id}/identities/{provider} Unlink an external identity

didLinkIdentity

DidLinkedIdentity didLinkIdentity(profileId, didLinkIdentityRequest)

Link an external identity

Example

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

val apiInstance = IdentityResolutionApi()
val profileId : kotlin.String = profileId_example // kotlin.String | 
val didLinkIdentityRequest : DidLinkIdentityRequest =  // DidLinkIdentityRequest | 
try {
    val result : DidLinkedIdentity = apiInstance.didLinkIdentity(profileId, didLinkIdentityRequest)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling IdentityResolutionApi#didLinkIdentity")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling IdentityResolutionApi#didLinkIdentity")
    e.printStackTrace()
}

Parameters

| profileId | kotlin.String| | |

Name Type Description Notes
didLinkIdentityRequest DidLinkIdentityRequest

Return type

DidLinkedIdentity

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

didListLinkedIdentities

DidListLinkedIdentities200Response didListLinkedIdentities(profileId)

List linked identities

Example

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

val apiInstance = IdentityResolutionApi()
val profileId : kotlin.String = profileId_example // kotlin.String | 
try {
    val result : DidListLinkedIdentities200Response = apiInstance.didListLinkedIdentities(profileId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling IdentityResolutionApi#didListLinkedIdentities")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling IdentityResolutionApi#didListLinkedIdentities")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
profileId kotlin.String

Return type

DidListLinkedIdentities200Response

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

didResolveIdentity

DidProfile didResolveIdentity(provider, externalId)

Resolve identity across providers

Find a Hanzo profile by external provider identity.

Example

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

val apiInstance = IdentityResolutionApi()
val provider : kotlin.String = provider_example // kotlin.String | 
val externalId : kotlin.String = externalId_example // kotlin.String | 
try {
    val result : DidProfile = apiInstance.didResolveIdentity(provider, externalId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling IdentityResolutionApi#didResolveIdentity")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling IdentityResolutionApi#didResolveIdentity")
    e.printStackTrace()
}

Parameters

| provider | kotlin.String| | |

Name Type Description Notes
externalId kotlin.String

Return type

DidProfile

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

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

didUnlinkIdentity

didUnlinkIdentity(profileId, provider)

Unlink an external identity

Example

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

val apiInstance = IdentityResolutionApi()
val profileId : kotlin.String = profileId_example // kotlin.String | 
val provider : kotlin.String = provider_example // kotlin.String | 
try {
    apiInstance.didUnlinkIdentity(profileId, provider)
} catch (e: ClientException) {
    println("4xx response calling IdentityResolutionApi#didUnlinkIdentity")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling IdentityResolutionApi#didUnlinkIdentity")
    e.printStackTrace()
}

Parameters

| profileId | kotlin.String| | |

Name Type Description Notes
provider 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