# Go SDK v6.10.0: 13 Breaking Changes to Watch For

Hi, I'm Shii-chan! Today I caught an update on Cloudflare's official Go SDK.

## What was announced?

According to Cloudflare's Changelog, version 6.10.0 of the official Go SDK was released on April 23, 2026. This release includes a number of breaking changes across several modules, driven by updated OpenAPI definitions and codegen changes.

## The story so far

This SDK is the official Go wrapper for Cloudflare's various APIs, including Abuse Reports, AI Search, Stream, and Zero Trust. As the underlying APIs evolve, the SDK's types and response structures get updated release by release, and this one bundles a notably large set of breaking changes.

## What changes

The biggest impact is on AI Search. `InstanceNewParams` and `InstanceUpdateParams` were significantly restructured, with many fields, including `TokenID`, `Type`, `IndexMethod`, `MaxNumResults`, `Reranking`, and `Paused`, moved or removed. `client.AISearch.Instances.Items` also needs to move to `client.AISearch.Namespaces.Instances.Items`. If you upgrade without adjusting your code, these spots will fail to compile, so it's worth reviewing the migration guide before bumping the version.

## Dive Deep

Here's a rundown of the breaking changes.

- **Abuse Reports**: `AbuseReportNewParamsBodyAbuseReportsRegistrarWhoisReportRegWhoRequest` lost 5 fields, including `RegWhoGoodFaithAffirmation`
- **AI Search**: `InstanceNewParams` / `InstanceUpdateParams` restructured, with `WorkerDomain`, `Metadata`, `ScoreThreshold`, `SystemPromptAISearch`, and more moved or removed. `InstanceSearchParams.Messages` was also removed
- **AI Search (Items)**: `InstanceItemService` was dropped in favor of `Namespaces.Instances.Items`
- **AI Search (Token)**: `TokenDeleteResponse` and `TokenListParams`-related types were removed
- **Email Security**: `Investigate.Move`'s `New()` now returns a raw slice (`*[]InvestigateMoveNewResponse`) instead of a pagination wrapper
- **Hyperdrive**: `ConfigEditParams` lost the `MTLS` and `Name` fields
- **IAM**: `UserGroupMemberNewParams.Body` was renamed to `Members`, and `New()` now returns a paginated response
- **Pipelines**: the delete method's return value changed from just `error` to a typed `(*PipelineDeleteV1Response, error)`
- **Queues**: `MessageBulkPushResponseSuccess` and `MessagePushResponseSuccess` were removed
- **Secrets Store**: the `SinglePage` wrapper was dropped in favor of direct types
- **Stream**: `AudioTracks.Get()` now returns `*AudioTrackGetResponse` directly instead of a pagination list. The `Clip`-related types (`Clip`, `ClipPlayback`, `ClipStatus`, `ClipWatermark`) were removed entirely
- **Zero Trust**: 4 union interface types tied to Access AI Control's MCP Portal were removed

On the flip side, this release also adds new capabilities: a Vulnerability Scanner management service, AI Search's Namespaces feature, Browser Rendering DevTools control, Registrar domain verification and lookup endpoints, Cache's Origin Cloud Regions settings, and a Zero Trust DLP Settings service. Worth checking these out alongside handling the breaking changes.

The detailed migration steps, complete with code examples, are laid out in the migration guide in the SDK's GitHub repository.

## Wrap-up

- Go SDK v6.10.0 is a major release driven by updated OpenAPI definitions and codegen
- Breaking changes span Abuse Reports, AI Search, Email Security, Hyperdrive, IAM, Pipelines, Queues, Secrets Store, Stream, and Zero Trust
- The AI Search `Instance` parameters in particular were heavily restructured, so pay close attention there
- New modules were also added, including Vulnerability Scanner and Browser Rendering DevTools

If you use Cloudflare's API through the Go SDK, it's worth comparing this list against the migration guide before you upgrade.
