Skip to content

release: 5.3.0#2729

Merged
musa-cf merged 214 commits into
mainfrom
release-please--branches--main--changes--next
Jun 11, 2026
Merged

release: 5.3.0#2729
musa-cf merged 214 commits into
mainfrom
release-please--branches--main--changes--next

Conversation

@stainless-app

@stainless-app stainless-app Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Automated Release PR

Full Changelog: v5.2.0...v5.3.0

Breaking Changes

  • billing: the underlying API endpoint for client.billing.usage.paygo() changed from GET /accounts/{account_id}/billing/usage/paygo to GET /accounts/{account_id}/paygo-usage. The SDK call site, method signature, params, and return type are unchanged -- existing code does not need to be modified. This is recorded as a breaking change because the underlying API contract moved. (7e3d4f7)
  • api_gateway: discovery.operations.edit method removed along with OperationEditParams and OperationEditResponse types -- use discovery.operations.bulk_edit to update individual operations by including them in the batch payload (fa62be6)
  • resource_sharing: resources.update, resources.delete, and resources.get path parameter renamed from resource_id to share_resource_id -- update call sites to use the new parameter name (b9d7b797)
  • zero_trust: gateway.lists.items.list return type changed from SyncSinglePage[ItemListResponse] to SyncSinglePage[GatewayItem] -- the ItemListResponse type is removed; use GatewayItem from cloudflare.types.zero_trust.gateway instead (fc596ad4)

Features

  • client: add CLOUDFLARE_CUSTOM_HEADERS environment variable support -- parse newline-delimited Key: Value pairs into default request headers. Explicit default_headers passed to the constructor take precedence over env-parsed values. (fa62be6)
  • custom_csrs: add custom_csrs resource -- create, list, delete, get CSRs at zone and account scope (1a65a8d)
  • dls: add DLS (Data Localization Suite) resource -- regions (list/get) and regional_services.prefix_bindings (create/list/delete/edit/get) (a7fcbada)
  • tenant_custom_nameservers: add tenant_custom_nameservers resource -- create, delete, get at /tenants/{tenant_tag}/custom_ns (1260f118)
  • csam_scanner: add csam_scanner resource -- edit and get scanner configuration (2cf53e2)
  • ai_audit: add ai_audit resource (d0efa14)
  • iam: add oauth_clients sub-resource -- create, update, list, delete, get, rotate_secret, delete_rotated_secret (82cc646)
  • iam: add oauth_scopes sub-resource -- list available OAuth scopes (82cc646)
  • email_security: add settings.sending_domain_restrictions sub-resource -- create, list, delete, edit, get (a038d948)
  • email_security: add settings.url_ignore_patterns sub-resource -- create, list, delete, edit, get (a038d948)
  • zero_trust: add access.idp_federation_grants sub-resource -- create, list, delete, get (4b724b0)
  • zero_trust: add dlp.custom_prompt_topics sub-resource -- create, update, list, delete, get (116abcbf)
  • zero_trust: add dex.devices.isps sub-resource -- list ISPs for a device (fb515780)
  • workers: add observability.queries sub-resource -- create and list saved telemetry queries (4f7489f)
  • workers: add observability.shared_queries sub-resource -- create and get shared observability queries (42f37a36)
  • workers: add observability.telemetry.live_tail and live_tail_heartbeat methods (6a139692)
  • billing: add usage.get method -- FOCUS v1.3 cost-and-usage dataset at /accounts/{account_id}/billable/usage (7e3d4f7)
  • organizations: add billing.usage sub-resource -- FOCUS v1.3 cost-and-usage dataset at /organizations/{organization_id}/billable/usage (bbaf331a)
  • dns: add usage.account and usage.zone sub-resources -- get DNS usage statistics (7e5da924)
  • secrets_store: add stores.get method -- fetch a single store by ID (c1c6173b)
  • workflows: add instances.step method -- get a specific step of a workflow instance (ab254121)
  • workflows: add versions.graph method -- get the version graph for a workflow version (ab254121)
  • realtime_kit: add livestreams.get_livestream_analytics_daywise method (e9b1086d)
  • realtime_kit: sessions.generate_summary_of_transcripts now returns typed SessionGenerateSummaryOfTranscriptsResponse (was None) (e9b1086d)
  • realtime_kit: recordings.start_track_recording now returns typed RecordingStartTrackRecordingResponse (was None) (e9b1086d)
  • snippets: add rules.get method (2fda51fd)
  • zero_trust: update generated types and methods -- access.ai_controls.mcp.servers.sync now returns typed ServerSyncResponse, identity provider type expansion, device policy field additions (fc596ad4)

Chores

  • aisearch: type updates on instance create/update/delete/list/read/search response types (fa62be6)
  • browser_rendering: snapshot type updates (fa62be6)
  • custom_certificates: parameter optionality updates (820bf1f3)
  • custom_hostnames: type field updates (fa62be6)
  • dns_firewall: type field additions (ee9864760)
  • hostnames: settings type updates (fa62be6)
  • magic_transit: connector event type updates (fa62be6)
  • realtime_kit: extensive type restructuring across presets, sessions, recordings, and meetings (e9b1086d)
  • spectrum: add virtual_network_id field to origin DNS types (2482db5c)
  • sync codegen shared files (.stats.yml, CI workflows, pyproject.toml) (fa62be6)

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

stainless-app Bot added 30 commits April 24, 2026 19:48
* feat(queues): add queues metrics endpoint
* chore: skip failing tests for dns.records and workers.beta.workers

- dns.records.scan_review: mock server returns invalid response data
- dns.records.scan_list: mock server returns invalid response data
- workers.beta.workers.create: HTTP 400 error from prism (missing required body properties)
- workers.beta.workers.update: HTTP 400 error from prism (missing required body properties)

Failures observed in both Python and TypeScript SDK test suites.
…rs.observability.telemetry

* chore: skip failing tests for email_security.settings and workers.observability.telemetry

- email_security.settings.allow_policies.edit: HTTP 422 from prism
- email_security.settings.block_senders.edit: HTTP 422 from prism
- email_security.settings.impersonation_registry.edit: HTTP 422 from prism
- email_security.settings.trusted_domains.edit: HTTP 422 from prism
- workers.observability.telemetry.keys: HTTP 400 from prism
- workers.observability.telemetry.query: HTTP 400 from prism
- workers.observability.telemetry.values: HTTP 400 from prism

Failures observed in CI run 25132870851 on cloudflare-typescript PR #2743.
* chore: skip fraud.update test (HTTP 422 from prism)

Failure observed in CI run 25171503153 on cloudflare-typescript PR #2746.
* feat(python): switch package manager from rye to uv
* feat(api): add zero_trust_device_deployment_groups resource

* feat(api): add zero_trust_device_deployment_groups resource
…s to Security Center API

* feat(SCTR): add audit log, classification, and context endpoints to Security Center API
stainless-app Bot and others added 18 commits June 11, 2026 12:01
…n Prod Config (APIX-981)

* fix(dns): Exclude dns_records From combineCloudflareResources in Prod Config (APIX-981)
* feat(access): add idp_federation_grants resource

Add list/create/get/delete endpoints for Access IdP federation grants
under zero_trust.access.

Closes AUTH-8707
* feat(api): sync workflows API endpoints (2 new)

* chore: drop TODO(linguini) stub comments

* chore: drop instances/terminate stub (now skipped from sync)

* chore: sync workflows API endpoints into stainless config
…shares

* fix(resource_sharing): update share_resource method paths to match share-api rename

share-api MR !426 renamed the path placeholder on the share-resource
endpoints from {resource_id} to {share_resource_id} (the OpenAPI metadata
name only; URLs unchanged). The Stainless config's method-to-path
mapping still referenced the old name, so after the new spec flowed
through, Stainless couldn't resolve GET/PUT/DELETE on
/accounts/{account_id}/shares/{share_id}/resources/{...} and emitted
empty Read/Update/Delete handlers in the Terraform target. The Go SDK
target dropped those methods entirely.

Update both the production config and the testdata copy so the method
strings match the renamed path. Stainless's next codegen run will
restore the full CRUD surface for cloudflare_share_resource and the
corresponding methods in cloudflare-go's resource_sharing.Resources.

Ref: GRM-887
Related: cloudflare/grm/share-api!426 (the OpenAPI rename)
Cherry-pick of staging !911.

* fix(resource_sharing): drop bulk-replace recipients endpoint to fix codegen

* fix(resource_sharing): drop bulk-replace recipients endpoint to fix codegen

The Stainless model generator conflates the single-object create endpoint
(POST /shares/{share_id}/recipients) with the bulk-replace endpoint
(PUT /shares/{share_id}/recipients) when both are mapped under the same
subresource. The resulting model has a list-typed `body` field whose
MarshalJSON serializes the list as a JSON array on both create and
update — producing 400 errors on every single-recipient create.

Removing the bulk-replace mapping makes Stainless generate a model with
a single-object body, which the API accepts for create. Users wanting
to replace all recipients at once can issue successive create/delete
operations or hit the API directly.

Ref: GRM-887

* feat(resource_sharing): add Terraform resource definitions for shares

* feat(resource_sharing): add Terraform resource definitions for shares

Add terraform: blocks to resource_sharing and its subresources
(recipients, resources) so Stainless generates Terraform resources:
- cloudflare_share (full CRUD)
- cloudflare_share_recipient (create, read, delete, bulk-replace)
- cloudflare_share_resource (full CRUD)

Also adds the PUT /shares/{share_id}/recipients bulk-replace endpoint
to the recipients subresource.

Ref: GRM-887
* feat(dex): add device ISPs endpoint mapping

* feat(dex): move isps to DEX > devices > isps list resource

* feat(dex): add device ISPs endpoint mapping

Map GET /accounts/{account_id}/dex/devices/{device_id}/isps to
zero_trust.dex.device_isps.list for SDK generation.

Ref: APIX-630
@stainless-app stainless-app Bot force-pushed the release-please--branches--main--changes--next branch from fc13a05 to 015033c Compare June 11, 2026 19:19
musa-cf and others added 3 commits June 11, 2026 15:20
The regional_hostnames sub-resource was incorrectly removed in a curated
sync (923e0c4). The upstream aggregate schema and Stainless codegen
(stainless-sdks/cloudflare-python generated branch) both have these
endpoints. This restores the resource, types, and tests as-is from the
generated branch.

Restored:
- addressing.regional_hostnames (create, list, delete, edit, get)
- addressing.regional_hostnames.regions (list)
- All associated param/response types
- Tests for both resources
fix(addressing): restore regional_hostnames sub-resource
@stainless-app stainless-app Bot force-pushed the release-please--branches--main--changes--next branch from 015033c to ae0ce16 Compare June 11, 2026 20:41
@musa-cf musa-cf self-assigned this Jun 11, 2026
@musa-cf musa-cf merged commit 1a29404 into main Jun 11, 2026
13 checks passed
@musa-cf musa-cf deleted the release-please--branches--main--changes--next branch June 11, 2026 22:06
@stainless-app

stainless-app Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants