megachangelog
Breaking7.0.0

Go SDK v7.0.0 Released

Major release with breaking changes to ai_search, email_security, and workers packages reflecting upstream API specification updates. New features include organization audit logs, browser rendering controls, queue metrics, and improved AI search synchronization.

Full Changelog: v6.10.0...v7.0.0 ↗

This is a major version release that includes breaking changes to three packages: ai_search, email_security, and workers. These changes reflect upstream API specification updates that improve type correctness and consistency.

Please ensure you read through the list of changes below before moving to this version - this will help you understand any down or upstream issues it may cause to your environments.

Breaking Changes

See the v7.0.0 Migration Guide ↗ for before/after code examples and actions needed for each change.

AI Search - SearchForAgents Metadata Removed

The SearchForAgents nested type has been removed from all instance metadata structs. This field is no longer part of the API specification.

Removed Types:

  • InstanceNewResponseMetadataSearchForAgents
  • InstanceUpdateResponseMetadataSearchForAgents
  • InstanceListResponseMetadataSearchForAgents
  • InstanceDeleteResponseMetadataSearchForAgents
  • InstanceReadResponseMetadataSearchForAgents
  • InstanceNewParamsMetadataSearchForAgents
  • InstanceUpdateParamsMetadataSearchForAgents
  • NamespaceInstanceNewResponseMetadataSearchForAgents
  • NamespaceInstanceUpdateResponseMetadataSearchForAgents
  • NamespaceInstanceListResponseMetadataSearchForAgents
  • NamespaceInstanceDeleteResponseMetadataSearchForAgents
  • NamespaceInstanceReadResponseMetadataSearchForAgents
  • NamespaceInstanceNewParamsMetadataSearchForAgents
  • NamespaceInstanceUpdateParamsMetadataSearchForAgents

Email Security - Path Parameter Type Changes

Multiple Email Security settings sub-resources have changed their path parameter types from int64 to string:

  • AllowPolicies (policyID int64 -> policyID string)
  • BlockSenders (patternID int64 -> patternID string)
  • Domains (domainID int64 -> domainID string)
  • ImpersonationRegistry (displayNameID int64 -> impersonationRegistryID string)
  • TrustedDomains (trustedDomainID int64 -> trustedDomainID string)

Email Security - Investigate Parameter Rename

The Investigate.Get, Investigate.Move.New, and Investigate.Reclassify.New methods now use investigateID instead of postfixID as the path parameter name.

Email Security - Domains BulkDelete Method Removed

The SettingDomainService.BulkDelete method and its associated types have been removed:

  • SettingDomainBulkDeleteResponse
  • SettingDomainBulkDeleteParams

Email Security - TrustedDomains Return Type Change

SettingTrustedDomainService.New now returns *SettingTrustedDomainNewResponse instead of *SettingTrustedDomainNewResponseUnion.

Email Security - Investigate.Move Return Type Change

InvestigateMoveService.New now returns *pagination.SinglePage[InvestigateMoveNewResponse] instead of *[]InvestigateMoveNewResponse.

Workers - Observability Telemetry Filter Restructuring

The observability telemetry filter parameter types have been restructured to support nested filter groups. New discriminated union types replace the previous flat filter arrays:

  • ObservabilityTelemetryKeysParams.Filters now accepts FiltersObjectFilterUnion (was []interface\{\})
  • ObservabilityTelemetryQueryParams.Parameters.Filters now accepts FiltersObjectFilterUnion
  • ObservabilityTelemetryValuesParams.Filters now accepts FiltersObjectFilterUnion

New types include FiltersObjectFiltersObject (for group filters with FilterCombination) and FiltersWorkersObservabilityFilterLeaf (for leaf filters with typed Operation, Type, and Value fields).

Features

Organizations - Audit Logs (client.Organizations.Logs.Audit)

NEW SERVICE: Query organization audit logs with cursor-based pagination.

  • List() - Retrieve audit logs

Browser Rendering (client.BrowserRendering)

  • client.BrowserRendering.Devtools.Browser.Targets.Close() - Close a specific browser target (tab, page) by ID

Queues (client.Queues)

  • client.Queues.GetMetrics() - Retrieve queue metrics for a specific queue

AI Search (client.AISearch)

  • Added WaitForCompletion parameter to NamespaceInstanceItemNewOrUpdateParams and NamespaceInstanceItemSyncParams for synchronous indexing confirmation

Bug Fixes

  • Magic Transit: ConnectorService.List parameter name corrected from query to params (non-functional, affects generated documentation only)

Deprecations

None in this release.

Get started

go-sdkbreakingapiai-searchemail-securityworkers

Source: original entry ↗

More from Cloudflare

Follow Cloudflare to get its new changes in your feed and email digest.

Improvement2026.8.2100.0

Cloudflare One Client for macOS 2026.8.2100.0

GA release for macOS Cloudflare One Client with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster connects with lower memory use, and numerous reliability fixes across DNS, reauthentication, and client stability.

macosvpnreliabilityperformancedns
Improvement2026.8.2100.0

Cloudflare One Client for Windows 2026.8.2100.0

This GA release improves split tunnel reliability, adds support for non-RFC 1918 local networks, optimizes connection performance with faster reconnections and lower memory usage, and includes numerous bug fixes for DNS, registration, and network handling. The client now features a service recovery mechanism that automatically restarts on system unlock and better handles large hosts files without blocking traffic.

windowsvpnclienttunneldns
Improvement2026.8.2100.0

Cloudflare One Client for Linux 2026.8.2100.0

New GA release for Linux with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster tunnel reconnections, and lower memory usage. Includes numerous stability and reliability fixes for DNS, reconnection behavior, and crash issues.

linuxvpnclientperformancestability
See all Cloudflare changes →