---
description: Major release with breaking changes across AI Search, Email Security, and Workers, plus new Organization Audit Logs and Queue Metrics endpoints.
title: Go SDK v7.0.0 Released
image: https://developers.cloudflare.com/changelog/post/2026-04-30-go-sdk-v7.0.0/og.png?v=49f2cabbc2741aff
---

[Skip to content](#main-content)

[View RSS feeds](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/) [ Subscribe to RSS](https://developers.cloudflare.com/changelog/rss/index.xml)

[Back to all posts](https://developers.cloudflare.com/changelog)

April 30, 2026

## Go SDK v7.0.0 Released

[SDK](https://developers.cloudflare.com/fundamentals/api/reference/sdks/) [Go SDK](https://developers.cloudflare.com/fundamentals/api/reference/sdks/)

Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/changelog/post/2026-04-30-go-sdk-v7.0.0/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)

Full Changelog: [v6.10.0...v7.0.0 ↗︎](https://github.com/cloudflare/cloudflare-go/compare/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 ↗︎](https://github.com/cloudflare/cloudflare-go/blob/main/docs/migration-guides/v7.0.0-migration-guide.md) 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

- [Download Go SDK v7.0.0 ↗︎](https://github.com/cloudflare/cloudflare-go/releases/tag/v7.0.0)
- [Go SDK documentation ↗︎](https://developers.cloudflare.com/api/sdks/go/)
- [Migration Guide ↗︎](https://github.com/cloudflare/cloudflare-go/blob/main/docs/migration-guides/v7.0.0-migration-guide.md)

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://developers.cloudflare.com/changelog/post/2026-04-30-go-sdk-v7.0.0/#page","headline":"Go SDK v7.0.0 Released","description":"Major release with breaking changes across AI Search, Email Security, and Workers, plus new Organization Audit Logs and Queue Metrics endpoints.","url":"https://developers.cloudflare.com/changelog/post/2026-04-30-go-sdk-v7.0.0/","inLanguage":"en","image":"https://developers.cloudflare.com/changelog/post/2026-04-30-go-sdk-v7.0.0/og.png?v=49f2cabbc2741aff","dateModified":"2026-04-30","datePublished":"2026-04-30","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```