CF-Incidents SDK, Go SDK - Go SDK v7.0.0 Released

[ENF News Bot]

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​

https://developers.cloudflare.com/changelog/rss/#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​

https://developers.cloudflare.com/changelog/rss/#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​

https://developers.cloudflare.com/changelog/rss/#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​

https://developers.cloudflare.com/changelog/rss/#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​

https://developers.cloudflare.com/changelog/rss/#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​

https://developers.cloudflare.com/changelog/rss/#email-security---trusteddomains-return-type-change

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

Email Security - Investigate.Move Return Type Change​

https://developers.cloudflare.com/changelog/rss/#email-security---investigatemove-return-type-change

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

Workers - Observability Telemetry Filter Restructuring​

https://developers.cloudflare.com/c...-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​

https://developers.cloudflare.com/changelog/rss/#features

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

https://developers.cloudflare.com/c...ons---audit-logs-clientorganizationslogsaudit

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

• List() - Retrieve audit logs

Browser Rendering (client.BrowserRendering)​

https://developers.cloudflare.com/changelog/rss/#browser-rendering-clientbrowserrendering

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

Queues (client.Queues)​

https://developers.cloudflare.com/changelog/rss/#queues-clientqueues

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

AI Search (client.AISearch)​

https://developers.cloudflare.com/changelog/rss/#ai-search-clientaisearch

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

Bug Fixes​

https://developers.cloudflare.com/changelog/rss/#bug-fixes

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

Deprecations​

https://developers.cloudflare.com/changelog/rss/#deprecations

None in this release.

Get started​

https://developers.cloudflare.com/changelog/rss/#get-started

• Download Go SDK v7.0.0 ↗︎
• Go SDK documentation ↗︎
• Migration Guide ↗︎

Continue reading...