Files
zeekay ac25f74c85 the module path carries /v8, so its tags are releases
Go's semantic import versioning gives a path without a /vN suffix exactly two
publishable major versions: v0 and v1. This client rides the shared 8.5.x line,
so at the bare path every tag it cut was unpublishable -- v8.5.89 and v8.5.156
both sat on the repo while proxy.golang.org served v1.0.5 and always would. A
tag the proxy rejects is not a release, it is a decoration.

The host half does NOT move. hanzoai/go-sdk is the path already on the proxy and
pkg.go.dev, and renaming it would strand every existing import; adding the
suffix does not, because v1 consumers keep resolving v1.0.5 at the old path.
That is what the suffix is for.

The generator writes the same path into 2,272 doc references, so sdks.yaml's
git-repo-id carries it too -- otherwise the next regeneration would tell readers
to import a path whose 8.x tags the proxy refuses. And the release workflow now
READS the path from go.mod instead of restating it: one spelling, in the file
that defines it, so the warm step cannot go on asking for a path nobody
publishes.
2026-08-28 11:17:09 -07:00

18 KiB

\DnsAPI

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

Method HTTP request Description
DeleteDnsZonesByZone Delete /v1/dns/zones/{zone} Delete a DNS zone
DeleteDnsZonesByZoneRecordsByRecord Delete /v1/dns/zones/{zone}/records/{record} Delete a DNS record
GetDnsHealth Get /v1/dns/health Check the DNS control plane
GetDnsZones Get /v1/dns/zones List your org's DNS zones
GetDnsZonesByZone Get /v1/dns/zones/{zone} Read one DNS zone
GetDnsZonesByZoneRecords Get /v1/dns/zones/{zone}/records List a zone's DNS records
GetDnsZonesByZoneRecordsByRecord Get /v1/dns/zones/{zone}/records/{record} Read one DNS record
PatchDnsZonesByZoneRecordsByRecord Patch /v1/dns/zones/{zone}/records/{record} Amend a DNS record
PostDnsSync Post /v1/dns/sync Push a set of zones and records in one call
PostDnsZones Post /v1/dns/zones Create a DNS zone
PostDnsZonesByZoneRecords Post /v1/dns/zones/{zone}/records Create a DNS record
PutDnsZonesByZoneRecordsByRecord Put /v1/dns/zones/{zone}/records/{record} Amend a DNS record

DeleteDnsZonesByZone

DeleteDnsZonesByZone(ctx, zone).Execute()

Delete a DNS zone

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.DeleteDnsZonesByZone(context.Background(), zone).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.DeleteDnsZonesByZone``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string

Other Parameters

Other parameters are passed through a pointer to a apiDeleteDnsZonesByZoneRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteDnsZonesByZoneRecordsByRecord

DeleteDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()

Delete a DNS record

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 
	record := "record_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.DeleteDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.DeleteDnsZonesByZoneRecordsByRecord``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string
record string

Other Parameters

Other parameters are passed through a pointer to a apiDeleteDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDnsHealth

GetDnsHealth(ctx).Execute()

Check the DNS control plane

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.GetDnsHealth(context.Background()).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsHealth``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

This endpoint does not need any parameter.

Other Parameters

Other parameters are passed through a pointer to a apiGetDnsHealthRequest struct via the builder pattern

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDnsZones

GetDnsZones(ctx).Execute()

List your org's DNS zones

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.GetDnsZones(context.Background()).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZones``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

This endpoint does not need any parameter.

Other Parameters

Other parameters are passed through a pointer to a apiGetDnsZonesRequest struct via the builder pattern

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDnsZonesByZone

GetDnsZonesByZone(ctx, zone).Execute()

Read one DNS zone

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.GetDnsZonesByZone(context.Background(), zone).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZone``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string

Other Parameters

Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDnsZonesByZoneRecords

GetDnsZonesByZoneRecords(ctx, zone).Execute()

List a zone's DNS records

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.GetDnsZonesByZoneRecords(context.Background(), zone).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZoneRecords``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string

Other Parameters

Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRecordsRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDnsZonesByZoneRecordsByRecord

GetDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()

Read one DNS record

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 
	record := "record_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.GetDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZoneRecordsByRecord``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string
record string

Other Parameters

Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PatchDnsZonesByZoneRecordsByRecord

PatchDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()

Amend a DNS record

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 
	record := "record_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.PatchDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PatchDnsZonesByZoneRecordsByRecord``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string
record string

Other Parameters

Other parameters are passed through a pointer to a apiPatchDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostDnsSync

PostDnsSync(ctx).Execute()

Push a set of zones and records in one call

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.PostDnsSync(context.Background()).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsSync``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

This endpoint does not need any parameter.

Other Parameters

Other parameters are passed through a pointer to a apiPostDnsSyncRequest struct via the builder pattern

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostDnsZones

PostDnsZones(ctx).Execute()

Create a DNS zone

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.PostDnsZones(context.Background()).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsZones``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

This endpoint does not need any parameter.

Other Parameters

Other parameters are passed through a pointer to a apiPostDnsZonesRequest struct via the builder pattern

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostDnsZonesByZoneRecords

PostDnsZonesByZoneRecords(ctx, zone).Execute()

Create a DNS record

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.PostDnsZonesByZoneRecords(context.Background(), zone).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsZonesByZoneRecords``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string

Other Parameters

Other parameters are passed through a pointer to a apiPostDnsZonesByZoneRecordsRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PutDnsZonesByZoneRecordsByRecord

PutDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()

Amend a DNS record

Example

package main

import (
	"context"
	"fmt"
	"os"
	openapiclient "github.com/hanzoai/go-sdk/v8"
)

func main() {
	zone := "zone_example" // string | 
	record := "record_example" // string | 

	configuration := openapiclient.NewConfiguration()
	apiClient := openapiclient.NewAPIClient(configuration)
	r, err := apiClient.DnsAPI.PutDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PutDnsZonesByZoneRecordsByRecord``: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}
}

Path Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
zone string
record string

Other Parameters

Other parameters are passed through a pointer to a apiPutDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern

Name Type Description Notes

Return type

(empty response body)

Authorization

bearer

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]