JA EN
shiichan

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

Cloudflare Changelog ★★★ View Markdown
#cloudflare#devops#ai#security

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

Cloudflare Changelog developers.cloudflare.com

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.

Related posts