Skip to content

Releases: cloudflare/cloudflare-typescript

v5.1.0

Choose a tag to compare

@stainless-app stainless-app released this 12 Sep 17:35
5cebea6

5.1.0 (2025-09-12)

Full Changelog: v5.0.0...v5.1.0

Features

  • Merge branch 'vaishak/skip-worker-test' into 'main' (a556698)

Bug Fixes

  • coerce nullable values to undefined (7847e84)
  • correctly handle sending multipart/form-data requests with JSON (e9deab6)

Chores

  • ci build action (23d3577)
  • fix lint on the examples (dd14379)
  • fix lint on the examples (dd14379)
  • fix lint on the examples (5b2f145)
  • internal: codegen related update (2860479)

v5.0.0

Choose a tag to compare

@stainless-app stainless-app released this 02 Sep 20:15
83fb4ef

Full Changelog: v4.5.0...v5.0.0

This is a retroactive changelog for our v5.0.0 release. Cloudflare recognizes that the changelog originally published did not provide the detail needed for users to feel confident in this release and failed to outline the meaningful amount of breaking changes it included.

The large amount of breaking changes in this release are primarily due to a change in OpenAPI definitions, which our libraries are based off of, bug fixes and codegen updates that we rely on to read those OpenAPI definitions and produce our SDK libraries. As the codegen is always evolving and improving, so are our code bases.

Breaking Changes

Abuse Reports

  • create

    • reportType parameter changed from restricted literal union to generic string type
      • 'abuse_dmca' | 'abuse_trademark' | 'abuse_general' | 'abuse_phishing' | 'abuse_children' | 'abuse_threat' | 'abuse_registrar_whois' | 'abuse_ncsei' -> string
  • AbuseReportsChildrenAbuseReportAbuseReportsCsamReport

  • All Report Types

    • URL separator changed from space/newline to newline only in urls field
    • IP address separator changed from space/newline to newline only in source_ips and destination_ips fields
    • Each report type now requires a specific act value instead of a union of all types:
      • AbuseReportsDmcaReport.act: must be 'abuse_dmca'
      • AbuseReportsTrademarkReport.act: must be 'abuse_trademark'
      • AbuseReportsGeneralReport.act: must be 'abuse_general'
      • AbuseReportsPhishingReport.act: must be 'abuse_phishing'
      • AbuseReportsCsamReport.act: must be 'abuse_children'
      • AbuseReportsThreatReport.act: must be 'abuse_threat'
      • AbuseReportsRegistrarWhoisReport.act: must be 'abuse_registrar_whois'
      • AbuseReportsNcseiReport.act: must be 'abuse_ncsei'
  • AbuseReportsDmcaReport

    • agree: changed from 0 | 1 to 1
    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send'
    • owner_notification: changed from 'send' | 'send-anon' | 'none' to 'send'
    • Optional → Required: address1, agent_name, agree, city, country, original_work, signature, state, host_notification, owner_notification
    • Removed fields: destination_ips, justification, ncmec_notification, ncsei_subject_representation, ports_protocols, source_ips, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsTrademarkReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' only
    • owner_notification: changed from 'send' | 'send-anon' | 'none' to 'send' only
    • Optional → Required: host_notification, justification, owner_notification, trademark_number, trademark_office, trademark_symbol
    • Removed fields: address1, agent_name, agree, city, country, destination_ips, ncmec_notification, ncsei_subject_representation, original_work, ports_protocols, signature, source_ips, state
  • AbuseReportsGeneralReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • Optional → Required: host_notification, justification, owner_notification
    • Removed fields: address1, agent_name, agree, city, country, ncmec_notification, ncsei_subject_representation, original_work, signature, state, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsPhishingReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • owner_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • Optional → Required: host_notification, justification, owner_notification
    • Removed fields: address1, agent_name, agree, city, country, destination_ips, ncmec_notification, ncsei_subject_representation, ports_protocols, signature, source_ips, state, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsCsamReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • ncmec_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • Optional → Required: host_notification, justification, ncmec_notification, owner_notification
    • Removed fields: address1, agent_name, agree, city, destination_ips, ncsei_subject_representation, original_work, ports_protocols, signature, source_ips, state, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsThreatReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • owner_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • Optional → Required: host_notification, justification, owner_notification
    • Removed fields: address1, agent_name, agree, city, country, destination_ips, ncmec_notification, ncsei_subject_representation, original_work, ports_protocols, signature, source_ips, state, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsRegistrarWhoisReport

    • Optional → Required: owner_notification
    • Removed fields: address1, agent_name, agree, city, country, destination_ips, host_notification, justification, ncmec_notification, ncsei_subject_representation, original_work, ports_protocols, signature, source_ips, state, trademark_number, trademark_office, trademark_symbol
  • AbuseReportsNcseiReport

    • host_notification: changed from 'send' | 'send-anon' | 'none' to 'send' | 'send-anon' (removed 'none')
    • ncsei_subject_representation: changed from optional to required boolean
    • Optional → Required: host_notification, ncsei_subject_representation, owner_notification
    • Removed fields: address1, agent_name, agree, city, destination_ips, justification, ncmec_notification, original_work, ports_protocols, signature, source_ips, state, trademark_number, trademark_office, trademark_symbol

Accounts

  • Account
    • Added required field type: 'standard' | 'enterprise'
  • AccountUpdateParams.type
    • Added required field type: 'standard' | 'enterprise'
  • AuditListResponsesCursorLimitPaginationAuditListResponsesCursorPaginationAfter
    • AuditListParams: now extends CursorPaginationAfterParams instead of CursorLimitPaginationParams

Addressing

  • BGPPrefix.withdraw_if_no_routeBGPPrefix.auto_advertise_withdraw

  • BGPPrefixEditParams.withdraw_if_no_routeBGPPrefixEditParams.auto_advertise_withdraw

    Note: This is functionally a rename - the new auto_advertise_withdraw field provides the same functionality as the removed withdraw_if_no_route field.

AI

  • AssetCreateResponse: simplified from object to boolean success flag
    • { success: boolean } -> { id: string, bucket_name: string, created_at: string, file_name: string, finetune_id: string, modified_at: string }

Argo

  • SmartRoutingEditResponse: changed from unknown | string | null to structured interface
    • id: string
    • editable: boolean
    • value: 'on' | 'off'
    • modified_on?: string
  • SmartRoutingGetResponse: changed from unknown | string | null to structured interface
    • id: string
    • editable: boolean
    • value: 'on' | 'off'
    • modified_on?: string

Brand Protection

  • submit:
    • BrandProtectionSubmitParams: removed url parameter
    • Return type: SubmitBrandProtectionSubmitResponse
      • BrandProtectionSubmitResponse structure: { skipped_urls?: Array<{ [key: string]: unknown }>, submitted_urls?: Array<{ [key: string]: unknown }> }
  • urlInfo:
    • BrandProtectionURLInfoParams: removed url and url_id parameters
    • Return type changed from Core.APIPromise<Info> to Core.PagePromise<BrandProtectionURLInfoResponsesSinglePage, BrandProtectionURLInfoResponse>
      • Method now returns paginated results using SinglePage instead of a single object
      • BrandProtectionURLInfoResponse type: { [key: string]: unknown }
    • RuleMatchInfo.RuleMatch
    • ScanStatusInfo.ScanStatus
    • URLInfoModelResultsInfo.ModelResult

Cache

  • VariantEditResponse.value: changed from string to VariantEditResponse.Value
  • VariantGetResponse.value: changed from string to VariantGetResponse.Value
  • VariantGetResponse.Value:
    • avif?: Array<string>
    • bmp?: Array<string>
    • gif?: Array<string>
    • jp2?: Array<string>
    • jpeg?: Array<string>
    • jpg?: Array<string>
    • jpg2?: Array<string>
    • png?: Array<string>
    • tif?: Array<string>
    • tiff?: Array<string>
    • webp?: Array<string>

Cloudforce One

  • Insights class

    • Removed create method
    • Removed delete method
    • Removed edit method
    • Removed get method
    • Removed all associated response and parameter types
  • ThreatEventCreateResponse

    • removed fields id, accountId, indicator, indicatorTypeId, rawId, releasabilityId
  • ThreatEventListResponse.ThreatEvent

    • removed fields id, accountId, indicator, indicatorTypeId, rawId, releasabilityId
  • ThreatEventEditResponse

    • removed fields id, accountId, indicator, indicatorTypeId, rawId, releasabilityId
  • ThreatEventGetResponse

    • removed fields id, accountId, indicator, `indicat...
Read more

v4.5.0

Choose a tag to compare

@stainless-app stainless-app released this 16 Jul 21:36
bb67f21

4.5.0 (2025-07-16)

Full Changelog: v4.4.1...v4.5.0

Features

Bug Fixes

  • always use multipart/form-data for some endpoints (d4ce21e)
  • api: add missing items param (d9937a1)
  • ci: correct conditional (5257b08)
  • ci: release-doctor — report correct token name (c4f2ddf)
  • client: don't send Content-Type for bodyless methods (cdfc263)

Chores

  • api: Skip broken prism test for updating custom DLP entries (3c50a16)
  • api: skip broken prism tests (0f0ba6e)
  • api: TTL is required on DNS records (a492965)
  • ci: enable for pull requests (6898174)
  • ci: only run for pushes and fork pull requests (ed461eb)
  • internal: codegen related update (6a94ed9)
  • make some internal functions async (4e89649)
  • mention unit type in timeout docs (a5ad7f3)

v4.4.1

Choose a tag to compare

@stainless-app stainless-app released this 16 Jun 21:44
980edbf

4.4.1 (2025-06-16)

Full Changelog: v4.4.0...v4.4.1

Features

  • client: add support for endpoint-specific base URLs (f399656)

Bug Fixes

  • api: Update zone subscription paths (f0ff0b7)

v4.4.0

Choose a tag to compare

@stainless-app stainless-app released this 16 Jun 18:15
26c2dc7

4.4.0 (2025-06-16)

Full Changelog: v4.3.0...v4.4.0

Features

Bug Fixes

  • add back kv.namespaces bulk methods (d9218c8)
  • add missing properties (289d3da)
  • AI: Add explicit variant names for union types (9a0b96d)
  • api: 'name' and 'type' are required on dns_record (113bfec)
  • config: Diagnostic errors (383f29e)
  • DLP: Add explicit variant names (557a827)
  • publish script — handle NPM errors correctly (0c1aa10)
  • types: generate missing types (7e6a67f)
  • workers: send multipart as json (27be8af)

Chores

  • api: Fix config indentation (40aefb4)
  • api: Fix edge IPs variant names (73bf59d)
  • api: mark some methods as deprecated (d9a9e71)
  • docs: use top-level-await in example snippets (faf2d8e)
  • improve publish-npm script --latest tag logic (438a2ee)
  • internal: make base APIResource abstract (cec7bde)

v4.3.0

Choose a tag to compare

@stainless-app stainless-app released this 21 May 21:34
7c8244d

4.3.0 (2025-05-21)

Full Changelog: v4.2.0...v4.3.0

Features

Bug Fixes

  • api: fix path placeholders (61b35dd)
  • client: fix bug where subresource has the same name as its parent resource (1d17818)
  • client: reexported types for subresource with the same name as its parent (a91a792)
  • urlscanner: don't unwwrap scan response (643bd93)

Chores

  • ci: bump node version for release workflows (57c53b4)
  • docs: add missing deprecation warnings (6ddef2c)

Documentation

v4.2.0

Choose a tag to compare

@stainless-app stainless-app released this 18 Mar 04:43
f2ce1b4

4.2.0 (2025-03-18)

Full Changelog: v4.1.0...v4.2.0

Features

Read more

v4.1.0

Choose a tag to compare

@stainless-app stainless-app released this 11 Feb 03:35
d9aca69

4.1.0 (2025-02-11)

Full Changelog: v4.0.0...v4.1.0

Features

Read more

v4.0.0

Choose a tag to compare

@stainless-app stainless-app released this 14 Jan 19:09
63571df

4.0.0 (2025-01-14)

Full Changelog: v3.5.0...v4.0.0

⚠ BREAKING CHANGES

  • addressing: reshuffle relationship in the namespace to align with the product (#2290)
  • r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2279)
  • r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2278)
  • r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2277)
  • loa_documents: move download subresource into parent as get (#2274)
  • addressing: move service bindings to dedicated namespace (#2273)
  • ai: move to dedicated namespace (#2241)
  • kv: move analytics under existing namespace (#2212)
  • zone_transfers: move under DNS namespace (#2208)
  • dnssec: move under DNS namespace (#2207)
  • url_scanner: swap all methods to be v2 only (#2206)
  • warp_connector: move under zero trust namespace (#2195)
  • calls: split turn and sfu apps (#2099)

Features

Read more

v3.5.0

Choose a tag to compare

@stainless-app stainless-app released this 16 Jul 23:54
48219c8

3.5.0 (2024-07-16)

Warning

v3.x of this library is a ground-up rewrite of the SDK, using code generation from our OpenAPI spec.

This package should be in a usable state for many projects, but expect frequent minor breaking
changes as we rename methods and types. If this isn't suitable for you project, we recommend
pinning to a specific version until you have time to perform an upgrade.

Full Changelog: v3.4.0...v3.5.0

Features

  • api: OpenAPI spec update via Stainless API (b67cbd4)
  • api: OpenAPI spec update via Stainless API (0573c9a)
  • api: OpenAPI spec update via Stainless API (c0a336b)
  • api: OpenAPI spec update via Stainless API (66bb2da)
  • api: OpenAPI spec update via Stainless API (ce4dc99)
  • api: OpenAPI spec update via Stainless API (5dd6ed3)
  • api: OpenAPI spec update via Stainless API (c484d6d)
  • api: OpenAPI spec update via Stainless API (530ae23)
  • api: OpenAPI spec update via Stainless API (d90fb99)
  • api: OpenAPI spec update via Stainless API (a015022)
  • api: OpenAPI spec update via Stainless API (cae94d5)
  • api: OpenAPI spec update via Stainless API (57b19a2)
  • api: OpenAPI spec update via Stainless API (1024eed)
  • api: OpenAPI spec update via Stainless API (ad35a00)
  • api: OpenAPI spec update via Stainless API (d6bc55c)
  • api: OpenAPI spec update via Stainless API (846ba4c)
  • api: OpenAPI spec update via Stainless API (3589da0)
  • api: OpenAPI spec update via Stainless API (7c82074)
  • api: OpenAPI spec update via Stainless API (9a7bac3)
  • api: OpenAPI spec update via Stainless API (4a53973)
  • api: OpenAPI spec update via Stainless API (d3d3125)
  • api: OpenAPI spec update via Stainless API (e9898ce)
  • api: OpenAPI spec update via Stainless API (d4540be)
  • api: OpenAPI spec update via Stainless API (35596a7)
  • api: OpenAPI spec update via Stainless API (9951ec9)
  • api: OpenAPI spec update via Stainless API (5b2b222)
  • api: OpenAPI spec update via Stainless API (6080523)
  • api: OpenAPI spec update via Stainless API (145d3eb)
  • api: OpenAPI spec update via Stainless API (b23a5e1)
  • api: OpenAPI spec update via Stainless API (5e17f09)
  • api: OpenAPI spec update via Stainless API (3d2c2b2)
  • api: OpenAPI spec update via Stainless API (7559904)
  • api: OpenAPI spec update via Stainless API (bbe6b56)
  • api: OpenAPI spec update via Stainless API (2104c24)
  • api: OpenAPI spec update via Stainless API (fbcfc52)
  • api: OpenAPI spec update via Stainless API (60dafc2)
  • api: OpenAPI spec update via Stainless API (05675d4)
  • api: OpenAPI spec update via Stainless API (e0ac3b1)
  • api: OpenAPI spec update via Stainless API (368febc)
  • api: OpenAPI spec update via Stainless API (fcc6b93)
  • api: OpenAPI spec update via Stainless API (0ab426d)
  • api: OpenAPI spec update via Stainless API (6523582)
  • api: OpenAPI spec update via Stainless API (a30adfb)
  • api: OpenAPI spec update via Stainless API (de5a8db)
  • api: OpenAPI spec update via Stainless API (876d149)
  • api: OpenAPI spec update via Stainless API (eb1dbc3)
  • api: OpenAPI spec update via Stainless API (0334d44)
  • api: OpenAPI spec update via Stainless API (e093869)
  • api: OpenAPI spec update via Stainless API (ad2584c)
  • api: OpenAPI spec update via Stainless API (1dc01be)
  • api: OpenAPI spec update via Stainless API (c32f63f)
  • api: OpenAPI spec update via Stainless API (52dac9a)
  • api: OpenAPI spec update via Stainless API (bf9ea87)
  • api: OpenAPI spec update via Stainless API (979f007)
  • api: OpenAPI spec update via Stainless API (daaa821)
  • api: OpenAPI spec update via Stainless API (8df2fc5)
  • api: OpenAPI spec update via Stainless API (bdd578b)
  • api: OpenAPI spec update via Stainless API ([9c4f4a9](9c4f4a9...
Read more