Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
9027800
codegen metadata
stainless-app[bot] Jun 16, 2026
f4f7261
chore(api): update composite API spec
stainless-app[bot] Jun 17, 2026
58229bb
chore(api): update composite API spec
stainless-app[bot] Jun 17, 2026
a1af84e
chore(api): update composite API spec
stainless-app[bot] Jun 17, 2026
187e694
codegen metadata
stainless-app[bot] Jun 17, 2026
b92374d
feat: feat: add MoQ relays to prod (RT-603)
stainless-app[bot] Jun 17, 2026
36db216
codegen metadata
stainless-app[bot] Jun 17, 2026
9294d3f
codegen metadata
stainless-app[bot] Jun 17, 2026
0144eba
codegen metadata
stainless-app[bot] Jun 17, 2026
bc77696
codegen metadata
stainless-app[bot] Jun 17, 2026
99fc940
codegen metadata
stainless-app[bot] Jun 17, 2026
b684bae
feat: fix(moq): render MoQ via explicit custom casing (RT-603)
stainless-app[bot] Jun 17, 2026
6622331
chore(api): update composite API spec
stainless-app[bot] Jun 17, 2026
8a21c65
codegen metadata
stainless-app[bot] Jun 17, 2026
8235bcf
chore(api): update composite API spec
stainless-app[bot] Jun 17, 2026
4f11ccc
codegen metadata
stainless-app[bot] Jun 18, 2026
3136763
codegen metadata
stainless-app[bot] Jun 18, 2026
6787268
chore(api): update composite API spec
stainless-app[bot] Jun 18, 2026
de6a694
feat: feat: ES-13122 Add email-auth API endpoints
stainless-app[bot] Jun 18, 2026
051ddf0
codegen metadata
stainless-app[bot] Jun 18, 2026
573d9fb
chore(api): update composite API spec
stainless-app[bot] Jun 18, 2026
b01a29a
chore(api): update composite API spec
stainless-app[bot] Jun 19, 2026
5025ca8
codegen metadata
stainless-app[bot] Jun 19, 2026
1936b63
codegen metadata
stainless-app[bot] Jun 19, 2026
43cca81
feat: feat(email_security): Add API to do bulk message movements and …
stainless-app[bot] Jun 19, 2026
639b8af
chore(api): update composite API spec
stainless-app[bot] Jun 19, 2026
1a562b3
codegen metadata
stainless-app[bot] Jun 19, 2026
14b5631
chore(internal): codegen related update
stainless-app[bot] Jun 19, 2026
c77d457
chore(api): update composite API spec
stainless-app[bot] Jun 19, 2026
c9aa9fe
chore(api): update composite API spec
stainless-app[bot] Jun 19, 2026
b008758
feat: feat(lex): add Log Explorer to SDK config
stainless-app[bot] Jun 22, 2026
be52bf1
chore(api): update composite API spec
stainless-app[bot] Jun 22, 2026
8502dc9
codegen metadata
stainless-app[bot] Jun 22, 2026
88a4d5d
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
43d78b5
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
23b53b6
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
dcacfed
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
add9c23
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
42ede70
codegen metadata
stainless-app[bot] Jun 23, 2026
d323ad4
chore(api): update composite API spec
stainless-app[bot] Jun 23, 2026
e023472
feat: feat(casb): publish CASB APIs to public SDK
stainless-app[bot] Jun 24, 2026
e52ea1e
codegen metadata
stainless-app[bot] Jun 24, 2026
20d6ecd
chore(api): update composite API spec
stainless-app[bot] Jun 24, 2026
eeaf786
codegen metadata
stainless-app[bot] Jun 24, 2026
dbca6aa
chore(api): update composite API spec
stainless-app[bot] Jun 24, 2026
e3339e0
Build SDK
vaishakdinesh Jul 2, 2026
429886a
Build SDK
vaishakdinesh Jul 2, 2026
de40203
Build SDK
vaishakdinesh Jul 2, 2026
9a6b798
Build SDK
vaishakdinesh Jul 7, 2026
4a2c153
Merge branch 'vaishak/refresh-go-custom-code-tracking-2026-07-07' int…
vaishakdinesh Jul 7, 2026
eb2bf2b
chore: apply accumulated custom code (ci jobs, gitlab config)
vaishakdinesh Jul 7, 2026
6cad6cb
ci: bump CI job timeouts to 30 minutes
vaishakdinesh Jul 7, 2026
f9b3f27
fix(dns): restore Shadow* query params on RecordListParams and Includ…
vaishakdinesh Jul 8, 2026
ff0dad1
Merge branch 'vaishak/refresh-go-custom-code-tracking-2026-07-08' int…
vaishakdinesh Jul 8, 2026
0f44441
fix(browser_rendering): swap HTML for URL on AccessibilityTreeNewPara…
vaishakdinesh Jul 8, 2026
3de4191
chore: unblock CI test job and fix union field merge panics
vaishakdinesh Jul 8, 2026
88ae6e2
Merge branch 'vaishak/release-770-prep-2026-07-08' into 'main'
vaishakdinesh Jul 8, 2026
2fa539e
chore(main): release 7.7.0
vaishakdinesh Jul 9, 2026
90d6f2f
Merge remote-tracking branch 'github/main' into release-770
vaishakdinesh Jul 9, 2026
24980ca
docs(changelog): document additional breaking changes for DEXTests an…
vaishakdinesh Jul 9, 2026
ccd5db9
feat(email_routing): add AccountRules.List and restore Rules.List
vaishakdinesh Jul 9, 2026
702a799
chore: drop .gitlab-ci.yml from GitHub branch
vaishakdinesh Jul 9, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Comment thread
vaishakdinesh marked this conversation as resolved.
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "7.6.0"
".": "7.7.0"
}
5 changes: 1 addition & 4 deletions .stats.yml
Comment thread
vaishakdinesh marked this conversation as resolved.
Original file line number Diff line number Diff line change
@@ -1,4 +1 @@
configured_endpoints: 2412
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-874436f83bd9c383144c69da47c4b767bb9c6f4f2bb4945af58cf3b6015f0f62.yml
openapi_spec_hash: beaf9a654991bf65d642e05c03460e4c
config_hash: 2f529580a17438fc62cd0b47db41b6f1
configured_endpoints: 2448
62 changes: 58 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,63 @@
# Changelog

## 7.7.0 (2026-07-08)

Full Changelog: [v7.6.0...v7.7.0](https://github.com/cloudflare/cloudflare-go/compare/v7.6.0...v7.7.0)

### Breaking Changes

See the [v7.7.0 Migration Guide](./docs/migration-guides/v7.7.0-migration-guide.md) for before/after code examples and actions needed for each change.

* **ssl:** `Recommendations.Get` method and `RecommendationGetResponse` / `RecommendationGetParams` types removed.
* **ai_gateway, workflows, zero_trust/dlpemailaccountmapping:** merged-union parent fields with same-name-different-type collisions changed from a variant-struct type to `interface{}`. Affected fields:
* `ai_gateway.AIGateway{New,Update,List,Delete,Get}ResponseSpendLimitsRulesMetadata.Mode` (5 structs)
* `workflows.VersionGraphResponseGraphWorkflowPayload.Type`
* `zero_trust.DLPEmailAccountMapping{New,Get}ResponseAuthRequirements.Type` (2 structs)

These fields were unreadable in the previous type (marshaling panicked with `reflect: call of reflect.Value.SetString on struct Value`). The new `interface{}` type matches the codegen pattern used by sibling merged fields on the same structs (e.g. `Values`, `Fields`, `AllowedMicrosoftOrganizations`); callers should switch on the parent union via `AsUnion()` for a strongly-typed variant.

* **zero_trust:** `Devices.DEXTests.{New,Update,List,Get}` response type renamed from `DeviceDEXTest{New,Update,List,Get}Response` to the shared `SchemaHTTP`; field structure unchanged. Nested types renamed accordingly (e.g. `DeviceDEXTestNewResponseData` → `SchemaData`, `DeviceDEXTestNewResponseTargetPolicy` → `SchemaHTTPTargetPolicy`). Callers using `:=` inference and field access continue to compile; callers referencing the removed type names must update to `SchemaHTTP`.
* **zero_trust:** `Devices.IPProfiles.List` pagination changed from `pagination.SinglePage[IPProfile]` to `pagination.V4PagePaginationArray[IPProfile]`. `.Result` field access and `ListAutoPaging()` iteration continue to work; callers referencing the pagination type by name must update.

### Features

* **NEW SERVICE: `email_auth`** — DMARC reports edit/get and SPF inspect
* `client.EmailAuth.DMARCReports.Edit`
* `client.EmailAuth.DMARCReports.Get`
* `client.EmailAuth.SPF.Inspect.Get`
* **NEW SERVICE: `moq`** — Media over QUIC relay management
* `client.MoQ.Relays.{New,Update,List,Delete,Get}`
* `client.MoQ.Relays.Tokens.Rotate`
* **zero_trust:** publish CASB APIs (`client.ZeroTrust.Casb.*`)
* `Applications.{List,Get}` + `Applications.SetupFlows.List`
* `Integrations.{New,Update,List,Delete,Get,Pause,Resume}`
* **logs:** add `LogExplorer` sub-resource
* `LogExplorer.Query.Sql`
* `LogExplorer.Datasets.{New,Update,List,Get}`
* `LogExplorer.Datasets.Available.List`
* **browser_rendering:** add `AccessibilityTree.New` method
* **email_routing:** add `EmailRouting.Unlock` and `EmailRouting.Addresses.Edit` methods
* **email_routing:** add `AccountRules.List` method (`GET /accounts/{account_id}/email/routing/rules`) returning `AccountRule` with new `Zone` field; `Rules.List` gains optional `AccountID` param (mutually exclusive with `ZoneID`) so callers can list rules by account or zone
* **email_security:** add bulk investigation APIs
* `Investigate.Bulk.{New,List,Delete,Get}`
* `Investigate.Bulk.Cancel.New`
* `Investigate.Bulk.Messages.List`
* **accounts:** add `Logs.Audit.History` and `Logs.Audit.ProductCategories` methods
* **organizations:** add `Logs.Audit.History` method

### Bug Fixes

* **ai_gateway, workflows, zero_trust/dlpemailaccountmapping:** fix panics on union-merged parent field decoding by switching same-name-different-type merged fields from a variant-struct type to `interface{}` ([3de4191](https://github.com/cloudflare/cloudflare-go/commit/3de4191de))
* **browser_rendering:** `AccessibilityTreeNewParamsBodyObject` now uses `URL` (matching the generated test fixture) instead of `HTML` ([0f44441](https://github.com/cloudflare/cloudflare-go/commit/0f4444190))
* **dns:** restore `Shadow*` query params on `RecordListParams` and `IncludeShadowMetadata` on `Record{New,Update,List,Batch,Edit,Get}Params` after a codegen regression dropped them ([f9b3f27](https://github.com/cloudflare/cloudflare-go/commit/f9b3f274a))

### Chores

* **api:** update composite API spec (20+ codegen sync commits)
* **ci:** bump CI job timeouts to 30 minutes ([6cad6cb](https://github.com/cloudflare/cloudflare-go/commit/6cad6cb57))
* **ci:** unblock test job by installing nodejs/npm for prism mock server ([3de4191](https://github.com/cloudflare/cloudflare-go/commit/3de4191de))
* apply accumulated custom code (CI jobs, GitLab config) ([eb2bf2b](https://github.com/cloudflare/cloudflare-go/commit/eb2bf2b10))

## 7.6.0 (2026-06-16)

Full Changelog: [v7.5.0...v7.6.0](https://github.com/cloudflare/cloudflare-go/compare/v7.5.0...v7.6.0)
Expand Down Expand Up @@ -35,10 +93,6 @@ Full Changelog: [v7.5.0...v7.6.0](https://github.com/cloudflare/cloudflare-go/co

## 7.5.0 (2026-06-10)

Full Changelog: [v7.5.0...v7.5.0](https://github.com/cloudflare/cloudflare-go/compare/v7.5.0...v7.5.0)

## 7.5.0 (2026-06-10)

Full Changelog: [v7.4.0...v7.5.0](https://github.com/cloudflare/cloudflare-go/compare/v7.4.0...v7.5.0)

### Features
Expand Down
19 changes: 1 addition & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,37 +7,20 @@ from applications written in Go.

It is generated with [Stainless](https://www.stainless.com/).

## MCP Server

Use the Cloudflare MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=cloudflare-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNsb3VkZmxhcmUtbWNwIl0sImVudiI6eyJDTE9VREZMQVJFX0FQSV9UT0tFTiI6IlNuM2xaSlRCWDZra2c3T2RjQlVBeE9POTYzR0VJeUdRcW5GVE9GWVkiLCJDTE9VREZMQVJFX0FQSV9LRVkiOiIxNDRjOWRlZmFjMDQ5NjljN2JmYWQ4ZWZhYThlYTE5NCIsIkNMT1VERkxBUkVfRU1BSUwiOiJ1c2VyQGV4YW1wbGUuY29tIiwiQ0xPVURGTEFSRV9BUElfVVNFUl9TRVJWSUNFX0tFWSI6InYxLjAtMTQ0YzlkZWZhYzA0OTY5YzdiZmFkOGVmLTYzMWE0MWQwMDNhMzJkMjVmZTg3ODA4MWVmMzY1YzQ5NTAzZjdmYWRhNjAwZGE5MzVlMjg1MWExYzczMjYwODRiODVjYmY2NDI5YzRiODU5ZGU4NDc1NzMxZGM5MmE5YzMyOTYzMWU2ZDU5ZTZjNzNkYTdiMTk4NDk3MTcyYjRjZWZlMDcxZDkwZDBmNWQyNzE5In19)
[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22cloudflare-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22cloudflare-mcp%22%5D%2C%22env%22%3A%7B%22CLOUDFLARE_API_TOKEN%22%3A%22Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY%22%2C%22CLOUDFLARE_API_KEY%22%3A%22144c9defac04969c7bfad8efaa8ea194%22%2C%22CLOUDFLARE_EMAIL%22%3A%22user%40example.com%22%2C%22CLOUDFLARE_API_USER_SERVICE_KEY%22%3A%22v1.0-144c9defac04969c7bfad8ef-631a41d003a32d25fe878081ef365c49503f7fada600da935e2851a1c7326084b85cbf6429c4b859de8475731dc92a9c329631e6d59e6c73da7b198497172b4cefe071d90d0f5d2719%22%7D%7D)

> Note: You may need to set environment variables in your MCP client.

## Installation

<!-- x-release-please-start-version -->

```go
import (
"github.com/cloudflare/cloudflare-go/v7" // imported as cloudflare
)
```

<!-- x-release-please-end -->

Or to pin the version:

<!-- x-release-please-start-version -->

```sh
go get -u 'github.com/cloudflare/cloudflare-go/v7@v7.6.0'
go get -u 'github.com/cloudflare/cloudflare-go/v7@v7.7.0'
```

<!-- x-release-please-end -->

## Requirements

This library requires Go 1.22+.
Expand Down
4 changes: 4 additions & 0 deletions accounts/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,11 @@ Methods:
Response Types:

- <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditListResponse">LogAuditListResponse</a>
- <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditHistoryResponse">LogAuditHistoryResponse</a>
- <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditProductCategoriesResponse">LogAuditProductCategoriesResponse</a>

Methods:

- <code title="get /accounts/{account_id}/logs/audit">client.Accounts.Logs.Audit.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, params <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditListParams">LogAuditListParams</a>) (\*<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/packages/pagination">pagination</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/packages/pagination#CursorPaginationAfter">CursorPaginationAfter</a>[<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditListResponse">LogAuditListResponse</a>], <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
- <code title="get /accounts/{account_id}/logs/audit/{id}/history">client.Accounts.Logs.Audit.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditService.History">History</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>, params <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditHistoryParams">LogAuditHistoryParams</a>) (\*[]<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditHistoryResponse">LogAuditHistoryResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
- <code title="get /accounts/{account_id}/logs/audit/product_categories">client.Accounts.Logs.Audit.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditService.ProductCategories">ProductCategories</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditProductCategoriesParams">LogAuditProductCategoriesParams</a>) (\*<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/packages/pagination">pagination</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/packages/pagination#SinglePage">SinglePage</a>[<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts">accounts</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v7/accounts#LogAuditProductCategoriesResponse">LogAuditProductCategoriesResponse</a>], <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
Loading
Loading