Overview
The v6 release includes:- Type safety improvements with discriminated unions
- Parameter requirement changes across multiple services
- Interface renames and restructuring
- Removal of deprecated features
- New pagination patterns
Most breaking changes stem from OpenAPI definition updates that improve type safety and API accuracy. Take time to review each section relevant to your implementation.
Breaking changes by service
Addressing
Parameter requirement changes
Several parameters have changed from optional to required, or had their types refined:BGPPrefix and ServiceBinding changes
BGPPrefix and ServiceBinding changes
BGPPrefixCreateParams.cidr: optional → requiredPrefixCreateParams.asn:number | null→numberPrefixCreateParams.loa_document_id: required → optionalServiceBindingCreateParams.cidr: optional → requiredServiceBindingCreateParams.service_id: optional → required
API Gateway
Type renames and parameter changes improve consistency:ConfigurationUpdateResponseremovedPublicSchema→OldPublicSchemaSchemaUpload→UserSchemaCreateResponseConfigurationUpdateParams.propertiesremoved; usenormalizeinstead
CloudforceOne
Response type changes for bulk operations:Bulk create response structure
Bulk create response structure
counts and errors fields instead of a simple number.D1 Database
Query parameter types now support batch operations:DatabaseQueryParams: simple interface → union type (D1SingleQuery | MultipleQueries)DatabaseRawParams: same change- Supports batch queries via
batcharray
DNS Records
All DNS record type interfaces have been renamed from long names to short codes:DNS record type renames (21 types)
DNS record type renames (21 types)
ARecord→AAAAARecord→AAAACNAMERecord→CNAMEMXRecord→MXNSRecord→NSPTRRecord→PTRTXTRecord→TXTCAARecord→CAACERTRecord→CERTDNSKEYRecord→DNSKEYDSRecord→DSHTTPSRecord→HTTPSLOCRecord→LOCNAPTRRecord→NAPTRSMIMEARecord→SMIMEASRVRecord→SRVSSHFPRecord→SSHFPSVCBRecord→SVCBTLSARecord→TLSAURIRecord→URIOpenpgpkeyRecord→Openpgpkey
IAM Resource Groups
Field requirement changes:ResourceGroupCreateResponse.scope: optional single → required arrayResourceGroupCreateResponse.id: optional → required
Origin CA Certificates
Several optional parameters are now required:OriginCACertificateCreateParams.csr: optional → requiredOriginCACertificateCreateParams.hostnames: optional → requiredOriginCACertificateCreateParams.request_type: optional → required
Pages
Type renames and domain field changes:- Renamed:
DeploymentsSinglePage→DeploymentListResponsesV4PagePaginationArray - Domain response fields: many optional → required
Pipelines
Major version upgrade from v0 to v1 API:R2
Parameter requirement changes:EventNotificationUpdateParams.rules: optional → required- Super Slurper:
bucket,secretnow required in source params
Radar
Typed enums and signature changes:Enum type changes
Enum type changes
dataSource:string→ typed enum (23 values)eventType:string→ typed enum (6 values)
Resource Sharing
Field removal:- Removed:
status_messagefield from all recipient response types
Schema Validation
Response type consolidation:- Consolidated
SchemaCreateResponse,SchemaListResponse,SchemaEditResponse,SchemaGetResponse→PublicSchema - Renamed:
SchemaListResponsesV4PagePaginationArray→PublicSchemasV4PagePaginationArray
Spectrum
Union member renames:AppListResponse.UnionMember0→SpectrumConfigAppConfigAppListResponse.UnionMember1→SpectrumConfigPaygoAppConfig
Workers
Type removals and renames:- Removed:
WorkersBindingKindTailConsumertype - Renamed:
ScriptsSinglePage→ScriptListResponsesSinglePage - Removed:
DeploymentsSinglePage
Zero Trust DLP
Return type changes:datasets.create(),update(),get()return types changedPredefinedGetResponseunion members renamed toUnionMember0-5
Zero Trust Tunnels
Response type removals:- Removed all
Cloudflared*Responsetypes - Removed:
CloudflaredListResponsesV4PagePaginationArray
New features in v6
While v6 includes many breaking changes, it also introduces powerful new capabilities across the SDK.
New top-level resources
Abuse Reports
Abuse Reports
- Reports:
create,list,get - Mitigations: sub-resource for abuse mitigations
AI Search
AI Search
- Instances:
create,update,list,delete,read,stats - Items:
list,get - Jobs:
create,list,get,logs - Tokens:
create,update,list,delete,read
Connectivity
Connectivity
- Directory Services:
create,update,list,delete,get - Supports IPv4, IPv6, dual-stack, and hostname configurations
Organizations
Organizations
- Organizations:
create,update,list,delete,get - OrganizationProfile:
update,get - Hierarchical organization support with parent/child relationships
R2 Data Catalog
R2 Data Catalog
- Catalog:
list,enable,disable,get - Credentials:
create - MaintenanceConfigs:
update,get - Namespaces:
list - Tables:
list, maintenance config management - Apache Iceberg integration
Realtime Kit
Realtime Kit
- Apps:
get,post - Meetings:
create,get, participant management - Livestreams: 10+ methods for streaming
- Recordings: start, pause, stop, get
- Sessions: transcripts, summaries, chat
- Webhooks: full CRUD
- ActiveSession: polls, kick participants
- Analytics: organization analytics
Token Validation
Token Validation
- Configuration:
create,list,delete,edit,get - Credentials:
update - Rules:
create,list,delete,bulkCreate,bulkEdit,edit,get - JWT validation with RS256/384/512, PS256/384/512, ES256, ES384
Enhanced existing resources
D1 Time Travel
D1 Time Travel
Point-in-time recovery capabilities:
Queues Subscriptions
Queues Subscriptions
Event subscriptions from multiple sources:Supported event sources: Images, KV, R2, Vectorize, Workers AI, Workers Builds, Workflows
Workers Observability
Workers Observability
New observability settings:
Zero Trust AI Controls / MCP
Zero Trust AI Controls / MCP
Model Context Protocol support:
Migration checklist
Audit your current usage
Review which Cloudflare services your application uses and check the breaking changes for each.
Update method calls
- Add required parameters where needed
- Update pagination patterns
- Migrate from deprecated methods (e.g., Pipelines v0 → v1)
Test thoroughly
Run your test suite to ensure all functionality works as expected with the new types and behaviors.
Common patterns
Handling discriminated unions
Many response types are now discriminated unions for better type safety:Updated pagination
Some resources have changed pagination types:Required vs optional parameters
Many parameters have changed from optional to required. Always check the TypeScript types to see what’s required:Getting help
If you encounter issues during migration:- Check the full CHANGELOG for detailed change information
- Review the TypeScript SDK documentation
- Open an issue on GitHub if you find bugs or have questions
Remember that v6.0.0-beta.1 is in Beta. Please report any issues you encounter to help improve the release.