API Reference
Libraries
API Overview
Accounts
List Accounts
Account Details
Create an account
Update Account
Delete a specific account
AccountsAccount Organizations
Move account
AccountsAccount Profile
Get account profile
Modify account profile
AccountsMembers
List Members
Member Details
Add Member
Update Member
Remove Member
AccountsRoles
List Roles
Role Details
AccountsSubscriptions
List Subscriptions
Create Subscription
Update Subscription
Delete Subscription
AccountsTokens
List Tokens
Token Details
Create Token
Update Token
Delete Token
Verify Token
AccountsTokensPermission Groups
List Permission Groups
List Permission Groups
AccountsTokensValue
Roll Token
AccountsLogs
AccountsLogsAudit
Get account audit logs (Version 2)
Get resource change history from an account audit log entry (Version 2)
List account audit log product categories (Version 2)
Organizations
List organizations the user has access to
Get organization
Create organization
Modify organization.
Delete organization.
OrganizationsOrganization Accounts
Get organization accounts
OrganizationsOrganization Profile
Get organization profile
Modify organization profile.
OrganizationsMembers
List organization members
Get organization member
Create organization member
Delete organization member
OrganizationsLogs
OrganizationsLogsAudit
Get organization audit logs (Version 2)
Get resource change history from an organization audit log entry (Version 2)
OrganizationsBilling
OrganizationsBillingUsage
Get Organization Usage (Version 2, Alpha, Restricted)
Tenants
Get tenant
TenantsAccount Types
Get tenant account types
TenantsAccounts
List tenant accounts
TenantsEntitlements
List tenant entitlements
TenantsMemberships
List tenant memberships
Origin CA Certificates
List Certificates
Get Certificate
Create Certificate
Revoke Certificate
IPs
Memberships
List Memberships
Membership Details
Update Membership
Delete Membership
User
User Details
Edit User
UserAudit Logs
Get user audit logs
UserBilling
UserBillingHistory
UserBillingProfile
UserInvites
List Invitations
Invitation Details
Respond to Invitation
UserOrganizations
UserSubscriptions
Get User Subscriptions
Update User Subscription
Delete User Subscription
UserTenants
List user tenants
UserTokens
List Tokens
Token Details
Create Token
Update Token
Delete Token
Verify Token
UserTokensPermission Groups
List Token Permission Groups
UserTokensValue
Roll Token
Zones
List Zones
Zone Details
Create Zone
Edit Zone
Delete Zone
ZonesActivation Check
Rerun the Activation Check
ZonesSettings
Get zone setting
Edit zone setting
ZonesEnvironments
List zone environments
Create zone environments
Upsert zone environments
Partially update zone environments
Delete zone environment
Roll back zone environment
ZonesCustom Nameservers
ZonesHolds
Get Zone Hold
Create Zone Hold
Update Zone Hold
Remove Zone Hold
ZonesSubscriptions
Zone Subscription Details
Create Zone Subscription
Update Zone Subscription
ZonesPlans
List Available Plans
Available Plan Details
ZonesRate Plans
List Available Rate Plans
ZonesCT
ZonesCTAlerting
Get CT Alerting Subscription
Update CT Alerting Subscription
Load Balancers
Load BalancersMonitors
List Monitors
Monitor Details
Create Monitor
Update Monitor
Patch Monitor
Delete Monitor
Load BalancersMonitorsPreviews
Preview Monitor
Load BalancersMonitorsReferences
List Monitor References
Load BalancersMonitor Groups
List Monitor Groups
Monitor Group Details
Create Monitor Group
Update Monitor Group
Patch Monitor Group
Delete Monitor Group
Load BalancersMonitor GroupsReferences
List Monitor Group References
Load BalancersPools
List Pools
Pool Details
Create Pool
Update Pool
Patch Pool
Delete Pool
Patch Pools
Load BalancersPoolsHealth
Pool Health Details
Preview Pool
Load BalancersPoolsReferences
List Pool References
Load BalancersPreviews
Preview Result
Load BalancersRegions
List Regions
Get Region
Load BalancersSearches
Search Resources
Cache
Purge Cached Content
Purge Cached Content by Environment
CacheCache Reserve
Get Cache Reserve setting
Change Cache Reserve setting
Get Cache Reserve Clear
Start Cache Reserve Clear
CacheSmart Tiered Cache
Get Smart Tiered Cache setting
Create Smart Tiered Cache setting
Patch Smart Tiered Cache setting
Delete Smart Tiered Cache setting
CacheVariants
Get variants setting
Change variants setting
Delete variants setting
CacheRegional Tiered Cache
Get Regional Tiered Cache setting
Change Regional Tiered Cache setting
CacheOrigin Cloud Regions
List origin cloud region mappings
Get an origin cloud region mapping
Create or replace an origin cloud region mapping
Delete an origin cloud region mapping
Batch create or replace origin cloud region mappings
Batch delete origin cloud region mappings
List supported cloud vendors and regions
Create or update an origin cloud region mapping
Get an origin cloud region mapping
Delete an origin cloud region mapping
Batch create or update origin cloud region mappings
Batch delete origin cloud region mappings
List supported cloud vendors and regions
SSL
SSLAnalyze
Analyze Certificate
SSLCertificate Packs
List Certificate Packs
Get Certificate Pack
Order Advanced Certificate Manager Certificate Pack
Restart Validation or Update Advanced Certificate Manager Certificate Pack
Delete Advanced Certificate Manager Certificate Pack
SSLCertificate PacksQuota
Get Certificate Pack Quotas
SSLRecommendations
SSLAutomatic Upgrader
Get Automatic SSL/TLS enrollment status for the given zone
Patch Automatic SSL/TLS Enrollment status for given zone
SSLAuto Origin TLS Kex
Get Auto-Origin TLS KEX enrollment status for the given zone
Patch Auto-Origin TLS KEX enrollment status for the given zone
SSLUniversal
SSLUniversalSettings
Universal SSL Settings Details
Edit Universal SSL Settings
SSLVerification
SSL Verification Details
Edit SSL Certificate Pack Validation Method
ACM
ACMTotal TLS
Total TLS Settings Details
Enable or Disable Total TLS
Enable or Disable Total TLS
ACMCustom Trust Store
List Custom Origin Trust Store Details
Upload Custom Origin Trust Store
Custom Origin Trust Store Details
Delete Custom Origin Trust Store
Analytics Query
Query analytics summary
Query analytics timeseries
Query analytics top-N
Analytics QueryData Security
Analytics QueryData SecurityContent Findings
Top integrations by content findings
Analytics QueryData SecurityFindings
Data security findings summary
Data security findings timeseries
Argo
ArgoSmart Routing
Get Argo Smart Routing setting
Patch Argo Smart Routing setting
ArgoTiered Caching
Get Tiered Caching setting
Patch Tiered Caching setting
Certificate Authorities
Certificate AuthoritiesHostname Associations
List Hostname Associations
Replace Hostname Associations
Client Certificates
List Client Certificates
Client Certificate Details
Create Client Certificate
Reactivate Client Certificate
Revoke Client Certificate
Custom Certificates
List SSL Configurations
SSL Configuration Details
Create SSL Configuration
Edit SSL Configuration
Delete SSL Configuration
Custom CertificatesPrioritize
Re-prioritize SSL Certificates
Custom Csrs
List Custom CSRs
Create Custom CSR
Custom CSR Details
Delete Custom CSR
Custom Hostnames
List Custom Hostnames
Custom Hostname Details
Create Custom Hostname
Edit Custom Hostname
Delete Custom Hostname (and any issued SSL certificates)
Custom HostnamesFallback Origin
Get Fallback Origin for Custom Hostnames
Update Fallback Origin for Custom Hostnames
Delete Fallback Origin for Custom Hostnames
Custom HostnamesCertificate Pack
Custom HostnamesCertificate PackCertificates
Replace Custom Certificate and Custom Key In Custom Hostname
Delete Single Certificate And Key For Custom Hostname
Account Custom Nameservers
List Account Custom Nameservers
Add Account Custom Nameserver
Delete Account Custom Nameserver
Tenant Custom Nameservers
List Tenant Custom Nameservers
Add Tenant Custom Nameserver
Delete Tenant Custom Nameserver
DNS Firewall
List DNS Firewall Clusters
DNS Firewall Cluster Details
Create DNS Firewall Cluster
Update DNS Firewall Cluster
Delete DNS Firewall Cluster
DNS FirewallAnalytics
DNS FirewallAnalyticsReports
Table
DNS FirewallAnalyticsReportsBytimes
By Time
DNS FirewallReverse DNS
Show DNS Firewall Cluster Reverse DNS
Update DNS Firewall Cluster Reverse DNS
DNS
DNSDNSSEC
DNSSEC Details
Edit DNSSEC Status
Delete DNSSEC records
DNSRecords
List DNS Records
DNS Record Details
Create DNS Record
Overwrite DNS Record
Update DNS Record
Delete DNS Record
Export DNS Records
Import DNS Records
Trigger DNS Record Scan
Review Scanned DNS Records
List Scanned DNS Records
Batch DNS Records
DNSUsage
DNSUsageZone
Get DNS Record Usage
DNSUsageAccount
Get DNS Record Usage for Account
DNSSettings
DNSSettingsZone
Show DNS Settings
Update DNS Settings
DNSSettingsAccount
Show DNS Settings
Update DNS Settings
DNSSettingsAccountViews
List Internal DNS Views
DNS Internal View Details
Create Internal DNS View
Update Internal DNS View
Delete Internal DNS View
DNSAnalytics
DNSAnalyticsReports
Table
DNSAnalyticsReportsBytimes
By Time
DNSZone Transfers
DNSZone TransfersForce AXFR
Force AXFR
DNSZone TransfersIncoming
Secondary Zone Configuration Details
Create Secondary Zone Configuration
Update Secondary Zone Configuration
Delete Secondary Zone Configuration
DNSZone TransfersOutgoing
Primary Zone Configuration Details
Create Primary Zone Configuration
Update Primary Zone Configuration
Delete Primary Zone Configuration
Disable Outgoing Zone Transfers
Enable Outgoing Zone Transfers
Force DNS NOTIFY
DNSZone TransfersOutgoingStatus
Get Outgoing Zone Transfer Status
DNSZone TransfersACLs
List ACLs
ACL Details
Create ACL
Update ACL
Delete ACL
DNSZone TransfersPeers
List Peers
Peer Details
Create Peer
Update Peer
Delete Peer
DNSZone TransfersTSIGs
List TSIGs
TSIG Details
Create TSIG
Update TSIG
Delete TSIG
Email Security
Email SecurityInvestigate
Search email messages
Get message details
Email SecurityInvestigateDetections
Get message detection details
Email SecurityInvestigatePreview
Get email preview
Preview for non-detection messages
Email SecurityInvestigateRaw
Get raw email content
Email SecurityInvestigateTrace
Get email trace
Email SecurityInvestigateMove
Move a message
Move multiple messages
Email SecurityInvestigateReclassify
Change email classification
Email SecurityInvestigateRelease
Release messages from quarantine
Email SecurityInvestigateBulk
List bulk action jobs
Create a bulk action job
Get bulk action job details
Delete a bulk action job
Email SecurityInvestigateBulkCancel
Cancel a bulk action job
Email SecurityInvestigateBulkMessages
List messages for a bulk action job
Email SecurityPhishguard
Email SecurityPhishguardReports
Get PhishGuard reports
Email SecuritySettings
Email SecuritySettingsAllow Policies
List email allow policies
Get an email allow policy
Create email allow policy
Update an email allow policy
Delete an email allow policy
Email SecuritySettingsBlock Senders
List blocked email senders
Get a blocked email sender
Create blocked email sender
Update a blocked email sender
Delete a blocked email sender
Email SecuritySettingsDomains
List protected email domains
Get an email domain
Update an email domain
Unprotect an email domain
Unprotect multiple email domains
Email SecuritySettingsImpersonation Registry
List entries in impersonation registry
Get an impersonation registry entry
Create impersonation registry entry
Update an impersonation registry entry
Delete an impersonation registry entry
Email SecuritySettingsSending Domain Restrictions
List sending domain restrictions
Get a sending domain restriction
Create a sending domain restriction
Update a sending domain restriction
Delete a sending domain restriction
Email SecuritySettingsTrusted Domains
List trusted email domains
Get a trusted email domain
Create trusted email domain
Update a trusted email domain
Delete a trusted email domain
Email SecuritySettingsURL Ignore Patterns
List URL ignore patterns
Get a URL ignore pattern
Create a URL ignore pattern
Update a URL ignore pattern
Delete a URL ignore pattern
Email SecuritySubmissions
Get reclassify submissions
Email Auth
Email AuthDMARC Reports
Get DMARC Report Status
Configure DMARC Reports
Email AuthSPF
Email AuthSPFInspect
Inspect SPF Record
Email Routing
Get Email Routing settings
Update Email Routing settings
Update Email Routing settings
Email RoutingDNS
Email Routing - DNS settings
Enable Email Routing
Unlock Email Routing
Disable Email Routing
Email RoutingRules
List account or zone routing rules
Get routing rule
Create routing rule
Update routing rule
Delete routing rule
Email RoutingRulesCatch Alls
Get catch-all rule
Update catch-all rule
Email RoutingAccount Rules
List account or zone routing rules
Email RoutingAddresses
List destination addresses
Get a destination address
Create a destination address
Update destination address
Delete destination address
Email Sending
Send an email
Send a raw MIME email
Email SendingSubdomains
List sending subdomains
Get a sending subdomain
Create a sending subdomain
Delete a sending subdomain
Email SendingSubdomainsDNS
Get sending subdomain DNS records
Filters
Firewall
FirewallLockdowns
List Zone Lockdown rules
Get a Zone Lockdown rule
Create a Zone Lockdown rule
Update a Zone Lockdown rule
Delete a Zone Lockdown rule
FirewallRules
FirewallAccess Rules
List IP Access rules
Get an IP Access rule
Create an IP Access rule
Update an IP Access rule
Delete an IP Access rule
FirewallUA Rules
List User Agent Blocking rules
Get a User Agent Blocking rule
Create a User Agent Blocking rule
Update a User Agent Blocking rule
Delete a User Agent Blocking rule
FirewallWAF
FirewallWAFOverrides
FirewallWAFPackages
FirewallWAFPackagesGroups
Get a WAF rule group
Update a WAF rule group
FirewallWAFPackagesRules
Healthchecks
List Health Checks
Health Check Details
Create Health Check
Update Health Check
Patch Health Check
Delete Health Check
HealthchecksPreviews
Health Check Preview Details
Create Preview Health Check
Delete Preview Health Check
Keyless Certificates
List Keyless SSL Configurations
Get Keyless SSL Configuration
Create Keyless SSL Configuration
Edit Keyless SSL Configuration
Delete Keyless SSL Configuration
Logpush
LogpushDatasets
LogpushDatasetsFields
List fields
LogpushDatasetsJobs
List Logpush jobs for a dataset
LogpushEdge
List Instant Logs jobs
Create Instant Logs job
LogpushJobs
List Logpush jobs
Get Logpush job details
Create Logpush job
Update Logpush job
Delete Logpush job
LogpushOwnership
Get ownership challenge
Validate ownership challenge
LogpushValidate
Validate destination
Check destination exists
Validate origin
Logs
LogsLog Explorer
LogsLog ExplorerQuery
Run a log query
LogsLog ExplorerDatasets
List account or zone datasets
Get an account or zone dataset
Create an account or zone dataset
Update an account or zone dataset
LogsLog ExplorerDatasetsAvailable
List available account or zone datasets
LogsControl
LogsControlRetention
Get log retention flag
Update log retention flag
LogsControlCmb
LogsControlCmbConfig
Get CMB config
Update CMB config
Delete CMB config
LogsRayID
Get logs RayIDs
LogsReceived
Get logs received
LogsReceivedFields
List fields
Origin TLS Client Auth
Origin TLS Client AuthZone Certificates
List Certificates
Get Certificate Details
Upload Certificate
Delete Certificate
Origin TLS Client AuthHostnames
Get the Hostname Status for Client Authentication
Enable or Disable a Hostname for Client Authentication
Origin TLS Client AuthHostname Certificates
List Certificates
Get the Hostname Client Certificate
Upload a Hostname Client Certificate
Delete Hostname Client Certificate
Origin TLS Client AuthSettings
Get Enablement Setting for Zone
Set Enablement for Zone
Page Rules
List Page Rules
Get a Page Rule
Create a Page Rule
Update a Page Rule
Edit a Page Rule
Delete a Page Rule
Rate Limits
Smart Shield
Get Smart Shield Settings
Patch Smart Shield Settings
Smart ShieldHealth Checks
List Health Checks
Health Check Details
Create Health Check
Update Health Check
Patch Health Check
Delete Health Check
Smart ShieldCache Reserve Clear
Get Cache Reserve Clear
Start Cache Reserve Clear
Waiting Rooms
List waiting rooms for account or zone
Waiting room details
Create waiting room
Update waiting room
Patch waiting room
Delete waiting room
Waiting RoomsPage
Create a custom waiting room page preview
Waiting RoomsEvents
List events
Event details
Create event
Update event
Patch event
Delete event
Waiting RoomsEventsDetails
Preview active event details
Waiting RoomsRules
List Waiting Room Rules
Create Waiting Room Rule
Replace Waiting Room Rules
Patch Waiting Room Rule
Delete Waiting Room Rule
Waiting RoomsStatuses
Get waiting room status
Waiting RoomsSettings
Get zone-level Waiting Room settings
Update zone-level Waiting Room settings
Patch zone-level Waiting Room settings
Web3
Web3Hostnames
List Web3 Hostnames
Web3 Hostname Details
Create Web3 Hostname
Edit Web3 Hostname
Delete Web3 Hostname
Web3HostnamesIPFS Universal Paths
Web3HostnamesIPFS Universal PathsContent Lists
IPFS Universal Path Gateway Content List Details
Update IPFS Universal Path Gateway Content List
Web3HostnamesIPFS Universal PathsContent ListsEntries
List IPFS Universal Path Gateway Content List Entries
IPFS Universal Path Gateway Content List Entry Details
Create IPFS Universal Path Gateway Content List Entry
Edit IPFS Universal Path Gateway Content List Entry
Delete IPFS Universal Path Gateway Content List Entry
Workers
WorkersBeta
WorkersBetaWorkers
List Workers
Get Worker
Create Worker
Update Worker
Edit Worker
Delete Worker
WorkersBetaWorkersVersions
List Versions
Get Version
Create Version
Delete Version
WorkersRoutes
List Routes
Get Route
Create Route
Update Route
Delete Route
WorkersAssets
WorkersAssetsUpload
Upload Assets
WorkersScripts
List Workers
Search Workers
Download Worker
Upload Worker Module
Delete Worker
WorkersScriptsAssets
WorkersScriptsAssetsUpload
Create Assets Upload Session
WorkersScriptsSubdomain
Get Worker subdomain
Post Worker subdomain
Delete Worker subdomain
WorkersScriptsSchedules
Get Cron Triggers
Update Cron Triggers
WorkersScriptsTail
List Tails
Start Tail
Delete Tail
WorkersScriptsContent
Get script content
Put script content
WorkersScriptsSettings
Get Script Settings
Patch Script Settings
WorkersScriptsDeployments
List Deployments
Create Deployment
Get Deployment
Delete Deployment
WorkersScriptsVersions
List Versions
Get Version Detail
Upload Version
WorkersScriptsSecrets
List script secrets
Get secret binding
Add script secret
Delete script secret
Patch multiple script secrets
WorkersScriptsScript And Version Settings
Get Settings
Patch Settings
WorkersAccount Settings
Fetch Worker Account Settings
Create Worker Account Settings
WorkersDomains
List Domains
Get Domain
Attach Domain
Detach Domain
WorkersSubdomains
Get Subdomain
Create Subdomain
Delete Subdomain
WorkersObservability
WorkersObservabilityTelemetry
List keys
Run a query
List values
Prepare live tail
Live tail heartbeat
WorkersObservabilityDestinations
Get Destinations
Create Destination
Update Destination
Delete Destination
WorkersObservabilityQueries
Save query
List queries
WorkersObservabilityShared Queries
Create a sharable link to a query result
View a query that has been shared
KV
KVNamespaces
List Namespaces
Get a Namespace
Create a Namespace
Rename a Namespace
Remove a Namespace
Write multiple key-value pairs
Delete multiple key-value pairs
Get multiple key-value pairs
KVNamespacesKeys
List a Namespace's Keys
Write multiple key-value pairs
Delete multiple key-value pairs
Get multiple key-value pairs
KVNamespacesMetadata
Read the metadata for a key
KVNamespacesValues
Read key-value pair
Write key-value pair with optional metadata
Delete key-value pair
Durable Objects
Durable ObjectsNamespaces
List Namespaces
Durable ObjectsNamespacesObjects
List Objects
Queues
List Queues
Get Queue
Get Queue Metrics
Create Queue
Update Queue
Update Queue
Delete Queue
QueuesMessages
Push Message
Acknowledge + Retry Queue Messages
Pull Queue Messages
Push Message Batch
QueuesPurge
Get Queue Purge Status
Purge Queue
QueuesConsumers
List Queue Consumers
Get Queue Consumer
Create a Queue Consumer
Update Queue Consumer
Delete Queue Consumer
QueuesSubscriptions
List Event Subscriptions
Get Event Subscription
Create Event Subscription
Update Event Subscription
Delete Event Subscription
API Gateway
API GatewayConfigurations
Retrieve information about specific configuration properties
Update configuration properties
API GatewayDiscovery
Retrieve discovered operations on a zone rendered as OpenAPI schemas
API GatewayDiscoveryOperations
Retrieve discovered operations on a zone
Patch discovered operations
API GatewayLabels
Retrieve all labels
API GatewayLabelsUser
Create user labels
Delete user labels
Retrieve user label
Update user label
Patch user label
Delete user label
API GatewayLabelsUserResources
API GatewayLabelsUserResourcesOperation
Replace operation(s) attached to a user label
API GatewayLabelsManaged
Retrieve managed label
API GatewayLabelsManagedResources
API GatewayLabelsManagedResourcesOperation
Replace operation(s) attached to a managed label
API GatewayOperations
Retrieve information about all operations on a zone
Retrieve information about an operation
Add one operation to a zone
Delete an operation
Add operations to a zone
Delete multiple operations
API GatewayOperationsLabels
Replace label(s) on an operation in endpoint management
Attach label(s) on an operation in endpoint management
Remove label(s) on an operation in endpoint management
Bulk replace label(s) on operation(s) in endpoint management
Bulk attach label(s) on operation(s) in endpoint management
Bulk remove label(s) on operation(s) in endpoint management
API GatewayOperationsSchema Validation
Retrieve operation-level schema validation settings
Update operation-level schema validation settings
Update multiple operation-level schema validation settings
API GatewaySchemas
Retrieve operations and features as OpenAPI schemas
API GatewaySettings
API GatewaySettingsSchema Validation
Retrieve zone level schema validation settings
Update zone level schema validation settings
Update zone level schema validation settings
API GatewayUser Schemas
Retrieve information about all schemas on a zone
Retrieve information about a specific schema on a zone
API GatewayUser SchemasOperations
Retrieve all operations from a schema.
API GatewayUser SchemasHosts
API GatewayExpression Template
API GatewayExpression TemplateFallthrough
Generate fallthrough WAF expression template from a set of API hosts
Managed Transforms
List Managed Transforms
Update Managed Transforms
Delete Managed Transforms
Page Shield
Get Page Shield settings
Update Page Shield settings
Page ShieldPolicies
List Page Shield policies
Get a Page Shield policy
Create a Page Shield policy
Update a Page Shield policy
Delete a Page Shield policy
Page ShieldConnections
List Page Shield connections
Get a Page Shield connection
Page ShieldScripts
List Page Shield scripts
Get a Page Shield script
Page ShieldCookies
List Page Shield Cookies
Get a Page Shield cookie
Rulesets
List account or zone rulesets
Get an account or zone ruleset
Create an account or zone ruleset
Update an account or zone ruleset
Delete an account or zone ruleset
RulesetsPhases
Get an account or zone entry point ruleset
Update an account or zone entry point ruleset
RulesetsPhasesVersions
List an account or zone entry point ruleset's versions
Get an account or zone entry point ruleset version
RulesetsRules
Create an account or zone ruleset rule
Update an account or zone ruleset rule
Delete an account or zone ruleset rule
RulesetsVersions
List an account or zone ruleset's versions
Get an account or zone ruleset version
Delete an account or zone ruleset version
URL Normalization
Get URL Normalization settings
Update URL Normalization settings
Delete URL Normalization settings
Spectrum
SpectrumAnalytics
SpectrumAnalyticsAggregates
SpectrumAnalyticsAggregatesCurrents
Get current aggregated analytics
SpectrumAnalyticsEvents
SpectrumAnalyticsEventsBytimes
Get analytics by time
SpectrumAnalyticsEventsSummaries
Get analytics summary
SpectrumApps
List Spectrum applications
Get Spectrum application configuration
Create Spectrum application using a name for the origin
Update Spectrum application configuration using a name for the origin
Delete Spectrum application
Addressing
AddressingRegional Hostnames
List Regional Hostnames
Fetch Regional Hostname
Create Regional Hostname
Update Regional Hostname
Delete Regional Hostname
AddressingRegional HostnamesRegions
List Regions
AddressingServices
List Services
AddressingAddress Maps
List Address Maps
Address Map Details
Create Address Map
Update Address Map
Delete Address Map
AddressingAddress MapsAccounts
Add an account membership to an Address Map
Remove an account membership from an Address Map
AddressingAddress MapsIPs
Add an IP to an Address Map
Remove an IP from an Address Map
AddressingAddress MapsZones
Add a zone membership to an Address Map
Remove a zone membership from an Address Map
AddressingLOA Documents
Download LOA Document
Upload LOA Document
AddressingPrefixes
List Prefixes
Prefix Details
Add Prefix
Update Prefix Description
Delete Prefix
AddressingPrefixesService Bindings
List Service Bindings
Get Service Binding
Create Service Binding
Delete Service Binding
AddressingPrefixesBGP Prefixes
List BGP Prefixes
Fetch BGP Prefix
Create BGP Prefix
Update BGP Prefix
AddressingPrefixesAdvertisement Status
Get Advertisement Status
Update Prefix Dynamic Advertisement Status
AddressingPrefixesDelegations
List Prefix Delegations
Create Prefix Delegation
Delete Prefix Delegation
Data Localization Suite
Data Localization SuiteRegions
List DLS regions for an account
Get a DLS region
Data Localization SuiteRegional Services
Data Localization SuiteRegional ServicesPrefix Bindings
List DLS prefix bindings for an account
Get a DLS prefix binding
Create a DLS prefix binding
Update a DLS prefix binding
Delete a DLS prefix binding
Audit Logs
Get account audit logs
Billing
BillingProfiles
BillingUsage
Get PayGo Account Billable Usage (Version 1, Alpha)
Get Account Usage (Version 2, Alpha, Restricted)
Brand Protection
Create new URL submissions
Read submitted URLs by ID
Brand ProtectionQueries
Create new saved string queries
Delete saved string queries by ID
Create new saved string queries in bulk
Brand ProtectionMatches
Read matches for string queries by ID
Download matches for string queries by ID
Brand ProtectionLogos
Create new saved logo queries from image files
Delete saved logo queries by ID
Brand ProtectionLogo Matches
Read matches for logo queries by ID
Download matches for logo queries by ID
Brand ProtectionV2
Brand ProtectionV2Queries
Get queries
Brand ProtectionV2Matches
List saved query matches
Brand ProtectionV2Logos
Insert logo query
Delete logo query
Get logo queries
Brand ProtectionV2Logo Matches
List logo matches
Diagnostics
DiagnosticsTraceroutes
Traceroute
DiagnosticsEndpoint Healthchecks
List Endpoint Health Checks
Endpoint Health Check
Get Endpoint Health Check
Delete Endpoint Health Check
Update Endpoint Health Check
Images
ImagesV1
Image details
Upload an image
Update image
Delete image
ImagesV1Keys
List Signing Keys
Create a new Signing Key
Delete Signing Key
ImagesV1Stats
Images usage statistics
ImagesV1Variants
List variants
Variant details
Create a variant
Update a variant
Delete a variant
ImagesV1Blobs
Download image
ImagesV2
List images V2
ImagesV2Direct Uploads
Create authenticated direct upload URL V2
Intel
IntelASN
Get ASN Overview.
IntelASNSubnets
Get ASN Subnets
IntelDNS
Get Passive DNS by IP
IntelDomains
Get Domain Details
IntelDomainsBulks
Get Multiple Domain Details
IntelDomain History
Get Domain History
IntelIPs
Get IP Overview
IntelIP Lists
IntelMiscategorizations
Create Miscategorization
IntelWhois
Get WHOIS Record
IntelIndicator Feeds
Get indicator feeds owned by this account
Get indicator feed metadata
Create new indicator feed
Update indicator feed metadata
Get indicator feed data
IntelIndicator FeedsSnapshots
Update indicator feed data
IntelIndicator FeedsPermissions
List indicator feed permissions
Grant permission to indicator feed
Revoke permission to indicator feed
IntelIndicator FeedsDownloads
IntelSinkholes
List sinkholes owned by this account
IntelAttack Surface Report
IntelAttack Surface ReportIssue Types
Retrieves Security Center Issues Types
IntelAttack Surface ReportIssues
Retrieves Security Center Issues
Retrieves Security Center Issue Counts by Class
Retrieves Security Center Issue Counts by Severity
Retrieves Security Center Issue Counts by Type
Archives Security Center Insight
Magic Transit
Magic TransitApps
List Apps
Create a new App
Update an App
Update an App
Delete Account App
Magic TransitCf Interconnects
List interconnects
List interconnect Details
Update interconnect
Update multiple interconnects
Magic TransitGRE Tunnels
List GRE tunnels
List GRE Tunnel Details
Create a GRE tunnel
Update GRE Tunnel
Delete GRE Tunnel
Update multiple GRE tunnels
Magic TransitIPSEC Tunnels
List IPsec tunnels
List IPsec tunnel details
Create an IPsec tunnel
Update IPsec Tunnel
Delete IPsec Tunnel
Update multiple IPsec tunnels
Generate Pre-Shared Key (PSK) for IPsec tunnels
Set Pre-Shared Keys (PSK) for IPsec tunnels
Magic TransitRoutes
List Routes
Route Details
Create a Route
Update Route
Delete Route
Update Many Routes
Delete Many Routes
Magic TransitSites
List Sites
Site Details
Create a new Site
Update Site
Patch Site
Delete Site
Magic TransitSitesApp Configuration
List App Configs
Create a new App Config
Update an App Config
Update an App Config
Delete App Config
Magic TransitSitesACLs
List Site ACLs
Site ACL Details
Create a new Site ACL
Update Site ACL
Patch Site ACL
Delete Site ACL
Magic TransitSitesLANs
List Site LANs
Site LAN Details
Create a new Site LAN
Update Site LAN
Patch Site LAN
Delete Site LAN
Magic TransitSitesWANs
List Site WANs
Site WAN Details
Create a new Site WAN
Update Site WAN
Patch Site WAN
Delete Site WAN
Magic TransitConnectors
List Connectors
Fetch Connector
Create Connector
Replace Connector
Update Connector
Delete Connector
Magic TransitConnectorsEvents
List Events
Fetch Event
Magic TransitConnectorsEventsLatest
Fetch latest Events
Magic TransitConnectorsSnapshots
List Snapshots
Fetch Snapshot
Magic TransitConnectorsSnapshotsLatest
Fetch latest Snapshots
Magic TransitCf1 Sites
List CF1 Sites
Get CF1 Site
Create CF1 Sites
Update CF1 Site
Delete CF1 Site
Magic TransitCf1 SitesRamps
List CF1 Site Ramps
Get CF1 Site Ramp
Create CF1 Site Ramps
Delete CF1 Site Ramp
Magic TransitPCAPs
List packet capture requests
Get PCAP request
Create PCAP request
Stop full PCAP
Magic TransitPCAPsOwnership
List PCAPs Bucket Ownership
Add buckets for full packet captures
Delete buckets for full packet captures
Validate buckets for full packet captures
Magic TransitPCAPsDownload
Download Simple PCAP
DDoS Protection
DDoS ProtectionAdvanced TCP Protection
DDoS ProtectionAdvanced TCP ProtectionAllowlist
List all allowlist prefixes.
Create allowlist prefix.
Delete all allowlist prefixes.
DDoS ProtectionAdvanced TCP ProtectionAllowlistItems
Get allowlist prefix.
Update allowlist prefix.
Delete allowlist prefix.
DDoS ProtectionAdvanced TCP ProtectionPrefixes
List all prefixes.
Create prefix.
Delete all prefixes.
Create multiple prefixes.
DDoS ProtectionAdvanced TCP ProtectionPrefixesItems
Get prefix.
Update prefix.
Delete prefix.
DDoS ProtectionAdvanced TCP ProtectionSYN Protection
DDoS ProtectionAdvanced TCP ProtectionSYN ProtectionFilters
List all SYN Protection filters.
Create a SYN Protection filter.
Delete all SYN Protection filters.
DDoS ProtectionAdvanced TCP ProtectionSYN ProtectionFiltersItems
Get SYN Protection filter.
Update SYN Protection filter.
Delete SYN Protection filter.
DDoS ProtectionAdvanced TCP ProtectionSYN ProtectionRules
List all SYN Protection rules.
Create SYN Protection rule.
Delete all SYN Protection rules.
DDoS ProtectionAdvanced TCP ProtectionSYN ProtectionRulesItems
Get SYN Protection rule.
Update SYN Protection rule.
Delete SYN Protection rule.
DDoS ProtectionAdvanced TCP ProtectionTCP Flow Protection
DDoS ProtectionAdvanced TCP ProtectionTCP Flow ProtectionFilters
List all TCP Flow Protection filters.
Create a TCP Flow Protection filter.
Delete all TCP Flow Protection filters.
DDoS ProtectionAdvanced TCP ProtectionTCP Flow ProtectionFiltersItems
Get TCP Flow Protection filter.
Update TCP Flow Protection filter.
Delete TCP Flow Protection filter.
DDoS ProtectionAdvanced TCP ProtectionTCP Flow ProtectionRules
List all TCP Flow Protection rules.
Create TCP Flow Protection rule.
Delete all TCP Flow Protection rules.
DDoS ProtectionAdvanced TCP ProtectionTCP Flow ProtectionRulesItems
Get TCP Flow Protection rule.
Update TCP Flow Protection rule.
Delete TCP Flow Protection rule.
DDoS ProtectionAdvanced TCP ProtectionStatus
Get protection status.
Update protection status.
Magic Network Monitoring
Magic Network MonitoringVPC Flows
Magic Network MonitoringVPC FlowsTokens
Generate authentication token for VPC flow logs export.
Magic Network MonitoringConfigs
List account configuration
Create account configuration
Update an entire account configuration
Update account configuration fields
Delete account configuration
Magic Network MonitoringConfigsFull
List rules and account configuration
Magic Network MonitoringRules
List rules
Get rule
Create rules
Update rules
Update rule
Delete rule
Magic Network MonitoringRulesAdvertisements
Update advertisement for rule
Magic Cloud Networking
Magic Cloud NetworkingCatalog Syncs
List Catalog Syncs
Read Catalog Sync
Create Catalog Sync
Update Catalog Sync
Patch Catalog Sync
Delete Catalog Sync
Run Catalog Sync
Magic Cloud NetworkingCatalog SyncsPrebuilt Policies
List Prebuilt Policies
Magic Cloud NetworkingOn Ramps
List On-ramps
Read On-ramp
Create On-ramp
Update On-ramp
Patch On-ramp
Delete On-ramp
Apply On-ramp
Export as Terraform
Plan On-ramp
Magic Cloud NetworkingOn RampsAddress Spaces
Read Magic WAN Address Space
Update Magic WAN Address Space
Patch Magic WAN Address Space
Magic Cloud NetworkingCloud Integrations
List Cloud Integrations
Read Cloud Integration
Create Cloud Integration
Update Cloud Integration
Patch Cloud Integration
Delete Cloud Integration
Run Discovery for All Integrations
Run Discovery
Get Cloud Integration Setup Config
Magic Cloud NetworkingResources
List Resources
Read Resource
Export Resources
Preview Rego Query
Network Interconnects
Network InterconnectsCNIs
List existing CNI objects
Get information about a CNI object
Create a new CNI object
Modify stored information about a CNI object
Delete a specified CNI object
Network InterconnectsInterconnects
List existing interconnects
Get information about an interconnect object
Create a new interconnect
Delete an interconnect object
Generate the Letter of Authorization (LOA) for a given interconnect
Get the current status of an interconnect object
Network InterconnectsSettings
Get the current settings for the active account
Update the current settings for the active account
Network InterconnectsSlots
Retrieve a list of all slots matching the specified parameters
Get information about the specified slot
MTLS Certificates
List mTLS certificates
Get mTLS certificate
Upload mTLS certificate
Delete mTLS certificate
MTLS CertificatesAssociations
List mTLS certificate associations
Pages
PagesProjects
Get projects
Get project
Create project
Update project
Delete project
Purge build cache
PagesProjectsDeployments
Get deployments
Get deployment info
Create deployment
Delete deployment
Retry deployment
Rollback deployment
PagesProjectsDeploymentsHistory
PagesProjectsDeploymentsHistoryLogs
Get deployment logs
PagesProjectsDomains
Get domains
Get domain
Add domain
Patch domain
Delete domain
Registrar
Registrar API for searching, checking, registering, and managing domains through Cloudflare Registrar.
Prerequisites
Before using this API, ensure:
- Cloudflare account — the caller must have a valid Cloudflare account.
- Billing profile — the account must have a billing profile with a valid,
current default payment method (credit card or other accepted method).
This cannot be set up via API — the account owner must configure billing
at
https://dash.cloudflare.com/{account_id}/billing/payment-infobefore callingPOST /registrations. - API authentication — use an API token or API key with the appropriate Registrar permissions for the operations you are calling.
Terminology: domain extension
Throughout this API, “extension” refers to the domain extension part of a fully
qualified domain name — the portion after the registrable label. For example,
in example.co.uk, the extension is co.uk (not just uk). This covers both
top-level domains like com and multi-level extensions like co.uk. This is
distinct from other uses of the word “extension” (e.g., EPP extensions).
Supported extensions
This API currently supports programmatic registration for the following extensions:
com, org, net, app, dev, cc, xyz, info, cloud, studio,
live, link, pro, tech, fyi, shop, online, tools, run,
games, build, systems, world, news, site, network, chat,
space, family, page, life, group, email, solutions, day,
blog, ing, icu, academy, today
Cloudflare Registrar supports 400+ extensions in the dashboard. Extensions
not listed above can be registered at https://dash.cloudflare.com/{account_id}/domains/registrations.
Typical workflow
- Search — call
GET /domain-search?q={keyword}to discover available domains. - Check — call
POST /domain-checkwith candidate domains to verify real-time availability and pricing. - Review the response — if
registrable: false, inspectreasonto understand whether the domain is unavailable, the extension is not supported by this API, the extension is not supported by Cloudflare Registrar at all, or the extension’s registry has frozen new registrations. - Handle premium domains — if
tier: premium, premium registration is not currently supported by this API. Surface the premium pricing to the user, but do not proceed toPOST /registrationsfor that domain. - Register — call
POST /registrationswith the chosen domain name for supported non-premium registrations. - Confirm completion — if the response is
201 Created, registration completed within the default timeout and no polling is needed. - Poll when needed — if the response is
202 Accepted, polllinks.selffrom the workflow response. - Stop for user action — if
state: action_required, stop polling and surfacecontext.actionto the user. The workflow will not resolve on its own. - Continue when blocked — if
state: blocked, continue polling and inform the user that a third party, such as the extension registry or losing registrar, is delaying progress. - Review failures before retrying — if
state: failed, reviewerror.codeanderror.message, then decide whether user action or a new Check call is needed.
All successful domain registrations are non-refundable. Once the registration
workflow completes with state: succeeded, the charge cannot be reversed.
Confirm pricing and domain choice with the user before calling POST /registrations.
Default behavior for mutating operations
By default, mutating operations such as create and update hold the connection for a bounded, server-defined amount of time while the operation completes. In most cases, the response contains a completed workflow status and no polling is required.
- Completed within the synchronous wait window: Returns
201(create) or200(update) with aworkflow_statuswherestate: succeededandcompleted: true. - Still processing after the synchronous wait window: Returns
202 Acceptedwith aworkflow_statuswherecompleted: false. Use thelinks.selfURL to poll for completion.
Non-blocking mode
To receive an immediate 202 Accepted response without waiting, send the
Prefer: respond-async request header (RFC 7240). The server will acknowledge
it with a Preference-Applied: respond-async response header.
Polling
When the response is 202, poll the workflow status endpoint indicated by
links.self in the response body until the workflow reaches a terminal
state or requires user action.
Search for available domains
Check domain availability
RegistrarDomains
RegistrarRegistrations
Create Registration
List Registrations
Get Registration
Update Registration
RegistrarRegistration Status
Get Registration Status
RegistrarUpdate Status
Get Update Status
Registrar Sandbox
Use the Registrar Sandbox API to test domain search, availability checks, registration, and domain management flows without buying real domains.
This API is a test environment for the production Registrar API.
Prerequisites
Before using this API, make sure you have:
- Cloudflare account — the caller must have a valid Cloudflare account.
- API authentication — create an API token with Registrar Sandbox permissions.
How the Sandbox API differs from the production Registrar API
Because the Sandbox API is intended for testing, it behaves differently from the production Registrar API in a few important ways:
- No billing — you will not be charged real money for purchasing a domain.
- No real domains — purchased domains are test records and will not be reachable on the Internet.
- No DNS zones — purchasing a domain does not create a zone resource.
- No Registration Express Mode — you must provide full contact data.
Sandbox purchases are still persisted. If you purchase a domain in the sandbox, that domain will not be available for others to purchase in the sandbox.
Terminology: domain extension
Throughout this API, “extension” refers to the domain extension part of a fully
qualified domain name — the portion after the registrable label. For example,
in example.co.uk, the extension is co.uk (not just uk). This covers both
top-level domains like com and multi-level extensions like co.uk. This is
distinct from other uses of the word “extension” (e.g., EPP extensions).
Supported extensions
The Sandbox API currently supports programmatic registration for these extensions:
com, net
The production Registrar API supports 40+ extensions.
Cloudflare Registrar supports 400+ extensions in the dashboard. Extensions
not listed above can be registered at https://dash.cloudflare.com/{account_id}/domains/registrations.
Typical workflow
- Search — call
GET /domain-search?q={keyword}to discover available domains. - Check — call
POST /domain-checkwith candidate domains to verify real-time availability and pricing. - Review the response — if
registrable: false, inspectreasonto understand whether the domain is unavailable, the extension is not supported by this API, the extension is not supported by Cloudflare Registrar at all, or the extension’s registry has frozen new registrations. - Handle premium domains — if
tier: premium, premium registration is not currently supported by this API. The Sandbox API currently supports onlycomandnet, which do not have premium registrations, but clients should still handle this response for consistency with the production Registrar API. Surface the premium pricing to the user, but do not proceed toPOST /registrationsfor that domain. - Register — call
POST /registrationswith the chosen domain name for supported non-premium registrations. - Confirm completion — if the response is
201 Created, registration completed within the default timeout and no polling is needed. - Poll when needed — if the response is
202 Accepted, polllinks.selffrom the workflow response. - Stop for user action — if
state: action_required, stop polling and surfacecontext.actionto the user. The workflow will not resolve on its own. - Continue when blocked — if
state: blocked, continue polling and inform the user that a third party, such as the extension registry or losing registrar, is delaying progress. - Review failures before retrying — if
state: failed, reviewerror.codeanderror.message, then decide whether user action or a new Check call is needed.
Default behavior for mutating operations
By default, mutating operations such as create and update hold the connection for a bounded, server-defined amount of time while the operation completes. In most cases, the response contains a completed workflow status and no polling is required.
- Completed within the synchronous wait window: Returns
201(create) or200(update) with aworkflow_statuswherestate: succeededandcompleted: true. - Still processing after the synchronous wait window: Returns
202 Acceptedwith aworkflow_statuswherecompleted: false. Use thelinks.selfURL to poll for completion.
Non-blocking mode
To receive an immediate 202 Accepted response without waiting, send the
Prefer: respond-async request header (RFC 7240). The server will acknowledge
it with a Preference-Applied: respond-async response header.
Polling
When the response is 202, poll the workflow status endpoint indicated by
links.self in the response body until the workflow reaches a terminal
state or requires user action.