openapi: 3.0.3
components:
schemas:
0rtt:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- 0rtt
example: 0rtt
value:
$ref: '#/components/schemas/0rtt_value'
title: 0-RTT Value
description: 0-RTT session resumption enabled for this zone.
0rtt_value:
type: string
description: Value of the 0-RTT setting.
enum:
- "on"
- "off"
default: "off"
AAAARecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
format: ipv6
description: A valid IPv6 address.
example: 2400:cb00:2049:1::173.245.59.16
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- AAAA
example: AAAA
title: AAAA Record
required:
- type
- name
- content
ARecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
format: ipv4
description: A valid IPv4 address.
example: 198.51.100.4
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- A
example: A
title: A Record
required:
- type
- name
- content
CERTRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted CERT content. See 'data' to set CERT properties.
readOnly: true
data:
type: object
description: Components of a CERT record.
properties:
algorithm:
type: number
description: Algorithm.
example: 8
minimum: 0
maximum: 255
certificate:
type: string
description: Certificate.
key_tag:
type: number
description: Key Tag.
example: 1
minimum: 0
maximum: 65535
type:
type: number
description: Type.
example: 9
minimum: 0
maximum: 65535
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- CERT
example: CERT
title: CERT Record
required:
- type
- name
- data
CNAMERecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
description: A valid hostname.
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- CNAME
example: CNAME
title: CNAME Record
required:
- type
- name
- content
Cloudflare Client API_domain-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/domain'
Cloudflare Client API_domain-response-single:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
$ref: '#/components/schemas/domain'
Cloudflare Client API_domain_name:
type: string
description: Domain name.
example: cloudflare.com
Cloudflare Client API_identifier:
type: string
description: Policy identifier.
example: f267e341f3dd4697bd3b9f71dd96247f
readOnly: true
CustomNS:
title: Custom NS
description: A single account custom nameserver.
required:
- dns_records
- ns_name
- status
- zone_tag
properties:
dns_records:
type: array
description: A and AAAA records associated with the nameserver.
items:
properties:
type:
type: string
description: DNS record type.
enum:
- A
- AAAA
example: A
value:
type: string
description: DNS record contents (an IPv4 or IPv6 address).
example: 1.1.1.1
ns_name:
$ref: '#/components/schemas/ns_name'
status:
type: string
description: Verification status of the nameserver.
enum:
- moved
- pending
- verified
example: verified
zone_tag:
$ref: '#/components/schemas/common_components-schemas-identifier'
CustomNSInput:
title: Custom NS Input
required:
- ns_name
properties:
ns_name:
$ref: '#/components/schemas/ns_name'
DNSKEYRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted DNSKEY content. See 'data' to set DNSKEY properties.
readOnly: true
data:
type: object
description: Components of a DNSKEY record.
properties:
algorithm:
type: number
description: Algorithm.
example: 5
minimum: 0
maximum: 255
flags:
type: number
description: Flags.
example: 1
minimum: 0
maximum: 65535
protocol:
type: number
description: Protocol.
example: 3
minimum: 0
maximum: 255
public_key:
type: string
description: Public Key.
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- DNSKEY
example: DNSKEY
title: DNSKEY Record
required:
- type
- name
- data
DSRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted DS content. See 'data' to set DS properties.
readOnly: true
data:
type: object
description: Components of a DS record.
properties:
algorithm:
type: number
description: Algorithm.
example: 3
minimum: 0
maximum: 255
digest:
type: string
description: Digest.
digest_type:
type: number
description: Digest Type.
example: 1
minimum: 0
maximum: 255
key_tag:
type: number
description: Key Tag.
example: 1
minimum: 0
maximum: 65535
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- DS
example: DS
title: DS Record
required:
- type
- name
- data
HTTPSRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted HTTPS content. See 'data' to set HTTPS properties.
readOnly: true
data:
type: object
description: Components of a HTTPS record.
properties:
priority:
type: number
description: priority.
example: 1
minimum: 0
maximum: 65535
target:
type: string
description: target.
example: .
value:
type: string
description: value.
example: alpn="h3,h2" ipv4hint="127.0.0.1" ipv6hint="::1"
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- HTTPS
example: HTTPS
title: HTTPS Record
required:
- type
- name
- data
Host:
type: array
description: The 'Host' header allows to override the hostname set in the HTTP
request. Current support is 1 'Host' header override per origin.
items:
type: string
example: example.com
LOCRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted LOC content. See 'data' to set LOC properties.
example: IN LOC 37 46 46 N 122 23 35 W 0m 100m 0m 0m
readOnly: true
data:
type: object
description: Components of a LOC record.
properties:
altitude:
type: number
description: Altitude of location in meters.
example: 0
minimum: -100000
maximum: 4.284967295e+07
lat_degrees:
type: number
description: Degrees of latitude.
example: 37
minimum: 0
maximum: 90
lat_direction:
description: Latitude direction.
enum:
- "N"
- S
example: "N"
lat_minutes:
type: number
description: Minutes of latitude.
default: 0
example: 46
minimum: 0
maximum: 59
lat_seconds:
type: number
description: Seconds of latitude.
default: 0
example: 46
minimum: 0
maximum: 59.999
long_degrees:
type: number
description: Degrees of longitude.
example: 122
minimum: 0
maximum: 180
long_direction:
description: Longitude direction.
enum:
- E
- W
example: W
long_minutes:
type: number
description: Minutes of longitude.
default: 0
example: 23
minimum: 0
maximum: 59
long_seconds:
type: number
description: Seconds of longitude.
default: 0
example: 35
minimum: 0
maximum: 59.999
precision_horz:
type: number
description: Horizontal precision of location.
default: 0
example: 0
minimum: 0
maximum: 9e+07
precision_vert:
type: number
description: Vertical precision of location.
default: 0
example: 0
minimum: 0
maximum: 9e+07
size:
type: number
description: Size of location in meters.
default: 0
example: 100
minimum: 0
maximum: 9e+07
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- LOC
example: LOC
title: LOC Record
required:
- type
- name
- data
MXRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
format: hostname
description: A valid mail server hostname.
example: mx.example.com
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
priority:
$ref: '#/components/schemas/priority'
type:
description: Record type.
enum:
- MX
example: MX
title: MX Record
required:
- type
- name
- content
- priority
NAPTRRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted NAPTR content. See 'data' to set NAPTR properties.
readOnly: true
data:
type: object
description: Components of a NAPTR record.
properties:
flags:
type: string
description: Flags.
order:
type: number
description: Order.
example: 100
minimum: 0
maximum: 65535
preference:
type: number
description: Preference.
example: 10
minimum: 0
maximum: 65535
regex:
type: string
description: Regex.
replacement:
type: string
description: Replacement.
service:
type: string
description: Service.
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- NAPTR
example: NAPTR
title: NAPTR Record
required:
- type
- name
- data
NSRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
description: A valid name server host name.
example: ns1.example.com
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- NS
example: NS
title: NS Record
required:
- type
- name
- content
SMIMEARecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted SMIMEA content. See 'data' to set SMIMEA properties.
readOnly: true
data:
type: object
description: Components of a SMIMEA record.
properties:
certificate:
type: string
description: Certificate.
matching_type:
type: number
description: Matching Type.
example: 0
minimum: 0
maximum: 255
selector:
type: number
description: Selector.
example: 0
minimum: 0
maximum: 255
usage:
type: number
description: Usage.
example: 3
minimum: 0
maximum: 255
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- SMIMEA
example: SMIMEA
title: SMIMEA Record
required:
- type
- name
- data
SRVRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Priority, weight, port, and SRV target. See 'data' for setting
the individual component values.
example: 10 IN SRV 5 8806 example.com.
readOnly: true
data:
type: object
description: Components of a SRV record.
properties:
name:
type: string
format: hostname
description: A valid hostname.
example: example.com
port:
type: number
description: The port of the service.
example: 8806
minimum: 0
maximum: 65535
priority:
$ref: '#/components/schemas/priority'
proto:
type: string
description: A valid protocol.
example: _tcp
service:
type: string
description: A service type, prefixed with an underscore.
example: _sip
target:
type: string
format: hostname
description: A valid hostname.
example: example.com
weight:
type: number
description: The record weight.
example: 5
minimum: 0
maximum: 65535
name:
type: string
description: Service, protocol, and SRV name content. See 'data' for setting
the individual component values.
example: _sip._tcp.example.com
readOnly: true
maxLength: 255
type:
description: Record type.
enum:
- SRV
example: SRV
title: SRV Record
required:
- type
- data
SSHFPRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted SSHFP content. See 'data' to set SSHFP properties.
readOnly: true
data:
type: object
description: Components of a SSHFP record.
properties:
algorithm:
type: number
description: algorithm.
example: 2
minimum: 0
maximum: 255
fingerprint:
type: string
description: fingerprint.
type:
type: number
description: type.
example: 1
minimum: 0
maximum: 255
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- SSHFP
example: SSHFP
title: SSHFP Record
required:
- type
- name
- data
SVCBRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted SVCB content. See 'data' to set SVCB properties.
readOnly: true
data:
type: object
description: Components of a SVCB record.
properties:
priority:
type: number
description: priority.
example: 1
minimum: 0
maximum: 65535
target:
type: string
description: target.
example: .
value:
type: string
description: value.
example: alpn="h3,h2" ipv4hint="127.0.0.1" ipv6hint="::1"
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- SVCB
example: SVCB
title: SVCB Record
required:
- type
- name
- data
TLSARecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted TLSA content. See 'data' to set TLSA properties.
readOnly: true
data:
type: object
description: Components of a TLSA record.
properties:
certificate:
type: string
description: certificate.
matching_type:
type: number
description: Matching Type.
example: 1
minimum: 0
maximum: 255
selector:
type: number
description: Selector.
example: 0
minimum: 0
maximum: 255
usage:
type: number
description: Usage.
example: 0
minimum: 0
maximum: 255
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- TLSA
example: TLSA
title: TLSA Record
required:
- type
- name
- data
TXTRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Text content for the record.
example: example text content
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
type:
description: Record type.
enum:
- TXT
example: TXT
title: TXT Record
required:
- type
- name
- content
URIRecord:
allOf:
- $ref: '#/components/schemas/dns-record_components-schemas-base'
- properties:
content:
type: string
description: Formatted URI content. See 'data' to set URI properties.
readOnly: true
data:
type: object
description: Components of a URI record.
properties:
content:
type: string
description: The record content.
example: http://example.com/example.html
weight:
type: number
description: The record weight.
example: 20
minimum: 0
maximum: 65535
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
priority:
$ref: '#/components/schemas/priority'
type:
description: Record type.
enum:
- URI
example: URI
title: URI Record
required:
- type
- name
- data
- priority
access-policy:
oneOf:
- $ref: '#/components/schemas/policy_with_permission_groups'
type: object
access-requests:
type: object
properties:
action:
$ref: '#/components/schemas/access-requests_components-schemas-action'
allowed:
$ref: '#/components/schemas/schemas-allowed'
app_domain:
$ref: '#/components/schemas/app_domain'
app_uid:
$ref: '#/components/schemas/app_uid'
connection:
$ref: '#/components/schemas/components-schemas-connection'
created_at:
$ref: '#/components/schemas/timestamp'
ip_address:
$ref: '#/components/schemas/components-schemas-ip'
ray_id:
$ref: '#/components/schemas/ray_id'
user_email:
$ref: '#/components/schemas/schemas-email'
access-requests_components-schemas-action:
type: string
description: The event that occurred, such as a login attempt.
example: login
access-requests_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
access-requests_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/access-requests'
access_group_rule:
type: object
title: Access groups
description: Matches an Access group.
required:
- group
properties:
group:
type: object
required:
- id
properties:
id:
type: string
description: The ID of a previously created Access group.
example: aa0a4aab-672b-4bdb-bc33-a59f1130a11f
access_seat:
type: boolean
description: True if the seat is part of Access.
example: false
accessRules:
type: object
description: Defines rules for fine-grained control over content than signed
URL tokens alone. Access rules primarily make tokens conditionally valid based
on user information. Access Rules are specified on token payloads as the `accessRules`
property containing an array of Rule objects.
readOnly: true
properties:
action:
type: string
description: The action to take when a request matches a rule. If the action
is `block`, the signed token blocks views for viewers matching the rule.
enum:
- allow
- block
example: allow
readOnly: true
country:
type: array
description: An array of 2-letter country codes in ISO 3166-1 Alpha-2 format
used to match requests.
readOnly: true
items:
type: string
ip:
type: array
description: An array of IPv4 or IPV6 addresses or CIDRs used to match requests.
readOnly: true
items:
type: string
type:
type: string
description: Lists available rule types to match for requests. An `any`
type matches all requests and can be used as a wildcard to apply default
actions after other rules.
enum:
- any
- ip.src
- ip.geoip.country
example: ip.src
readOnly: true
account:
type: object
required:
- id
- name
properties:
created_on:
type: string
format: date-time
description: Timestamp for the creation of the account
example: "2014-03-01T12:21:02.0000Z"
readOnly: true
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
type: string
description: Account name
example: Demo Account
maxLength: 100
settings:
type: object
description: Account settings
properties:
enforce_twofactor:
type: boolean
description: |-
Indicates whether membership in this account requires that
Two-Factor Authentication is enabled
default: false
use_account_custom_ns_by_default:
type: boolean
description: |-
Indicates whether new zones should use the account-level custom
nameservers by default
default: false
account-settings-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
properties:
default_usage_model:
readOnly: true
green_compute:
readOnly: true
account_identifier: {}
account_subscription_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/subscription'
account_subscription_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
accounts_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
acl:
type: object
required:
- id
- name
- ip_range
properties:
id:
$ref: '#/components/schemas/acl_components-schemas-identifier'
ip_range:
$ref: '#/components/schemas/ip_range'
name:
$ref: '#/components/schemas/acl_components-schemas-name'
acl_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/acl_components-schemas-identifier'
acl_components-schemas-identifier:
example: 23ff594956f20c2a721606e94745a8aa
acl_components-schemas-name:
type: string
description: The name of the acl.
example: my-acl-1
acl_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/acl'
acl_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/acl'
acns_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/CustomNS'
acns_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/CustomNS'
action:
type: string
description: The billing item action.
example: subscription
readOnly: true
maxLength: 30
action_mode:
type: string
description: The default action performed by the rules in the WAF package.
enum:
- simulate
- block
- challenge
default: challenge
action_parameters:
type: object
description: The parameters configuring the rule action.
example:
id: 4814384a9e5d4991b9815dcfc25d2f1f
action_parameters_rewrite:
description: The configuration parameters for the rewrite action.
properties:
uri:
type: object
description: The URI rewrite configuration to rewrite the URI path, the
query string, or both.
properties:
path:
description: The new URI path sent to the origin.
query:
description: The new query string sent to the origin.
action_parameters_serve_error:
description: The action parameters for the serve_error action.
properties:
content:
type: string
description: The new content for the response error.
example: some html error page
content_type:
type: string
description: The content-type of the response error.
example: text/html
status_code:
type: number
description: The HTTP status code of the response error.
example: 530
actions:
type: array
description: List actions patterns.
items:
$ref: '#/components/schemas/schemas-action'
activated_on:
type: string
format: date-time
description: When the Railgun was activated.
example: "2014-01-02T02:20:00Z"
readOnly: true
activation:
type: object
readOnly: true
required:
- key
properties:
activated_on:
$ref: '#/components/schemas/activated_on'
key:
$ref: '#/components/schemas/activation_key'
version:
type: object
required:
- number
properties:
build:
$ref: '#/components/schemas/build'
number:
$ref: '#/components/schemas/railgun_components-schemas-version'
revision:
$ref: '#/components/schemas/revision'
activation_key:
type: string
example: e4edc00281cb56ebac22c81be9bac8f3
readOnly: true
maxLength: 32
active_device_count:
type: number
description: The number of active devices registered to the user.
example: 2
activity-log-settings:
type: object
description: Activity log settings.
properties:
enabled:
type: boolean
description: Enable activity logging.
example: true
adaptive_routing:
type: object
description: Controls features that modify the routing of requests to pools
and origins in response to dynamic conditions, such as during the interval
between active health monitoring requests. For example, zero-downtime failover
occurs immediately when an origin becomes unavailable due to HTTP 521, 522,
or 523 response codes. If there is another healthy origin in the same pool,
the request is retried once against this alternate origin.
properties:
failover_across_pools:
type: boolean
description: Extends zero-downtime failover of requests to healthy origins
from alternate pools, when no healthy alternate exists in the same pool,
according to the failover order defined by traffic and origin steering.
When set false (the default) zero-downtime failover will only occur between
origins within the same pool. See `session_affinity_attributes` for control
over when sessions are broken or reassigned.
default: false
example: true
additional_information:
type: object
description: Additional information related to the host name.
properties:
suspected_malware_family:
type: string
description: Suspected DGA malware family.
example: ""
address:
type: string
description: The IP address (IPv4 or IPv6) of the origin, or the publicly addressable
hostname. Hostnames entered here should resolve directly to the origin, and
not be a hostname proxied by Cloudflare.
example: 0.0.0.0
address-maps:
type: object
properties:
can_delete:
$ref: '#/components/schemas/can_delete'
can_modify_ips:
$ref: '#/components/schemas/can_modify_ips'
created_at:
$ref: '#/components/schemas/timestamp'
default_sni:
$ref: '#/components/schemas/default_sni'
description:
$ref: '#/components/schemas/address-maps_components-schemas-description'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
modified_at:
$ref: '#/components/schemas/timestamp'
address-maps-ip:
type: object
properties:
created_at:
$ref: '#/components/schemas/created-on'
ip:
$ref: '#/components/schemas/schemas-ip'
address-maps-membership:
type: object
properties:
can_delete:
$ref: '#/components/schemas/schemas-can_delete'
created_at:
$ref: '#/components/schemas/created-on'
identifier:
$ref: '#/components/schemas/common_components-schemas-identifier'
kind:
$ref: '#/components/schemas/components-schemas-kind'
address-maps_components-schemas-description:
type: string
description: An optional description field which may be used to describe the
types of IPs or zones on the map.
example: My Ecommerce zones
nullable: true
address-maps_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/address-maps'
address-maps_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/address-maps'
address2:
type: string
description: Optional address line for unit, floor, suite, etc.
example: Suite 430
addresses:
allOf:
- $ref: '#/components/schemas/destination_address_properties'
type: object
advanced_certificate_pack_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
certificate_authority:
$ref: '#/components/schemas/certificate_authority'
cloudflare_branding:
$ref: '#/components/schemas/cloudflare_branding'
hosts:
$ref: '#/components/schemas/schemas-hosts'
id:
$ref: '#/components/schemas/certificate-packs_components-schemas-identifier'
status:
$ref: '#/components/schemas/certificate-packs_components-schemas-status'
type:
$ref: '#/components/schemas/advanced_type'
validation_method:
$ref: '#/components/schemas/validation_method'
validity_days:
$ref: '#/components/schemas/validity_days'
advanced_ddos:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- advanced_ddos
example: advanced_ddos
value:
$ref: '#/components/schemas/advanced_ddos_value'
title: Advanced DDoS Protection
description: Advanced protection from Distributed Denial of Service (DDoS) attacks
on your website. This is an uneditable value that is 'on' in the case of Business
and Enterprise zones.
advanced_ddos_value:
type: string
description: |-
Value of the zone setting.
Notes: Defaults to on for Business+ plans
enum:
- "on"
- "off"
default: "off"
advanced_type:
type: string
description: Type of certificate pack.
enum:
- advanced
example: advanced
advertised:
type: boolean
description: Prefix advertisement status to the Internet. This field is only
not 'null' if on demand is enabled.
example: true
nullable: true
advertised_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
advertised:
$ref: '#/components/schemas/schemas-advertised'
advertised_modified_at:
$ref: '#/components/schemas/modified_at_nullable'
alert-types:
type: object
properties:
description:
$ref: '#/components/schemas/alert-types_components-schemas-description'
display_name:
$ref: '#/components/schemas/display_name'
filter_options:
$ref: '#/components/schemas/schemas-filter_options'
type:
$ref: '#/components/schemas/alert-types_components-schemas-type'
alert-types_components-schemas-description:
type: string
description: Describes the alert type.
example: High levels of 5xx HTTP errors at your origin
alert-types_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: object
example:
Origin Monitoring:
- description: High levels of 5xx HTTP errors at your origin.
display_name: Origin Error Rate Alert
filter_options:
- ComparisonOperator: ==
Key: zones
Optional: false
- ComparisonOperator: '>='
Key: slo
Optional: true
type: http_alert_origin_error
alert-types_components-schemas-type:
type: string
description: Use this value when creating and updating a notification policy.
example: http_alert_origin_error
alert_body:
type: string
description: Message body included in the notification sent.
example: SSL certificate has expired
alert_type:
type: string
description: Refers to which event will trigger a Notification dispatch. You
can use the endpoint to get available alert types which then will give you
a list of possible values.
example: universal_ssl_event_type
algo:
type: string
description: TSIG algorithm.
example: hmac-sha512.
allow_all_headers:
type: boolean
description: Allows all HTTP request headers.
example: true
allow_all_methods:
type: boolean
description: Allows all HTTP request methods.
allow_all_origins:
type: boolean
description: Allows all origins.
allow_credentials:
type: boolean
description: When set to `true`, includes credentials (cookies, authorization
headers, or TLS client certificates) with requests.
allow_insecure:
type: boolean
description: Do not validate the certificate when monitor use HTTPS. This parameter
is currently only valid for HTTP and HTTPS monitors.
default: false
example: true
allow_mode_switch:
type: boolean
description: Whether to allow the user to switch WARP between modes.
example: true
allow_null_cipher:
type: boolean
description: When `true`, the tunnel can use a null-cipher (`ENCR_NULL`) in
the ESP tunnel (Phase 2).
example: true
allow_updates:
type: boolean
description: Whether to receive update notifications when a new version of the
client is available.
example: true
allowed:
type: number
description: Cloudflare Images allowed usage.
example: 100000
readOnly: true
allowed_headers:
type: array
description: Allowed HTTP request headers.
items: {}
allowed_idps:
type: array
description: The identity providers your users can select when connecting to
this application. Defaults to all IdPs configured in your account.
items:
type: string
description: The identity providers selected for application.
example: 699d98642c564d2e855e9661899b7252
allowed_methods:
type: array
description: Allowed HTTP request methods.
example:
- GET
items:
type: string
enum:
- GET
- POST
- HEAD
- PUT
- DELETE
- CONNECT
- OPTIONS
- TRACE
- PATCH
allowed_modes:
type: array
description: The available states for the rule group.
example:
- "on"
- "off"
readOnly: true
items:
$ref: '#/components/schemas/components-schemas-mode'
allowed_modes_allow_traditional:
type: array
description: Defines the available modes for the current WAF rule.
example:
- "on"
- "off"
readOnly: true
items:
$ref: '#/components/schemas/mode_allow_traditional'
allowed_modes_anomaly:
type: array
description: Defines the available modes for the current WAF rule. Applies to
anomaly detection WAF rules.
example:
- "on"
- "off"
readOnly: true
items:
$ref: '#/components/schemas/mode_anomaly'
allowed_modes_deny_traditional:
type: array
description: The list of possible actions of the WAF rule when it is triggered.
example:
- default
- disable
- simulate
- block
- challenge
readOnly: true
items:
$ref: '#/components/schemas/mode_deny_traditional'
allowed_origins:
type: array
description: Allowed origins.
example:
- https://example.com
items: {}
allowed_to_leave:
type: boolean
description: Whether to allow devices to leave the organization.
example: true
allowedOrigins:
type: array
description: Lists the origins allowed to display the video. Enter allowed origin
domains in an array and use `*` for wildcard subdomains. Empty arrays allow
the video to be viewed on any origin.
example:
- example.com
items:
type: string
always_online:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- always_online
example: always_online
value:
$ref: '#/components/schemas/always_online_value'
title: Always Online Mode
description: When enabled, Cloudflare serves limited copies of web pages available
from the [Internet Archive's Wayback Machine](https://archive.org/web/) if
your server is offline. Refer to [Always Online](https://developers.cloudflare.com/cache/about/always-online)
for more information.
always_online_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
always_use_https:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- always_use_https
example: always_use_https
value:
$ref: '#/components/schemas/always_use_https_value'
title: Zone Enable Always Use HTTPS
description: Reply to all requests for URLs that use "http" with a 301 redirect
to the equivalent "https" URL. If you only want to redirect for a subset of
requests, consider creating an "Always use HTTPS" page rule.
default: "off"
always_use_https_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
amount:
type: number
description: The amount associated with this billing item.
example: 20.99
readOnly: true
analytics:
type: object
properties:
id:
type: integer
default: 1
origins:
type: array
example:
- address: 198.51.100.4
changed: true
enabled: true
failure_reason: No failures
healthy: true
ip: 198.51.100.4
name: some-origin
items: {}
pool:
type: object
example:
changed: true
healthy: true
id: 74bc6a8b9b0dda3d651707a2928bad0c
minimum_origins: 1
name: some-pool
timestamp:
type: string
format: date-time
example: "2014-01-01T05:20:00.12345Z"
analytics-aggregate_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
type: object
analytics_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/analytics'
anomaly_description:
type: string
description: A summary of the purpose/function of the WAF package.
example: Covers OWASP Top 10 vulnerabilities and more.
readOnly: true
anomaly_detection_mode:
type: string
description: When a WAF package uses anomaly detection, each rule is given a
score when triggered. If the total score of all triggered rules exceeds the
sensitivity defined on the WAF package, the action defined on the package
will be taken.
example: anomaly
readOnly: true
anomaly_name:
type: string
description: The name of the WAF package.
example: OWASP ModSecurity Core Rule Set
readOnly: true
anomaly_package:
allOf:
- $ref: '#/components/schemas/package_definition'
- properties:
action_mode:
$ref: '#/components/schemas/action_mode'
description:
$ref: '#/components/schemas/anomaly_description'
detection_mode:
$ref: '#/components/schemas/anomaly_detection_mode'
name:
$ref: '#/components/schemas/anomaly_name'
sensitivity:
$ref: '#/components/schemas/sensitivity'
title: Anomaly detection WAF package (OWASP)
required:
- id
- name
- description
- zone_id
- detection_mode
- sensitivity
- action_mode
anomaly_rule:
allOf:
- $ref: '#/components/schemas/rule_components-schemas-base-2'
- properties:
allowed_modes:
$ref: '#/components/schemas/allowed_modes_anomaly'
mode:
$ref: '#/components/schemas/mode_anomaly'
title: Anomaly detection WAF rule
description: When triggered, anomaly detection WAF rules contribute to an overall
threat score that will determine if a request is considered malicious. You
can configure the total scoring threshold through the 'sensitivity' property
of the WAF package.
required:
- id
- description
- priority
- allowed_modes
- mode
- group
- package_id
anti-virus-settings:
type: object
description: Anti virus settings.
properties:
enabled_download_phase:
$ref: '#/components/schemas/enabled_download_phase'
enabled_upload_phase:
$ref: '#/components/schemas/enabled_upload_phase'
fail_closed:
$ref: '#/components/schemas/fail_closed'
api-response-collection:
anyOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
nullable: true
items: {}
result_info:
$ref: '#/components/schemas/result_info'
type: object
api-response-common:
type: object
required:
- success
- errors
- messages
- result
properties:
errors:
$ref: '#/components/schemas/messages'
messages:
$ref: '#/components/schemas/messages'
result:
anyOf:
- type: object
- type: array
items: {}
- type: string
success:
type: boolean
description: Whether the API call was successful
enum:
- true
example: true
api-response-common-failure:
type: object
required:
- success
- errors
- messages
- result
properties:
errors:
allOf:
- $ref: '#/components/schemas/messages'
example:
- code: 7003
message: No route for the URI
minLength: 1
messages:
allOf:
- $ref: '#/components/schemas/messages'
example: []
result:
enum:
- null
nullable: true
success:
type: boolean
description: Whether the API call was successful
enum:
- false
example: false
api-response-single:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
anyOf:
- type: object
- type: string
nullable: true
type: object
api-response-single-id:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
nullable: true
required:
- id
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
type: object
api-shield:
allOf:
- $ref: '#/components/schemas/operation'
api_access_enabled:
type: boolean
description: Enterprise only. Indicates whether or not API access is enabled
specifically for this user on a given account.
example: true
nullable: true
app-types:
oneOf:
- $ref: '#/components/schemas/application'
- $ref: '#/components/schemas/application_type'
type: object
readOnly: true
app-types_components-schemas-name:
type: string
description: The name of the application or application type.
example: Facebook
app-types_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/app-types'
app_components-schemas-created:
type: string
format: date-time
description: When the Application was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
app_components-schemas-modified:
type: string
format: date-time
description: When the Application was last modified.
example: "2014-01-02T02:20:00Z"
readOnly: true
app_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
app_domain:
type: string
description: The URL of the Access application.
example: test.example.com/admin
app_id:
type: string
description: Application identifier.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
app_launcher_props:
allOf:
- $ref: '#/components/schemas/feature_app_props'
- properties:
domain:
example: authdomain.cloudflareaccess.com
readOnly: true
name:
default: App Launcher
example: App Launcher
readOnly: true
type:
type: string
description: The application type.
example: app_launcher
app_launcher_visible:
type: boolean
description: Displays the application in the App Launcher.
default: true
example: true
app_type_id:
type: integer
description: The identifier for the type of this application. There can be many
applications with the same type. This refers to the `id` of an Application
Type that has been returned.
app_uid:
description: The unique identifier for the Access application.
example: df7e2w5f-02b7-4d9d-af26-8d1988fca630
application:
type: object
properties:
application_type_id:
$ref: '#/components/schemas/app_type_id'
created_at:
$ref: '#/components/schemas/timestamp'
id:
$ref: '#/components/schemas/components-schemas-app_id'
name:
$ref: '#/components/schemas/app-types_components-schemas-name'
application_type:
type: object
properties:
created_at:
$ref: '#/components/schemas/timestamp'
description:
type: string
description: A short summary of applications with this type.
example: Applications used to communicate or collaborate in a business setting.
id:
$ref: '#/components/schemas/app_type_id'
name:
$ref: '#/components/schemas/app-types_components-schemas-name'
approval_group:
type: object
description: A group of email addresses that can approve a temporary authentication
request.
required:
- approvals_needed
properties:
approvals_needed:
type: number
description: The number of approvals needed to obtain access.
example: 1
minimum: 0
email_addresses:
type: array
description: A list of emails that can approve the access request.
example:
- test@cloudflare.com
- test2@cloudflare.com
items: {}
email_list_uuid:
type: string
description: The UUID of an re-usable email list.
approval_groups:
type: array
description: Administrators who can approve a temporary authentication request.
example:
- approvals_needed: 1
email_addresses:
- test1@cloudflare.com
- test2@cloudflare.com
- approvals_needed: 3
email_list_uuid: 597147a1-976b-4ef2-9af0-81d5d007fc34
items:
$ref: '#/components/schemas/approval_group'
approval_required:
type: boolean
description: Requires the user to request access from an administrator at the
start of each session.
default: false
example: true
approved:
type: string
description: Approval state of the prefix (P = pending, V = active).
example: P
apps:
anyOf:
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/self_hosted_props'
type: object
title: Self Hosted Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/saas_props'
type: object
title: SaaS Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/ssh_props'
type: object
title: Browser SSH Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/vnc_props'
type: object
title: Browser VNC Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/app_launcher_props'
type: object
title: App Launcher Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/warp_props'
type: object
title: Device Enrollment Permissions Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/biso_props'
type: object
title: Browser Isolation Permissions Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/bookmark_props'
type: object
title: Bookmark application
apps_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
apps_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
apps_components-schemas-name:
type: string
description: The name of the application.
example: Admin Site
apps_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/apps'
apps_components-schemas-response_collection-2:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-apps'
apps_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/apps'
apps_components-schemas-single_response-2:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-apps'
apps_components-schemas-type:
type: string
description: The application type.
enum:
- self_hosted
- saas
- ssh
- vnc
- app_launcher
- warp
- biso
- bookmark
- dash_sso
example: self_hosted
arch:
type: string
description: The cloudflared OS architecture used to establish this connection.
example: linux_amd64
argo-tunnel:
type: object
required:
- id
- name
- created_at
- connections
properties:
connections:
type: array
description: The tunnel connections between your origin and Cloudflare's
edge.
items:
$ref: '#/components/schemas/argo-tunnel_components-schemas-connection'
created_at:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-created_at'
deleted_at:
$ref: '#/components/schemas/schemas-deleted_at'
id:
$ref: '#/components/schemas/tunnel_id'
name:
$ref: '#/components/schemas/tunnel_name'
argo-tunnel_components-schemas-connection:
properties:
colo_name:
$ref: '#/components/schemas/schemas-colo_name'
is_pending_reconnect:
$ref: '#/components/schemas/is_pending_reconnect'
uuid:
$ref: '#/components/schemas/connection_id'
argo-tunnel_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: object
argo_smart_routing:
type: boolean
description: |-
Enables Argo Smart Routing for this application.
Notes: Only available for TCP applications with traffic_type set to "direct".
default: false
example: true
asn:
type: integer
description: Autonomous System Number (ASN) the prefix will be advertised under.
nullable: true
asn_components-schemas-asn:
properties:
asn:
$ref: '#/components/schemas/components-schemas-asn'
country:
$ref: '#/components/schemas/asn_country'
description:
$ref: '#/components/schemas/asn_description'
domain_count:
type: integer
top_domains:
type: array
example:
- example.com
items:
type: string
type:
$ref: '#/components/schemas/asn_type'
asn_components-schemas-response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/asn_components-schemas-asn'
asn_configuration:
title: An ASN configuration.
properties:
target:
description: The configuration target. You must set the target to `asn`
when specifying an Autonomous System Number (ASN) in the rule.
enum:
- asn
example: asn
value:
type: string
description: The AS number to match.
example: AS12345
asn_country:
type: string
example: US
asn_description:
type: string
example: CLOUDFLARENET
asn_type:
type: string
description: Infrastructure type of this ASN.
enum:
- hosting_provider
- isp
- organization
example: hosting_provider
associated_hostnames:
type: array
description: The hostnames of the applications that will use this certificate.
items:
type: string
description: A fully-qualified domain name (FQDN).
example: admin.example.com
attack_mitigation:
type: object
description: Attack mitigation settings.
nullable: true
properties:
enabled:
type: boolean
description: When enabled, random-prefix attacks are automatically mitigated
and the origin DNS servers protected.
example: true
only_when_origin_unhealthy:
type: boolean
description: Only mitigate attacks when origin servers seem unhealthy.
default: true
example: false
aud:
type: string
description: The Application Audience (AUD) tag. Identifies the application
associated with the CA.
example: 737646a56ab1df6ec9bddc7e5ca84eaf3b0768850f3ffb5d74f1534911fe3893
readOnly: true
maxLength: 64
audit-logs:
type: object
properties:
action:
type: object
properties:
result:
type: boolean
description: A boolean that indicates if the action attempted was successful.
example: true
type:
type: string
description: A short string that describes the action that was performed.
example: change_setting
actor:
type: object
properties:
email:
type: string
format: email
description: The email of the user that performed the action.
example: michelle@example.com
id:
type: string
description: The ID of the actor that performed the action. If a user
performed the action, this will be their User ID.
example: f6b5de0326bb5182b8a4840ee01ec774
ip:
type: string
description: The IP address of the request that performed the action.
example: 198.41.129.166
type:
type: string
description: The type of actor, whether a User, Cloudflare Admin, or
an Automated System.
enum:
- user
- admin
- Cloudflare
example: user
id:
type: string
description: A string that uniquely identifies the audit log.
example: d5b0f326-1232-4452-8858-1089bd7168ef
interface:
type: string
description: The source of the event.
example: API
metadata:
type: object
description: An object which can lend more context to the action being logged.
This is a flexible value and varies between different actions.
example:
name: security_level
type: firewall
value: high
zone_name: example.com
newValue:
type: string
description: The new value of the resource that was modified.
example: low
oldValue:
type: string
description: The value of the resource before it was modified.
example: high
owner:
type: object
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
resource:
type: object
properties:
id:
type: string
description: An identifier for the resource that was affected by the
action.
example: 023e105f4ecef8ad9ca31a8372d0c353
type:
type: string
description: A short string that describes the resource that was affected
by the action.
example: zone
when:
type: string
format: date-time
description: A UTC RFC3339 timestamp that specifies when the action being
logged occured.
example: "2017-04-26T17:31:07Z"
audit_logs_response_collection:
oneOf:
- properties:
errors:
nullable: true
messages:
type: array
example: []
items: {}
result:
type: array
items:
$ref: '#/components/schemas/audit-logs'
success:
type: boolean
example: true
- $ref: '#/components/schemas/api-response-common'
auth_domain:
type: string
description: The unique subdomain assigned to your Zero Trust organization.
example: test.cloudflareaccess.com
auth_id_tokens:
type: integer
description: The total number of auth-ids seen across this calculation.
readOnly: true
auto_connect:
type: number
description: The amount of time in minutes to reconnect after having been disabled.
example: 0
auto_redirect_to_identity:
type: boolean
description: When set to `true`, users skip the identity provider selection
step during login. You must specify only one identity provider in allowed_idps.
default: false
auto_refresh_seconds:
type: number
description: |-
How often should a secondary zone auto refresh regardless of DNS NOTIFY.
Not applicable for primary zones.
example: 86400
auto_renew:
type: boolean
description: Auto-renew controls whether subscription is automatically renewed
upon domain expiration.
example: true
automatic_https_rewrites:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- automatic_https_rewrites
example: automatic_https_rewrites
value:
$ref: '#/components/schemas/automatic_https_rewrites_value'
title: Zone Enable Automatic HTTPS Rewrites
description: Enable the Automatic HTTPS Rewrites feature for this zone.
default: "off"
automatic_https_rewrites_value:
type: string
description: |-
Value of the zone setting.
Notes: Default value depends on the zone's plan level.
enum:
- "on"
- "off"
default: "on"
automatic_platform_optimization:
type: object
required:
- enabled
- cf
- wordpress
- wp_plugin
- hostnames
- cache_by_device_type
properties:
cache_by_device_type:
type: boolean
description: Indicates whether or not [cache by device type](https://developers.cloudflare.com/automatic-platform-optimization/reference/cache-device-type/)
is enabled.
example: false
cf:
type: boolean
description: Indicates whether or not Cloudflare proxy is enabled.
default: false
example: true
enabled:
type: boolean
description: Indicates whether or not Automatic Platform Optimization is
enabled.
default: false
example: true
hostnames:
type: array
description: An array of hostnames where Automatic Platform Optimization
for WordPress is activated.
example:
- www.example.com
- example.com
- shop.example.com
items:
type: string
format: hostname
wordpress:
type: boolean
description: Indicates whether or not site is powered by WordPress.
default: false
example: true
wp_plugin:
type: boolean
description: Indicates whether or not [Cloudflare for WordPress plugin](https://wordpress.org/plugins/cloudflare/)
is installed.
default: false
example: true
availability_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
type: string
format: hostname
description: Name of zone based on which account custom nameservers
can be created. For example, if example.com is returned, then ns1.example.com
can be used as an account custom nameserver.
example: example.com
readOnly: true
available:
type: boolean
description: When true, the Managed Transform is available in the current Cloudflare
plan.
example: true
available-rate-plan:
type: object
properties:
can_subscribe:
$ref: '#/components/schemas/can_subscribe'
currency:
$ref: '#/components/schemas/currency'
externally_managed:
$ref: '#/components/schemas/externally_managed'
frequency:
$ref: '#/components/schemas/schemas-frequency'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
is_subscribed:
$ref: '#/components/schemas/is_subscribed'
legacy_discount:
$ref: '#/components/schemas/legacy_discount'
legacy_id:
$ref: '#/components/schemas/legacy_id'
name:
$ref: '#/components/schemas/rate-plan_components-schemas-name'
price:
$ref: '#/components/schemas/schemas-price'
azure_group_rule:
type: object
title: Azure group
description: |-
Matches an Azure group.
Requires an Azure identity provider.
required:
- azureAD
properties:
azureAD:
type: object
required:
- id
- connection_id
properties:
connection_id:
type: string
description: The ID of your Azure identity provider.
example: ea85612a-29c8-46c2-bacb-669d65136971
id:
type: string
description: The ID of an Azure group.
example: aa0a4aab-672b-4bdb-bc33-a59f1130a11f
bandwidth:
type: object
description: Breakdown of totals for bandwidth in the form of bytes.
properties:
all:
type: integer
description: The total number of bytes served within the time frame.
cached:
type: integer
description: The number of bytes that were cached (and served) by Cloudflare.
content_type:
type: object
description: A variable list of key/value pairs where the key represents
the type of content served, and the value is the number in bytes served.
example:
css: 237421
gif: 1.234242e+06
html: 1.23129e+06
javascript: 123245
jpeg: 784278
country:
type: object
description: A variable list of key/value pairs where the key is a two-digit
country code and the value is the number of bytes served to that country.
example:
AG: 2.342483e+06
GI: 984753
US: 1.23145433e+08
ssl:
type: object
description: A break down of bytes served over HTTPS.
properties:
encrypted:
type: integer
description: The number of bytes served over HTTPS.
unencrypted:
type: integer
description: The number of bytes served over HTTP.
ssl_protocols:
type: object
description: A breakdown of requests by their SSL protocol.
properties:
TLSv1:
type: integer
description: The number of requests served over TLS v1.0.
TLSv1.1:
type: integer
description: The number of requests served over TLS v1.1.
TLSv1.2:
type: integer
description: The number of requests served over TLS v1.2.
TLSv1.3:
type: integer
description: The number of requests served over TLS v1.3.
none:
type: integer
description: The number of requests served over HTTP.
uncached:
type: integer
description: The number of bytes that were fetched and served from the origin
server.
bandwidth_by_colo:
type: object
description: Breakdown of totals for bandwidth in the form of bytes.
properties:
all:
type: integer
description: The total number of bytes served within the time frame.
cached:
type: integer
description: The number of bytes that were cached (and served) by Cloudflare.
uncached:
type: integer
description: The number of bytes that were fetched and served from the origin
server.
base:
type: object
required:
- invited_member_id
- organization_id
properties:
expires_on:
$ref: '#/components/schemas/schemas-expires_on'
id:
$ref: '#/components/schemas/invite_components-schemas-identifier'
invited_by:
$ref: '#/components/schemas/invited_by'
invited_member_email:
$ref: '#/components/schemas/invited_member_email'
invited_member_id:
type: string
description: ID of the user to add to the organization.
example: 5a7805061c76ada191ed06f989cc3dac
nullable: true
readOnly: true
maxLength: 32
invited_on:
$ref: '#/components/schemas/invited_on'
organization_id:
type: string
description: ID of the organization the user will be added to.
example: 5a7805061c76ada191ed06f989cc3dac
readOnly: true
maxLength: 32
organization_name:
type: string
description: Organization name.
example: Cloudflare, Inc.
readOnly: true
maxLength: 100
roles:
type: array
description: Roles to be assigned to this user.
items:
$ref: '#/components/schemas/schemas-role'
basic_app_response_props:
type: object
properties:
aud:
$ref: '#/components/schemas/schemas-aud'
created_at:
$ref: '#/components/schemas/timestamp'
id:
$ref: '#/components/schemas/uuid'
updated_at:
$ref: '#/components/schemas/timestamp'
batch_size:
type: number
example: 10
beta:
type: boolean
description: Whether the category is in beta and subject to change.
example: false
billing-history:
type: object
required:
- id
- type
- action
- description
- occurred_at
- amount
- currency
- zone
properties:
action:
$ref: '#/components/schemas/action'
amount:
$ref: '#/components/schemas/amount'
currency:
$ref: '#/components/schemas/currency'
description:
$ref: '#/components/schemas/schemas-description'
id:
$ref: '#/components/schemas/billing-history_components-schemas-identifier'
occurred_at:
$ref: '#/components/schemas/occurred_at'
type:
$ref: '#/components/schemas/type'
zone:
$ref: '#/components/schemas/schemas-zone'
billing-history_components-schemas-identifier:
type: string
description: Billing item identifier tag.
example: b69a9f3492637782896352daae219e7d
readOnly: true
maxLength: 32
billing_history_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/billing-history'
billing_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
binding:
oneOf:
- $ref: '#/components/schemas/kv_namespace_binding'
- $ref: '#/components/schemas/wasm_module_binding'
binding_name:
type: string
description: A JavaScript variable name for the binding.
example: myBinding
readOnly: true
biso_props:
allOf:
- $ref: '#/components/schemas/feature_app_props'
- properties:
domain:
example: authdomain.cloudflareaccess.com/browser
readOnly: true
name:
default: Clientless Web Isolation
example: Clientless Web Isolation
readOnly: true
type:
type: string
description: The application type.
example: biso
block-page-settings:
type: object
description: Block page layout settings.
properties:
background_color:
type: string
description: 'Block page background color in #rrggbb format.'
enabled:
type: boolean
description: Enable only cipher suites and TLS versions compliant with FIPS
140-2.
example: true
footer_text:
type: string
description: Block page footer text.
example: --footer--
header_text:
type: string
description: Block page header text.
example: --header--
logo_path:
type: string
description: Full URL to the logo file.
example: https://logos.com/a.png
mailto_address:
type: string
description: Admin email for users to contact.
example: admin@example.com
mailto_subject:
type: string
description: Subject line for emails created from block page.
example: Blocked User Inquiry
name:
type: string
description: Block page title.
example: Cloudflare
suppress_footer:
type: boolean
description: Suppress detailed info at the bottom of the block page.
example: false
body:
type: string
description: The response body to return. The value must conform to the configured
content type.
example: This request has been rate-limited.
maxLength: 10240
bookmark_props:
type: object
title: Bookmark application
properties:
app_launcher_visible:
default: true
domain:
description: The URL or domain of the bookmark.
example: https://mybookmark.com
logo_url:
$ref: '#/components/schemas/logo_url'
name:
$ref: '#/components/schemas/apps_components-schemas-name'
type:
type: string
description: The application type.
example: bookmark
bookmarks:
type: object
properties:
app_launcher_visible:
$ref: '#/components/schemas/schemas-app_launcher_visible'
created_at:
$ref: '#/components/schemas/timestamp'
domain:
$ref: '#/components/schemas/components-schemas-domain'
id:
description: The unique identifier for the Bookmark application.
logo_url:
$ref: '#/components/schemas/logo_url'
name:
$ref: '#/components/schemas/bookmarks_components-schemas-name'
updated_at:
$ref: '#/components/schemas/timestamp'
bookmarks_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
bookmarks_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
bookmarks_components-schemas-name:
type: string
description: The name of the Bookmark application.
example: My Website
bookmarks_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/bookmarks'
bookmarks_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/bookmarks'
brand_check:
type: boolean
description: Certificate Authority is manually reviewing the order.
example: false
brotli:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- brotli
example: brotli
value:
$ref: '#/components/schemas/brotli_value'
title: Brotli Compression
description: When the client requesting an asset supports the Brotli compression
algorithm, Cloudflare will serve a Brotli compressed version of the asset.
brotli_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
browser-isolation-settings:
type: object
description: Browser isolation settings.
properties:
url_browser_isolation_enabled:
type: boolean
description: Enable Browser Isolation.
example: true
browser_cache_ttl:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- browser_cache_ttl
example: browser_cache_ttl
value:
$ref: '#/components/schemas/browser_cache_ttl_value'
title: Browser Cache TTL
description: Browser Cache TTL (in seconds) specifies how long Cloudflare-cached
resources will remain on your visitors' computers. Cloudflare will honor any
larger times specified by your server. (https://support.cloudflare.com/hc/en-us/articles/200168276).
browser_cache_ttl_value:
type: number
description: |-
Value of the zone setting.
Notes: Setting a TTL of 0 is equivalent to selecting `Respect Existing Headers`
enum:
- 0
- 30
- 60
- 120
- 300
- 1200
- 1800
- 3600
- 7200
- 10800
- 14400
- 18000
- 28800
- 43200
- 57600
- 72000
- 86400
- 172800
- 259200
- 345600
- 432000
- 691200
- 1.3824e+06
- 2.0736e+06
- 2.6784e+06
- 5.3568e+06
- 1.60704e+07
- 3.1536e+07
default: 14400
browser_check:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- browser_check
example: browser_check
value:
$ref: '#/components/schemas/browser_check_value'
title: Browser Check
description: Browser Integrity Check is similar to Bad Behavior and looks for
common HTTP headers abused most commonly by spammers and denies access to
your page. It will also challenge visitors that do not have a user agent
or a non standard user agent (also commonly used by abuse bots, crawlers or
visitors). (https://support.cloudflare.com/hc/en-us/articles/200170086).
browser_check_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
bucket_name:
type: string
description: Name of the bucket. The name must be greater than 2 and less than
64 characters.
example: example-bucket
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]
build:
type: string
description: The build identifier for the Railgun receiver.
example: b1234
readOnly: true
build_config:
type: object
description: Configs for the project build process.
properties:
build_command:
type: string
description: Command used to build project.
example: npm run build
nullable: true
destination_dir:
type: string
description: Output directory of the build.
example: build
nullable: true
root_dir:
type: string
description: Directory to run the command.
example: /
nullable: true
web_analytics_tag:
type: string
description: The classifying tag for analytics.
example: cee1c73f6e4743d0b5e6bb1a0bcaabcc
nullable: true
web_analytics_token:
type: string
description: The auth token for analytics.
example: 021e1057c18547eca7b79f2516f06o7x
nullable: true
bulk-operation-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
$ref: '#/components/schemas/schemas-operation'
bulk_delete:
type: array
items:
$ref: '#/components/schemas/key_name_bulk'
bulk_write:
type: array
items:
type: object
properties:
base64:
type: boolean
description: Whether or not the server should base64 decode the value
before storing it. Useful for writing values that wouldn't otherwise
be valid JSON strings, such as images.
default: false
expiration:
$ref: '#/components/schemas/expiration'
expiration_ttl:
$ref: '#/components/schemas/expiration_ttl'
key:
$ref: '#/components/schemas/key_name_bulk'
metadata:
$ref: '#/components/schemas/list_metadata'
value:
type: string
description: A UTF-8 encoded string to be stored, up to 10 MB in length.
example: Some string
maxLength: 10485760
required:
- key
- value
bundle_method:
type: string
description: A ubiquitous bundle has the highest probability of being verified
everywhere, even by clients using outdated or unusual trust stores. An optimal
bundle uses the shortest chain and newest intermediates. And the force bundle
verifies the chain, but does not otherwise modify it.
enum:
- ubiquitous
- optimal
- force
default: ubiquitous
example: ubiquitous
bypass:
type: array
description: Criteria specifying when the current rate limit should be bypassed.
You can specify that the rate limit should not apply to one or more URLs.
items:
type: object
properties:
name:
type: string
enum:
- url
example: url
value:
type: string
description: The URL to bypass.
example: api.example.com/*
ca:
type: object
properties:
aud:
$ref: '#/components/schemas/aud'
id:
$ref: '#/components/schemas/ca_components-schemas-id'
public_key:
$ref: '#/components/schemas/public_key'
ca_components-schemas-id:
type: string
description: The ID of the CA.
example: 7eddae4619b50ab1361ba8ae9bd72269a432fea041529ed9
readOnly: true
maxLength: 48
ca_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/ca_components-schemas-id'
ca_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/ca'
ca_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
cache_level:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- cache_level
example: cache_level
value:
$ref: '#/components/schemas/cache_level_value'
title: Cloudflare Cache Level
description: Cache Level functions based off the setting level. The basic setting
will cache most static resources (i.e., css, images, and JavaScript). The
simplified setting will ignore the query string when delivering a cached resource.
The aggressive setting will cache all static resources, including ones with
a query string. (https://support.cloudflare.com/hc/en-us/articles/200168256).
cache_level_value:
type: string
description: Value of the zone setting.
enum:
- aggressive
- basic
- simplified
default: aggressive
cache_reserve:
allOf:
- $ref: '#/components/schemas/components-schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- cache_reserve
example: cache_reserve
title: Cache Reserve
description: 'Increase cache lifetimes by automatically storing all cacheable
files into Cloudflare''s persistent object storage buckets. Requires Cache
Reserve subscription. Note: using Tiered Cache with Cache Reserve is highly
recommended to reduce Reserve operations costs. See the [developer docs](https://developers.cloudflare.com/cache/about/cache-reserve)
for more information.'
cache_reserve_response_value:
properties:
result:
allOf:
- $ref: '#/components/schemas/cache_reserve'
- required:
- value
properties:
value:
$ref: '#/components/schemas/cache_reserve_value'
cache_reserve_value:
type: string
description: Value of the Cache Reserve zone setting.
enum:
- "on"
- "off"
default: "off"
can_delete:
type: boolean
description: If set to false, then the Address Map cannot be deleted via API.
This is true for Cloudflare-managed maps.
example: true
readOnly: true
can_modify_ips:
type: boolean
description: If set to false, then the IPs on the Address Map cannot be modified
via the API. This is true for Cloudflare-managed maps.
example: true
readOnly: true
can_register:
type: boolean
description: Indicates if the domain can be registered as a new domain.
example: false
can_subscribe:
type: boolean
description: Indicates whether you can subscribe to this plan.
default: false
example: true
caption_basic_upload:
type: object
required:
- file
properties:
file:
type: string
description: The WebVTT file containing the caption or subtitle content.
example: '@/Users/kyle/Desktop/tr.vtt'
captions:
type: object
properties:
label:
$ref: '#/components/schemas/label'
language:
$ref: '#/components/schemas/language'
captive_portal:
type: number
description: Turn on the captive portal after the specified amount of time.
example: 180
catch_all_rule_response_single:
type: object
properties:
actions:
$ref: '#/components/schemas/catchall-actions'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled'
matchers:
$ref: '#/components/schemas/catchall-matchers'
name:
$ref: '#/components/schemas/rules_components-schemas-name'
tag:
$ref: '#/components/schemas/rule_identifier'
catchall-action:
type: object
description: Action for the catch-all routing rule.
required:
- type
properties:
type:
type: string
description: Type of action for catch-all rule.
enum:
- drop
- forward
- worker
example: forward
value:
type: array
items:
type: string
description: Input value for action.
example: destinationaddress@example.net
maxLength: 90
catchall-actions:
type: array
description: List actions for the catch-all routing rule.
items:
$ref: '#/components/schemas/catchall-action'
catchall-matcher:
type: object
description: Matcher for catch-all routing rule.
required:
- type
properties:
type:
type: string
description: Type of matcher. Default is 'all'.
enum:
- all
example: all
catchall-matchers:
type: array
description: List of matchers for the catch-all routing rule.
items:
$ref: '#/components/schemas/catchall-matcher'
categories:
type: array
description: The categories of the rule.
example:
- directory-traversal
- header
items:
$ref: '#/components/schemas/category'
categories_components-schemas-description:
type: string
description: A short summary of domains in the category.
example: Sites related to educational content that are not included in other
categories like Science, Technology or Educational institutions.
categories_components-schemas-id:
type: integer
description: The identifier for this category. There is only one category per
id.
categories_components-schemas-name:
type: string
description: The name of the category.
example: Education
categories_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-categories'
category:
type: string
description: A category of the rule.
example: directory-traversal
cert_pack_uuid:
type: string
description: Certificate Pack UUID.
example: a77f8bd7-3b47-46b4-a6f1-75cf98109948
certificate:
type: string
description: The zone's SSL certificate or certificate and the intermediate(s).
example: |
-----BEGIN CERTIFICATE-----
MIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
BAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX
aWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF
MQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50
ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1
CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB
KwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5
0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI
dZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2
izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4
9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI
GKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV
BAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF
MAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2
2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP
Mlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG
SvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq
2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw
YbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=
-----END CERTIFICATE-----
certificate-packs_components-schemas-identifier:
type: string
description: The unique identifier for a certificate_pack.
example: 3822ff90-ea29-44df-9e55-21300bb9419b
readOnly: true
certificate-packs_components-schemas-status:
type: string
description: Status of certificate pack.
enum:
- initializing
- pending_validation
- deleted
- pending_issuance
- pending_deployment
- pending_deletion
- pending_expiration
- expired
- active
- initializing_timed_out
- validation_timed_out
- issuance_timed_out
- deployment_timed_out
- deletion_timed_out
- pending_cleanup
- staging_deployment
- staging_active
- deactivating
- inactive
- backup_issued
- holding_deployment
example: initializing
certificate_analyze_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
certificate_authority:
type: string
description: 'Certificate Authority selected for the order. Selecting Let''s
Encrypt will reduce customization of other fields: validation_method must
be ''txt'', validity_days must be 90, cloudflare_branding must be omitted,
and hosts must contain only 2 entries, one for the zone name and one for the
subdomain wildcard of the zone name (e.g. example.com, *.example.com).'
enum:
- digicert
- google
- lets_encrypt
example: digicert
certificate_pack_quota_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
advanced:
$ref: '#/components/schemas/quota'
certificate_pack_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
certificate_pack_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
certificate_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/custom-certificate'
certificate_response_id_only:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
certificate_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
certificate_response_single_id:
allOf:
- $ref: '#/components/schemas/schemas-certificate_response_single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/certificates_components-schemas-identifier'
certificate_rule:
type: object
title: Valid certificate
description: Matches any valid client certificate.
example:
certificate: {}
required:
- certificate
properties:
certificate:
type: object
example: {}
certificate_status:
type: string
description: Current status of certificate.
enum:
- initializing
- authorizing
- active
- expired
- issuing
- timing_out
- pending_deployment
example: active
certificateObject:
properties:
certificate:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-certificate'
expires_on:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-expires_on'
id:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-identifier'
issuer:
$ref: '#/components/schemas/issuer'
signature:
$ref: '#/components/schemas/signature'
status:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-status'
uploaded_on:
$ref: '#/components/schemas/schemas-uploaded_on'
certificates:
type: object
required:
- hostnames
- csr
- requested_validity
- request_type
properties:
certificate:
$ref: '#/components/schemas/components-schemas-certificate'
csr:
$ref: '#/components/schemas/csr'
expires_on:
$ref: '#/components/schemas/certificates_components-schemas-expires_on'
hostnames:
$ref: '#/components/schemas/hostnames'
id:
$ref: '#/components/schemas/certificates_components-schemas-identifier'
request_type:
$ref: '#/components/schemas/request_type'
requested_validity:
$ref: '#/components/schemas/requested_validity'
certificates_components-schemas-expires_on:
type: string
format: date-time
description: When the certificate will expire.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
certificates_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
certificates_components-schemas-identifier:
type: string
description: The x509 serial number of the Origin CA certificate.
example: "328578533902268680212849205732770752308931942346"
readOnly: true
certificates_components-schemas-name:
type: string
description: The name of the certificate.
example: Allow devs
certificates_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-certificates'
certificates_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-certificates'
cf_account_id:
type: string
description: Cloudflare account ID
example: 699d98642c564d2e855e9661899b7252
maxLength: 32
challenge_ttl:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- challenge_ttl
example: challenge_ttl
value:
$ref: '#/components/schemas/challenge_ttl_value'
title: Challenge Page TTL
description: Specify how long a visitor is allowed access to your site after
successfully completing a challenge (such as a CAPTCHA). After the TTL has
expired the visitor will have to complete a new challenge. We recommend a
15 - 45 minute setting and will attempt to honor any setting above 45 minutes.
(https://support.cloudflare.com/hc/en-us/articles/200170136).
challenge_ttl_value:
type: number
description: Value of the zone setting.
enum:
- 300
- 900
- 1800
- 2700
- 3600
- 7200
- 10800
- 14400
- 28800
- 57600
- 86400
- 604800
- 2.592e+06
- 3.1536e+07
default: 1800
characteristics:
type: array
uniqueItems: true
maxItems: 10
items:
type: object
required:
- type
- name
properties:
name:
$ref: '#/components/schemas/characteristics_components-schemas-name'
type:
$ref: '#/components/schemas/schemas-type'
characteristics_components-schemas-name:
type: string
description: The name of the characteristic field, i.e., the header or cookie
name.
example: authorization
maxLength: 128
check_regions:
type: array
description: A list of regions from which to run health checks. Null means every
Cloudflare data center.
example:
- WEU
- ENAM
nullable: true
items:
type: string
description: 'WNAM: Western North America, ENAM: Eastern North America, WEU:
Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM:
Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa,
SAF: South Africa, SAS: Southern Asia, SEAS: South East Asia, NEAS: North
East Asia, ALL_REGIONS: all regions (ENTERPRISE customers only).'
enum:
- WNAM
- ENAM
- WEU
- EEU
- NSAM
- SSAM
- OC
- ME
- NAF
- SAF
- SAS
- SEAS
- NEAS
- ALL_REGIONS
cidr:
type: string
description: IP Prefix in Classless Inter-Domain Routing format.
example: 192.0.2.0/24
cidr_configuration:
title: An IP address range configuration.
properties:
target:
description: The configuration target. You must set the target to `ip_range`
when specifying an IP address range in the rule.
enum:
- ip_range
example: ip_range
value:
type: string
description: The IP address range to match. You can only use prefix lengths
`/16` and `/24` for IPv4 ranges, and prefix lengths `/32`, `/48`, and
`/64` for IPv6 ranges.
example: 198.51.100.4/16
cidr_list:
type: array
description: List of IPv4/IPv6 CIDR addresses.
example:
- 199.27.128.0/21
- 2400:cb00::/32
items:
type: string
description: IPv4/IPv6 CIDR.
example: 199.27.128.0/21
ciphers:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- ciphers
example: ciphers
value:
$ref: '#/components/schemas/ciphers_value'
title: Zone ciphers allowed for TLS termination
description: An allowlist of ciphers for TLS termination. These ciphers must
be in the BoringSSL format.
default: []
ciphers_value:
type: array
description: Value of the zone setting.
default: []
example:
- ECDHE-RSA-AES128-GCM-SHA256
- AES128-SHA
uniqueItems: true
items:
type: string
city:
type: string
description: City.
example: Austin
class:
type: string
description: Which account types are allowed to create policies based on this
categories. `blocked` categories are blocked unconditionally for all accounts.
`removalPending` categories can be removed from policies but not added. `noBlock`
categories cannot be blocked.
enum:
- free
- premium
- blocked
- removalPending
- noBlock
example: premium
client-default:
type: boolean
description: Set if the location is the default one.
example: false
client_id:
type: string
description: The Client ID for the service token. Access will check for this
value in the `CF-Access-Client-ID` request header.
example: 88bf3b6d86161464f6509f7219099e57.access.example.com
client_secret:
type: string
description: The Client Secret for the service token. Access will check for
this value in the `CF-Access-Client-Secret` request header.
example: bdd31cbc4dec990953e39163fbbb194c93313ca9f0a6e420346af9d326b1d2a5
clipResponseSingle:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/schemas-output'
clipped_from_video_uid:
type: string
description: The unique video identifier (UID).
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
clipping_components-schemas-created:
type: string
format: date-time
description: The date and time the live input was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
cloudflare-tunnel_components-schemas-connection:
properties:
client_id:
description: UUID of the cloudflared instance.
client_version:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-version'
colo_name:
$ref: '#/components/schemas/schemas-colo_name'
id:
$ref: '#/components/schemas/connection_id'
is_pending_reconnect:
$ref: '#/components/schemas/is_pending_reconnect'
opened_at:
type: string
format: date-time
description: Timestamp of when the connection was established.
example: "2021-01-25T18:22:34.317854Z"
origin_ip:
type: string
description: The public IP address of the host running cloudflared.
example: 85.12.78.6
uuid:
$ref: '#/components/schemas/connection_id'
cloudflare-tunnel_components-schemas-created_at:
type: string
format: date-time
description: Timestamp of when the tunnel was created.
example: "2021-01-25T18:22:34.317854Z"
cloudflare-tunnel_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: object
cloudflare-tunnel_components-schemas-metadata:
type: object
description: Metadata associated with the tunnel.
example: {}
cloudflare-tunnel_components-schemas-status:
type: string
description: The status of the tunnel. Valid values are `active`, `inactive`
or `degraded` (active but not all cloudflared instances have 4 connections
to Cloudflare's edge).
example: active
cloudflare-tunnel_components-schemas-version:
type: string
description: The cloudflared version used to establish this connection.
example: 2022.7.1
cloudflare_branding:
type: boolean
description: Whether or not to add Cloudflare Branding for the order. This
will add sni.cloudflaressl.com as the Common Name if set true.
example: false
cloudflare_gre_endpoint:
type: string
description: The IP address assigned to the Cloudflare side of the GRE tunnel.
example: 203.0.113.1
cloudflare_ipsec_endpoint:
type: string
description: The IP address assigned to the Cloudflare side of the IPsec tunnel.
example: 203.0.113.1
cname_flattening:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: How to flatten the cname destination.
enum:
- cname_flattening
example: flatten_at_root
value:
$ref: '#/components/schemas/cname_flattening_value'
title: Cloudflare CNAME Flattening
description: Whether or not cname flattening is on.
cname_flattening_value:
type: string
description: Value of the cname flattening setting.
enum:
- flatten_at_root
- flatten_all
default: flatten_at_root
code:
type: string
description: The unique activation code for the account membership.
example: 05dd05cce12bbed97c0d87cd78e89bc2fd41a6cee72f27f6fc84af2e45c0fac0
readOnly: true
maxLength: 64
collection_invite_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/invite'
collection_member_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-member'
collection_membership_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/membership'
collection_organization_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/organization'
collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
errors:
type: array
items: {}
messages:
type: array
items: {}
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/api-shield'
- properties:
features: {}
collection_response_paginated:
anyOf:
- allOf:
- $ref: '#/components/schemas/collection_response'
- properties:
result_info:
type: object
properties:
count:
type: number
description: Total results returned based on your search parameters.
example: 1
page:
type: number
description: Current page within paginated list of results.
example: 1
per_page:
type: number
description: Number of results per page of results.
example: 20
total_count:
type: number
description: Total results available without any search parameters.
example: 500
- properties:
result:
type: array
items:
$ref: '#/components/schemas/api-shield'
- $ref: '#/components/schemas/collection_response'
collection_role_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-role'
colo:
type: object
properties:
city:
$ref: '#/components/schemas/colo_city'
name:
$ref: '#/components/schemas/colo_name'
colo_city:
type: string
description: Source colo city.
example: Denver, CO, US
colo_name:
type: string
description: Source colo name.
example: den01
colo_names:
type: array
description: List of colo names for the ECMP scope.
items:
$ref: '#/components/schemas/components-schemas-colo_name'
colo_region:
type: string
description: Scope colo region.
example: APAC
colo_regions:
type: array
description: List of colo regions for the ECMP scope.
items:
$ref: '#/components/schemas/colo_region'
colo_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
query:
$ref: '#/components/schemas/query_response'
result:
$ref: '#/components/schemas/datacenters'
colo_result:
type: object
properties:
colo:
$ref: '#/components/schemas/colo'
error:
$ref: '#/components/schemas/error'
hops:
type: array
items:
$ref: '#/components/schemas/hop_result'
target_summary:
$ref: '#/components/schemas/target_summary'
traceroute_time_ms:
$ref: '#/components/schemas/traceroute_time_ms'
colos:
type: array
description: If no source colo names specified, all colos will be used. China
colos are unavailable for traceroutes.
example:
- den
- sin
items:
type: string
description: Source colo name.
comment:
type: string
description: Optional remark describing the route.
example: Example comment for this route.
common_components-schemas-created_on:
type: string
format: date-time
description: The date and time the tunnel was created.
example: "2017-06-14T00:00:00Z"
readOnly: true
common_components-schemas-identifier:
type: string
description: Identifier
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
common_components-schemas-identifier-2:
type: string
description: Tunnel identifier tag.
example: c4a7362d577a6c3019a474fd6f485821
readOnly: true
maxLength: 32
common_components-schemas-ip:
anyOf:
- $ref: '#/components/schemas/ipv4'
- $ref: '#/components/schemas/schemas-ipv6'
common_components-schemas-modified_on:
type: string
format: date-time
description: The date and time the tunnel was last modified.
example: "2017-06-14T05:20:00Z"
readOnly: true
component-value:
type: object
properties:
default:
$ref: '#/components/schemas/default'
name:
$ref: '#/components/schemas/component-value_components-schemas-name'
unit_price:
$ref: '#/components/schemas/unit_price'
component-value_components-schemas-name:
description: The unique component.
enum:
- zones
- page_rules
- dedicated_certificates
- dedicated_certificates_custom
example: page_rules
component_value:
type: object
description: A component value for a subscription.
properties:
default:
type: number
description: The default amount assigned.
example: 5
name:
type: string
description: The name of the component value.
example: page_rules
price:
type: number
description: The unit price for the component value.
example: 5
value:
type: number
description: The amount of the component value assigned.
example: 20
component_values:
type: array
description: The list of add-ons subscribed to.
items:
$ref: '#/components/schemas/component_value'
components-schemas-account:
allOf:
- $ref: '#/components/schemas/account'
components-schemas-account_identifier:
type: string
description: The account identifier tag.
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
components-schemas-action:
anyOf:
- type: object
properties:
mode:
$ref: '#/components/schemas/mode'
response:
$ref: '#/components/schemas/custom_response'
timeout:
$ref: '#/components/schemas/timeout'
type: object
description: The action to perform when the threshold of matched traffic within
the configured period is exceeded.
components-schemas-address:
type: string
description: Address.
example: 123 Sesame St.
components-schemas-app_id:
type: integer
description: The identifier for this application. There is only one application
per id.
components-schemas-asn:
type: integer
components-schemas-base:
required:
- id
- modified_on
properties:
id:
type: string
description: Identifier of the zone setting.
example: development_mode
modified_on:
type: string
format: date-time
description: last time this setting was modified.
example: "2014-01-01T05:20:00.12345Z"
nullable: true
readOnly: true
components-schemas-certificate:
type: string
description: The Origin CA certificate. Will be newline-encoded.
example: |-
-----BEGIN CERTIFICATE-----
MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxDTALBgNVBAgMBFV0YWgxDzANBgNV
BAcMBkxpbmRvbjEWMBQGA1UECgwNRGlnaUNlcnQgSW5jLjERMA8GA1UECwwIRGln
aUNlcnQxHTAbBgNVBAMMFGV4YW1wbGUuZGlnaWNlcnQuY29tMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA8+To7d+2kPWeBv/orU3LVbJwDrSQbeKamCmo
wp5bqDxIwV20zqRb7APUOKYoVEFFOEQs6T6gImnIolhbiH6m4zgZ/CPvWBOkZc+c
1Po2EmvBz+AD5sBdT5kzGQA6NbWyZGldxRthNLOs1efOhdnWFuhI162qmcflgpiI
WDuwq4C9f+YkeJhNn9dF5+owm8cOQmDrV8NNdiTqin8q3qYAHHJRW28glJUCZkTZ
wIaSR6crBQ8TbYNE0dc+Caa3DOIkz1EOsHWzTx+n0zKfqcbgXi4DJx+C1bjptYPR
BPZL8DAeWuA8ebudVT44yEp82G96/Ggcf7F33xMxe0yc+Xa6owIDAQABoAAwDQYJ
KoZIhvcNAQEFBQADggEBAB0kcrFccSmFDmxox0Ne01UIqSsDqHgL+XmHTXJwre6D
hJSZwbvEtOK0G3+dr4Fs11WuUNt5qcLsx5a8uk4G6AKHMzuhLsJ7XZjgmQXGECpY
Q4mC3yT3ZoCGpIXbw+iP3lmEEXgaQL0Tx5LFl/okKbKYwIqNiyKWOMj7ZR/wxWg/
ZDGRs55xuoeLDJ/ZRFf9bI+IaCUd1YrfYcHIl3G87Av+r49YVwqRDT0VDV7uLgqn
29XI1PpVUNCPQGn9p/eX6Qo7vpDaPybRtA2R7XLKjQaF9oXWeCUqy1hvJac9QFO2
97Ob1alpHPoZ7mWiEuJwjBPii6a9M9G30nUo39lBi1w=
-----END CERTIFICATE-----
readOnly: true
components-schemas-certificate_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/zone-authenticated-origin-pull'
components-schemas-certificate_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-certificateObject'
components-schemas-collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/web3-hostname'
components-schemas-colo_name:
type: string
description: Scope colo name.
example: den01
components-schemas-config:
type: object
description: The tunnel configuration and ingress rules in JSON format. For
syntax and parameters, refer to the [configuration file documentation](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/tunnel-guide/local/local-management/configuration-file/#file-structure).
components-schemas-configuration:
type: object
description: The configuration object for the current rule.
properties:
target:
type: string
description: The configuration target for this rule. You must set the target
to `ua` for User Agent Blocking rules.
example: ua
value:
type: string
description: The exact user agent string to match. This value will be compared
to the received `User-Agent` HTTP header value.
example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4
(KHTML, like Gecko) Version/10.1.1 Safari/603.2.4
components-schemas-connection:
type: string
description: The IdP used to authenticate.
example: saml
components-schemas-created:
type: string
format: date-time
description: The date and a time a watermark profile was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
components-schemas-created_at:
type: string
format: date-time
description: Shows time of creation.
example: "2018-08-28T17:26:26Z"
components-schemas-created_on:
type: string
description: The RFC 3339 timestamp of when the list was created.
example: "2020-01-01T08:00:00Z"
components-schemas-description:
type: string
description: An informative summary of the rate limit. This value is sanitized
and any tags will be removed.
example: Prevent multiple login failures to mitigate brute force attacks
maxLength: 1024
components-schemas-domain:
type: string
description: The domain of the Bookmark application.
example: example.com
components-schemas-email:
type: string
format: email
description: The email of the user.
example: jdoe@example.com
components-schemas-empty_response:
allOf:
- properties:
result:
nullable: true
success:
type: boolean
enum:
- true
- false
example: true
components-schemas-enabled:
type: boolean
description: |-
Disabling Universal SSL removes any currently active Universal SSL certificates for your zone from the edge and prevents any future Universal SSL certificates from being ordered. If there are no dedicated certificates or custom certificates uploaded for the domain, visitors will be unable to access the domain over HTTPS.
By disabling Universal SSL, you understand that the following Cloudflare settings and preferences will result in visitors being unable to visit your domain unless you have uploaded a custom certificate or purchased a dedicated certificate.
* HSTS
* Always Use HTTPS
* Opportunistic Encryption
* Onion Routing
* Any Page Rules redirecting traffic to HTTPS
Similarly, any HTTP redirect to HTTPS at the origin while the Cloudflare proxy is enabled will result in users being unable to visit your site without a valid certificate at Cloudflare's edge.
If you do not have a valid custom or dedicated certificate at Cloudflare's edge and are unsure if any of the above Cloudflare settings are enabled, or if any HTTP redirects exist at your origin, we advise leaving Universal SSL enabled for your domain.
example: true
components-schemas-exclude:
type: array
items:
$ref: '#/components/schemas/split_tunnel'
components-schemas-expires_on:
type: string
format: date-time
description: When the certificate from the authority expires.
example: "2016-01-01T05:20:00Z"
readOnly: true
components-schemas-filters:
type: object
example:
slo:
- "99.9"
components-schemas-frequency:
type: string
description: The frequency at which Cloudflare sends batches of logs to your
destination. Setting frequency to high sends your logs in larger quantities
of smaller files. Setting frequency to low sends logs in smaller quantities
of larger files.
enum:
- high
- low
default: high
example: high
nullable: true
components-schemas-host:
type: string
description: The host name to which the waiting room will be applied (no wildcards).
Please do not include the scheme (http:// or https://). The host and path
combination must be unique.
example: shop.example.com
components-schemas-hostname:
type: string
description: Hostname of the Worker Domain.
example: foo.example.com
components-schemas-id:
type: string
description: Identifier for the tail.
example: 03dc9f77817b488fb26c5861ec18f791
components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/tsig_components-schemas-identifier'
components-schemas-identifier:
type: string
description: Token identifier tag.
example: ed17574386854bf78a67040be0a770b0
readOnly: true
maxLength: 32
components-schemas-interval:
type: integer
description: The interval between each health check. Shorter intervals may give
quicker notifications if the origin status changes, but will increase load
on the origin as we check from multiple locations.
default: 60
components-schemas-ip:
type: string
description: The IP address of the authenticating user.
example: 198.41.129.166
components-schemas-ips:
type: array
description: A list of CIDRs to restrict ingress connections.
items:
type: string
description: The IPv4 CIDR or IPv6 CIDR. IPv6 CIDRs are limited to a maximum
of /109. IPv4 CIDRs are limited to a maximum of /25.
example: 192.0.2.1/32
components-schemas-kind:
type: string
description: The type of the membership.
enum:
- zone
- account
example: zone
components-schemas-match:
type: string
description: The wirefilter expression to match devices.
example: user.identity == "test@cloudflare.com"
maxLength: 500
components-schemas-member:
type: object
required:
- id
- name
- email
- status
- roles
properties:
email:
$ref: '#/components/schemas/email'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
$ref: '#/components/schemas/member_components-schemas-name'
roles:
type: array
description: Roles assigned to this Member.
items:
$ref: '#/components/schemas/schemas-role'
status:
description: A member's status in the organization.
enum:
- accepted
- invited
example: accepted
components-schemas-metadata:
type: string
description: Arbitrary JSON to be associated with a key/value pair.
example: '{"someMetadataKey": "someMetadataValue"}'
components-schemas-mode:
type: string
description: The state of the rules contained in the rule group. When `on`,
the rules in the group are configurable/usable.
enum:
- "on"
- "off"
default: "on"
components-schemas-modified:
type: string
format: date-time
description: The date and time the live input was last modified.
example: "2014-01-02T02:20:00Z"
readOnly: true
components-schemas-modified_on:
type: string
format: date-time
description: When the certificate was last modified.
example: "2014-01-01T05:20:00Z"
readOnly: true
components-schemas-modified_tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_interconnects:
type: array
items:
$ref: '#/components/schemas/interconnect'
components-schemas-monitor:
type: object
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
consecutive_down:
$ref: '#/components/schemas/consecutive_down'
consecutive_up:
$ref: '#/components/schemas/consecutive_up'
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
id:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
modified_on:
$ref: '#/components/schemas/timestamp'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
components-schemas-name:
type: string
description: Role Name.
example: Organization Admin
readOnly: true
maxLength: 120
components-schemas-pattern:
type: object
title: Pattern
description: A pattern that matches an entry
required:
- regex
properties:
regex:
type: string
description: The regex pattern.
example: ^4[0-9]{6,}$
validation:
type: string
description: Validation algorithm for the pattern. This algorithm will get
run on potential matches, and if it returns false, the entry will not
be matched.
enum:
- luhn
example: luhn
components-schemas-paused:
type: boolean
description: When true, indicates that the rule is currently paused.
example: false
components-schemas-policies:
type: object
properties:
alert_type:
$ref: '#/components/schemas/alert_type'
created:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/policies_components-schemas-description'
enabled:
$ref: '#/components/schemas/policies_components-schemas-enabled'
filters:
$ref: '#/components/schemas/components-schemas-filters'
id:
$ref: '#/components/schemas/uuid'
mechanisms:
$ref: '#/components/schemas/mechanisms'
modified:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/policies_components-schemas-name-2'
components-schemas-port:
type: integer
description: 'Port number to connect to for the health check. Required for TCP,
UDP, and SMTP checks. HTTP and HTTPS checks should only define the port when
using a non-standard port (HTTP: default 80, HTTPS: default 443).'
default: 0
components-schemas-precedence:
type: number
description: The precedence of the policy. Lower values indicate higher precedence.
Policies will be evaluated in ascending order of this field.
example: 100
components-schemas-priority:
type: number
description: Priority of the routing rule.
default: 0
minimum: 0
components-schemas-query:
allOf:
- $ref: '#/components/schemas/query'
- properties:
dimensions:
example:
- namespaceId
items:
enum:
- namespaceId
filters:
example: namespaceId==a4e8cbb7-1b58-4990-925e-e026d40c4c64
metrics:
default: '["storedBytes"]'
example:
- storedBytes
- storedKeys
items:
enum:
- storedBytes
- storedKeys
sort:
example:
- +storedBytes
- -namespaceId
components-schemas-ratelimit:
properties:
action:
$ref: '#/components/schemas/components-schemas-action'
bypass:
$ref: '#/components/schemas/bypass'
description:
$ref: '#/components/schemas/components-schemas-description'
disabled:
$ref: '#/components/schemas/disabled'
id:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
match:
$ref: '#/components/schemas/match'
period:
$ref: '#/components/schemas/period'
threshold:
$ref: '#/components/schemas/threshold'
components-schemas-ref:
type: string
description: The reference of the rule (the rule ID by default).
example: my_ref
components-schemas-response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/ip-list'
components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/zone_components-schemas-zone'
components-schemas-response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
components-schemas-result:
allOf:
- $ref: '#/components/schemas/schemas-result'
- properties:
data:
example:
- metrics:
- - 2
- 4
- - 16
- 32
max:
example:
readKiB: 32
requests: 4
min:
example:
readKiB: 16
requests: 2
query:
$ref: '#/components/schemas/schemas-query'
totals:
example:
readKiB: 48
requests: 6
components-schemas-rule:
oneOf:
- $ref: '#/components/schemas/anomaly_rule'
- $ref: '#/components/schemas/traditional_deny_rule'
- $ref: '#/components/schemas/traditional_allow_rule'
type: object
components-schemas-rules:
type: array
description: The list of rules in the ruleset.
items:
$ref: '#/components/schemas/rules_components-schemas-rule'
components-schemas-ruleset:
properties:
description:
example: ""
id:
example: 2f2feab2026849078ba485f918791bdc
kind:
example: zone
name:
example: default
phase:
example: http_custom_errors
rules:
type: array
description: The rules in the ruleset.
items:
$ref: '#/components/schemas/custom-error-responses_components-schemas-rule'
components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/tsig'
components-schemas-state:
description: The custom page state.
enum:
- default
- customized
example: default
components-schemas-status:
type: string
description: Whether the user is a member of the organization or has an inivitation
pending.
enum:
- member
- invited
example: member
components-schemas-target:
type: string
description: Target gateway of the hostname.
enum:
- ethereum
- ipfs
- ipfs_universal_path
- polygon
example: ipfs
components-schemas-ttl:
type: integer
description: Time To Live (TTL) in number of hops of the GRE tunnel.
default: 64
components-schemas-tunnel_modified_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_interconnect:
type: object
components-schemas-tunnel_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
interconnect:
type: object
components-schemas-tunnel_update_request:
type: object
properties:
description:
$ref: '#/components/schemas/interconnect_components-schemas-description'
gre:
$ref: '#/components/schemas/gre'
interface_address:
$ref: '#/components/schemas/interface_address'
mtu:
$ref: '#/components/schemas/schemas-mtu'
components-schemas-tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
interconnects:
type: array
items:
$ref: '#/components/schemas/interconnect'
components-schemas-type:
type: string
description: A full zone implies that DNS is hosted with Cloudflare. A partial
zone is typically a partner-hosted zone or a CNAME setup.
enum:
- full
- partial
example: full
components-schemas-updated_at:
type: string
format: date-time
description: Last updated.
example: "2018-08-28T17:26:26Z"
components-schemas-uploaded_on:
type: string
format: date-time
description: The time when the certificate was uploaded.
example: "2019-10-28T18:11:23.37411Z"
components-schemas-url:
type: string
format: uri
description: URL(s) to filter submissions results by
example: https://www.cloudflare.com
components-schemas-uuid:
type: string
description: The policy ID.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
components-schemas-validation_method:
type: object
required:
- validation_method
properties:
validation_method:
$ref: '#/components/schemas/validation_method_definition'
components-schemas-value:
type: string
enum:
- flexible
- full
- strict
example: strict
components-schemas-version:
type: object
description: The version of the analyzed script.
properties:
fetched_at:
$ref: '#/components/schemas/fetched_at'
hash:
$ref: '#/components/schemas/hash'
js_integrity_score:
$ref: '#/components/schemas/js_integrity_score'
components-schemas-zone:
type: object
required:
- id
- name
- development_mode
- owner
- account
- meta
- original_name_servers
- original_registrar
- original_dnshost
- created_on
- modified_on
- activated_on
properties:
activated_on:
type: string
format: date-time
description: |-
The last time proof of ownership was detected and the zone was made
active
example: "2014-01-02T00:01:00.12345Z"
nullable: true
readOnly: true
created_on:
type: string
format: date-time
description: When the zone was created
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
development_mode:
type: number
description: |-
The interval (in seconds) from when development mode expires
(positive integer) or last expired (negative integer) for the
domain. If development mode has never been enabled, this value is 0.
example: 7200
readOnly: true
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
modified_on:
type: string
format: date-time
description: When the zone was last modified
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
name:
type: string
description: The domain name
example: example.com
readOnly: true
maxLength: 253
pattern: ^([a-zA-Z0-9][\-a-zA-Z0-9]*\.)+[\-a-zA-Z0-9]{2,20}$
original_dnshost:
type: string
description: DNS host at the time of switching to Cloudflare
example: NameCheap
nullable: true
readOnly: true
maxLength: 50
original_name_servers:
type: array
description: |-
Original name servers before moving to Cloudflare
Notes: Is this only available for full zones?
example:
- ns1.originaldnshost.com
- ns2.originaldnshost.com
nullable: true
readOnly: true
items:
type: string
format: hostname
original_registrar:
type: string
description: Registrar for the domain at the time of switching to Cloudflare
example: GoDaddy
nullable: true
readOnly: true
condition:
type: object
properties:
request.ip:
$ref: '#/components/schemas/request.ip'
config:
type: array
items:
$ref: '#/components/schemas/hostname_certid_input'
config_components-schemas-account_identifier:
example: 6f91088a406011ed95aed352566e8d4c
config_request:
oneOf:
- $ref: '#/components/schemas/workspace_one_config_request'
- $ref: '#/components/schemas/crowdstrike_config_request'
- $ref: '#/components/schemas/uptycs_config_request'
- $ref: '#/components/schemas/intune_config_request'
type: object
description: The configuration object containing third party integration information.
example:
api_url: https://as123.awmdm.com/API
auth_url: https://na.uemauth.vmwservices.com/connect/token
client_id: example client id
client_secret: example client secret
config_response:
oneOf:
- $ref: '#/components/schemas/workspace_one_config_response'
type: object
description: The configuration object containing third party integration information.
example:
api_url: https://as123.awmdm.com/API
auth_url: https://na.uemauth.vmwservices.com/connect/token
client_id: example client id
config_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
config_src:
type: string
description: Indicates if this is a locally or remotely configured tunnel. If
`local`, manage the tunnel using a YAML file on the origin machine. If `cloudflare`,
manage the tunnel on the Zero Trust dashboard or using the [Cloudflare Tunnel
configuration](https://api.cloudflare.com/#cloudflare-tunnel-configuration-properties)
endpoint.
enum:
- local
- cloudflare
default: local
example: cloudflare
config_version:
type: integer
description: The version of the remote tunnel configuration. Used internally
to sync cloudflared with the Zero Trust dashboard.
configuration:
type: object
properties:
auth_id_characteristics:
$ref: '#/components/schemas/characteristics'
configurations:
anyOf:
- $ref: '#/components/schemas/schemas-ip_configuration'
- $ref: '#/components/schemas/schemas-cidr_configuration'
type: array
description: A list of IP addresses or CIDR ranges that will be allowed to access
the URLs specified in the Zone Lockdown rule. You can include any number of
`ip` or `ip_range` configurations.
items:
anyOf:
- $ref: '#/components/schemas/schemas-ip_configuration'
- $ref: '#/components/schemas/schemas-cidr_configuration'
connect_components-schemas-created:
type: string
format: date-time
description: The date and time the live input was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
connected:
type: boolean
description: A flag indicating whether the given zone is connected to the Railgun.
default: false
example: true
connection:
properties:
added_at:
example: "2021-08-18T10:51:10.09615Z"
domain_reported_malicious:
example: false
first_page_url:
example: blog.cloudflare.com/page
first_seen_at:
example: "2021-08-18T10:51:08Z"
host:
example: blog.cloudflare.com
id:
example: c9ef84a6bf5e47138c75d95e2f933e8f
last_seen_at:
example: "2021-09-02T09:57:54Z"
page_urls:
example:
- blog.cloudflare.com/page1
- blog.cloudflare.com/page2
url:
example: https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.6.0/js/bootstrap.min.js
url_contains_cdn_cgi_path:
example: false
connection_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-connection'
connection_components-schemas-created_on:
type: string
format: date-time
description: When the connection was created.
example: "2017-06-14T00:00:00Z"
readOnly: true
connection_components-schemas-enabled:
type: boolean
description: A value indicating whether the connection is enabled or not.
default: false
example: true
connection_components-schemas-identifier:
type: string
description: Connection identifier tag.
example: c4a7362d577a6c3019a474fd6f485821
readOnly: true
maxLength: 32
connection_components-schemas-modified_on:
type: string
format: date-time
description: When the connection was last modified.
example: "2017-06-14T05:20:00Z"
readOnly: true
connection_components-schemas-zone:
type: object
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
$ref: '#/components/schemas/properties-name'
connection_id:
type: string
description: UUID of the Cloudflare Tunnel connection.
example: 1bedc50d-42b3-473c-b108-ff3d10c0d925
readOnly: true
maxLength: 36
connection_single_id_response:
allOf:
- $ref: '#/components/schemas/connection_single_response'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/connection_components-schemas-identifier'
connection_single_request:
type: object
required:
- zone
properties:
enabled:
$ref: '#/components/schemas/connection_components-schemas-enabled'
zone:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
connection_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
connections:
type: array
description: The Cloudflare Tunnel connections between your origin and Cloudflare's
edge.
items:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-connection'
conns_active_at:
type: string
format: date-time
description: Timestamp of when the tunnel established at least one connection
to Cloudflare's edge. If `null`, the tunnel is inactive.
example: "2009-11-10T23:00:00Z"
nullable: true
conns_inactive_at:
type: string
format: date-time
description: Timestamp of when the tunnel became inactive (no connections to
Cloudflare's edge). If `null`, the tunnel is active.
example: "2009-11-10T23:00:00Z"
nullable: true
consecutive_down:
type: integer
description: To be marked unhealthy the monitored origin must fail this healthcheck
N consecutive times.
default: 0
consecutive_fails:
type: integer
description: The number of consecutive fails required from a health check before
changing the health to unhealthy.
default: 1
consecutive_successes:
type: integer
description: The number of consecutive successes required from a health check
before changing the health to healthy.
default: 1
consecutive_up:
type: integer
description: To be marked healthy the monitored origin must pass this healthcheck
N consecutive times.
default: 0
consumer:
type: object
properties:
created_on:
readOnly: true
environment:
readOnly: true
queue_name:
readOnly: true
service:
readOnly: true
settings:
type: object
properties:
batch_size:
$ref: '#/components/schemas/batch_size'
max_retries:
$ref: '#/components/schemas/max_retries'
max_wait_time_ms:
$ref: '#/components/schemas/max_wait_time_ms'
consumer_created:
type: object
properties:
created_on:
readOnly: true
dead_letter_queue:
$ref: '#/components/schemas/dlq_name'
environment:
readOnly: true
queue_name:
readOnly: true
script_name:
readOnly: true
settings:
type: object
properties:
batch_size:
$ref: '#/components/schemas/batch_size'
max_retries:
$ref: '#/components/schemas/max_retries'
max_wait_time_ms:
$ref: '#/components/schemas/max_wait_time_ms'
consumer_name:
type: string
example: example-consumer
consumer_updated:
type: object
properties:
created_on:
readOnly: true
dead_letter_queue:
example: updated-example-dlq
environment:
readOnly: true
queue_name:
readOnly: true
script_name:
readOnly: true
settings:
type: object
properties:
batch_size:
type: number
example: 100
max_retries:
$ref: '#/components/schemas/max_retries'
max_wait_time_ms:
$ref: '#/components/schemas/max_wait_time_ms'
contact_identifier:
type: string
description: Contact Identifier.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
contact_properties:
type: object
required:
- first_name
- last_name
- address
- city
- state
- zip
- country
- phone
- organization
properties:
address:
$ref: '#/components/schemas/components-schemas-address'
address2:
$ref: '#/components/schemas/address2'
city:
$ref: '#/components/schemas/city'
country:
$ref: '#/components/schemas/country'
email:
$ref: '#/components/schemas/email'
fax:
$ref: '#/components/schemas/fax'
first_name:
$ref: '#/components/schemas/first_name'
id:
$ref: '#/components/schemas/contact_identifier'
last_name:
$ref: '#/components/schemas/last_name'
organization:
$ref: '#/components/schemas/schemas-organization'
phone:
$ref: '#/components/schemas/telephone'
state:
$ref: '#/components/schemas/contacts_components-schemas-state'
zip:
$ref: '#/components/schemas/zipcode'
contacts:
allOf:
- $ref: '#/components/schemas/contact_properties'
type: object
contacts_components-schemas-state:
type: string
description: State.
example: TX
content:
type: string
description: DNS record content.
example: 127.0.0.1
content_categories:
description: Current content categories.
example:
- id: 155
name: Technology
super_category_id: 26
content_list_action:
type: string
description: Behavior of the content list.
enum:
- block
example: block
content_list_details:
type: object
properties:
action:
$ref: '#/components/schemas/content_list_action'
content_list_details_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/content_list_details'
content_list_entries:
type: array
description: Content list entries.
items:
$ref: '#/components/schemas/content_list_entry'
content_list_entry:
type: object
description: Content list entry to be blocked.
properties:
content:
$ref: '#/components/schemas/content_list_entry_content'
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/content_list_entry_description'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/timestamp'
type:
$ref: '#/components/schemas/content_list_entry_type'
content_list_entry_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: object
properties:
entries:
$ref: '#/components/schemas/content_list_entries'
content_list_entry_content:
type: string
description: CID or content path of content to block.
example: QmPZ9gcCEpqKTo6aq61g2nXGUhM4iCL3ewB6LDXZCtioEB
maxLength: 500
content_list_entry_create_request:
type: object
required:
- type
- content
properties:
content:
$ref: '#/components/schemas/content_list_entry_content'
description:
$ref: '#/components/schemas/content_list_entry_description'
type:
$ref: '#/components/schemas/content_list_entry_type'
content_list_entry_description:
type: string
description: An optional description of the content list entry.
example: this is my content list entry
maxLength: 500
content_list_entry_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/content_list_entry'
content_list_entry_type:
type: string
description: Type of content list entry to block.
enum:
- cid
- content_path
example: cid
content_list_update_request:
type: object
required:
- action
- entries
properties:
action:
$ref: '#/components/schemas/content_list_action'
entries:
$ref: '#/components/schemas/content_list_entries'
content_type:
type: string
description: 'The content type of the body. Must be one of the following: `text/plain`,
`text/xml`, or `application/json`.'
example: text/xml
maxLength: 50
cookie_attributes:
type: object
description: Configures cookie attributes for the waiting room cookie. This
encrypted cookie stores a user's status in the waiting room, such as queue
position.
properties:
samesite:
type: string
description: Configures the SameSite attribute on the waiting room cookie.
Value `auto` will be translated to `lax` or `none` depending if **Always
Use HTTPS** is enabled. Note that when using value `none`, the secure
attribute cannot be set to `never`.
enum:
- auto
- lax
- none
- strict
default: auto
example: auto
secure:
type: string
description: Configures the Secure attribute on the waiting room cookie.
Value `always` indicates that the Secure attribute will be set in the
Set-Cookie header, `never` indicates that the Secure attribute will not
be set, and `auto` will set the Secure attribute depending if **Always
Use HTTPS** is enabled.
enum:
- auto
- always
- never
default: auto
example: auto
cors_headers:
type: object
properties:
allow_all_headers:
$ref: '#/components/schemas/allow_all_headers'
allow_all_methods:
$ref: '#/components/schemas/allow_all_methods'
allow_all_origins:
$ref: '#/components/schemas/allow_all_origins'
allow_credentials:
$ref: '#/components/schemas/allow_credentials'
allowed_headers:
$ref: '#/components/schemas/allowed_headers'
allowed_methods:
$ref: '#/components/schemas/allowed_methods'
allowed_origins:
$ref: '#/components/schemas/allowed_origins'
max_age:
$ref: '#/components/schemas/max_age'
count:
type: number
description: The number of items in the List.
example: 20
readOnly: true
country:
type: string
description: The country in which the user lives.
example: US
nullable: true
maxLength: 30
country_configuration:
title: A country configuration.
properties:
target:
description: The configuration target. You must set the target to `country`
when specifying a country code in the rule.
enum:
- country
example: country
value:
type: string
description: 'The two-letter ISO-3166-1 alpha-2 code to match. For more
information, refer to [IP Access rules: Parameters](https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country).'
example: US
country_pools:
type: object
description: A mapping of country codes to a list of pool IDs (ordered by their
failover priority) for the given country. Any country not explicitly defined
will fall back to using the corresponding region_pool mapping if it exists
else to default_pools.
example:
GB:
- abd90f38ced07c2e2f4df50b1f61d4194
US:
- de90f38ced07c2e2f4df50b1f61d4194
- 00920f38ce07c2e2f4df50b1f61d4194
create:
type: object
required:
- email
- roles
properties:
email:
$ref: '#/components/schemas/email'
roles:
type: array
description: Array of roles associated with this member.
items:
$ref: '#/components/schemas/role_components-schemas-identifier'
status:
enum:
- accepted
- pending
default: pending
create_custom_profile_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/custom_profile'
create_custom_profiles:
required:
- profiles
properties:
profiles:
type: array
items:
$ref: '#/components/schemas/new_custom_profile'
required:
- name
- entries
create_destination_address_properties:
type: object
required:
- email
properties:
email:
$ref: '#/components/schemas/email'
create_input_request:
properties:
defaultCreator:
$ref: '#/components/schemas/live_input_default_creator'
meta:
$ref: '#/components/schemas/live_input_metadata'
recording:
$ref: '#/components/schemas/live_input_recording_settings'
create_output_request:
required:
- url
- streamKey
properties:
enabled:
$ref: '#/components/schemas/output_enabled'
streamKey:
$ref: '#/components/schemas/output_streamKey'
url:
$ref: '#/components/schemas/output_url'
create_payload:
type: object
required:
- name
- policies
properties:
condition:
$ref: '#/components/schemas/condition'
expires_on:
$ref: '#/components/schemas/expires_on'
name:
$ref: '#/components/schemas/name'
not_before:
$ref: '#/components/schemas/not_before'
policies:
$ref: '#/components/schemas/policies'
create_rename_namespace_body:
type: object
required:
- title
properties:
title:
$ref: '#/components/schemas/namespace_title'
create_request:
type: object
required:
- name
- target
properties:
description:
$ref: '#/components/schemas/web3-hostname_components-schemas-description'
dnslink:
$ref: '#/components/schemas/dnslink'
name:
$ref: '#/components/schemas/web3-hostname_components-schemas-name'
target:
$ref: '#/components/schemas/components-schemas-target'
create_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
client_id:
$ref: '#/components/schemas/client_id'
client_secret:
$ref: '#/components/schemas/client_secret'
created_at:
$ref: '#/components/schemas/timestamp'
id:
description: The ID of the service token.
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
updated_at:
$ref: '#/components/schemas/timestamp'
create_rule:
required:
- action
- expression
properties:
action:
$ref: '#/components/schemas/rule_action'
description:
$ref: '#/components/schemas/rule_description'
enabled:
$ref: '#/components/schemas/rule_enabled'
expression:
$ref: '#/components/schemas/rule_expression'
create_rule_properties:
type: object
required:
- actions
- matchers
properties:
actions:
$ref: '#/components/schemas/actions'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled'
matchers:
$ref: '#/components/schemas/matchers'
name:
$ref: '#/components/schemas/rules_components-schemas-name'
priority:
$ref: '#/components/schemas/components-schemas-priority'
create_ruleset:
type: object
description: A ruleset object.
required:
- name
- kind
- phase
- rules
properties:
description:
$ref: '#/components/schemas/rulesets_components-schemas-description'
kind:
$ref: '#/components/schemas/schemas-kind'
name:
$ref: '#/components/schemas/rulesets_components-schemas-name'
phase:
$ref: '#/components/schemas/phase'
rules:
$ref: '#/components/schemas/create_update_rules'
create_update_rule:
type: object
description: A rule object.
required:
- expression
- action
properties:
action:
$ref: '#/components/schemas/rules_components-schemas-action'
action_parameters:
$ref: '#/components/schemas/action_parameters'
description:
$ref: '#/components/schemas/rules_components-schemas-description'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled-2'
expression:
$ref: '#/components/schemas/schemas-expression'
logging:
$ref: '#/components/schemas/logging'
ref:
$ref: '#/components/schemas/components-schemas-ref'
create_update_rules:
type: array
description: The list of rules in the ruleset.
items:
anyOf:
- $ref: '#/components/schemas/create_update_rule'
- description: The unique ID of a rule.
created:
type: string
format: date-time
description: The date and time the destination address has been created.
example: "2014-01-02T02:20:00Z"
readOnly: true
created-on:
type: string
format: date-time
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
created_at:
type: string
format: date-time
description: This is the time the hostname was created.
example: "2020-02-06T18:11:23.531995Z"
created_on:
type: string
format: date-time
description: The timestamp of when the Page Rule was created.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
creator:
type: string
description: A user-defined identifier for the media creator.
example: creator-id_abcde12345
maxLength: 64
cron-trigger-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
properties:
schedules:
type: array
items:
properties:
created_on:
readOnly: true
cron:
readOnly: true
modified_on:
readOnly: true
crowdstrike_config_request:
type: object
required:
- api_url
- customer_id
- client_id
- client_secret
properties:
api_url:
type: string
description: The Crowdstrike API URL.
example: https://api.us-2.crowdstrike.com
client_id:
type: string
description: The Crowdstrike client ID.
example: example client id
client_secret:
type: string
description: The Crowdstrike client secret.
example: example client secret
customer_id:
type: string
description: The Crowdstrike customer ID.
example: example customer id
csr:
type: string
description: The Certificate Signing Request (CSR). Must be newline-encoded.
example: |-
-----BEGIN CERTIFICATE REQUEST-----
MIICxzCCAa8CAQAwSDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDVNhbiBGcmFuY2lz
Y28xCzAJBgNVBAcTAkNBMRQwEgYDVQQDEwtleGFtcGxlLm5ldDCCASIwDQYJKoZI
hvcNAQEBBQADggEPADCCAQoCggEBALxejtu4b+jPdFeFi6OUsye8TYJQBm3WfCvL
Hu5EvijMO/4Z2TImwASbwUF7Ir8OLgH+mGlQZeqyNvGoSOMEaZVXcYfpR1hlVak8
4GGVr+04IGfOCqaBokaBFIwzclGZbzKmLGwIQioNxGfqFm6RGYGA3be2Je2iseBc
N8GV1wYmvYE0RR+yWweJCTJ157exyRzu7sVxaEW9F87zBQLyOnwXc64rflXslRqi
g7F7w5IaQYOl8yvmk/jEPCAha7fkiUfEpj4N12+oPRiMvleJF98chxjD4MH39c5I
uOslULhrWunfh7GB1jwWNA9y44H0snrf+xvoy2TcHmxvma9Eln8CAwEAAaA6MDgG
CSqGSIb3DQEJDjErMCkwJwYDVR0RBCAwHoILZXhhbXBsZS5uZXSCD3d3dy5leGFt
cGxlLm5ldDANBgkqhkiG9w0BAQsFAAOCAQEAcBaX6dOnI8ncARrI9ZSF2AJX+8mx
pTHY2+Y2C0VvrVDGMtbBRH8R9yMbqWtlxeeNGf//LeMkSKSFa4kbpdx226lfui8/
auRDBTJGx2R1ccUxmLZXx4my0W5iIMxunu+kez+BDlu7bTT2io0uXMRHue4i6quH
yc5ibxvbJMjR7dqbcanVE10/34oprzXQsJ/VmSuZNXtjbtSKDlmcpw6To/eeAJ+J
hXykcUihvHyG4A1m2R6qpANBjnA0pHexfwM/SgfzvpbvUg0T1ubmer8BgTwCKIWs
dcWYTthM51JIqRBfNqy4QcBnX+GY05yltEEswQI55wdiS3CjTTA67sdbcQ==
-----END CERTIFICATE REQUEST-----
currency:
type: string
description: The monetary unit in which pricing information is displayed.
example: USD
readOnly: true
current:
type: number
description: Cloudflare Images current usage.
example: 1000
readOnly: true
current_period_end:
type: string
format: date-time
description: The end of the current period and also when the next billing is
due.
example: "2014-03-31T12:20:00Z"
readOnly: true
current_period_start:
type: string
format: date-time
description: When the current billing period started. May match initial_period_start
if this is the first period.
example: "2014-05-11T12:20:00Z"
readOnly: true
current_registrar:
type: string
description: Shows name of current registrar.
example: Cloudflare
cursor:
type: string
description: Opaque token indicating the position from which to continue when
requesting the next set of records if the amount of list results was limited
by the limit parameter. A valid value for the cursor can be obtained from
the cursors object in the result_info structure.
example: 6Ck1la0VxJ0djhidm1MdX2FyDGxLKVeeHZZmORS_8XeSuhz9SjIJRaSa2lnsF01tQOHrfTGAP3R5X1Kv5iVUuMbNKhWNAXHOl6ePB0TUL8nw
custom-certificate:
type: object
required:
- id
- hosts
- issuer
- signature
- status
- bundle_method
- zone_id
- uploaded_on
- modified_on
- expires_on
- priority
properties:
bundle_method:
$ref: '#/components/schemas/bundle_method'
expires_on:
$ref: '#/components/schemas/components-schemas-expires_on'
geo_restrictions:
$ref: '#/components/schemas/geo_restrictions'
hosts:
$ref: '#/components/schemas/hosts'
id:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
issuer:
$ref: '#/components/schemas/issuer'
keyless_server:
$ref: '#/components/schemas/keyless-certificate'
modified_on:
$ref: '#/components/schemas/components-schemas-modified_on'
policy:
$ref: '#/components/schemas/policy'
priority:
$ref: '#/components/schemas/schemas-priority'
signature:
$ref: '#/components/schemas/signature'
status:
$ref: '#/components/schemas/custom-certificate_components-schemas-status'
uploaded_on:
$ref: '#/components/schemas/uploaded_on'
zone_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
custom-certificate_components-schemas-identifier:
type: string
description: Custom certificate identifier tag.
example: 2458ce5a-0c35-4c7f-82c7-8e9487d3ff60
readOnly: true
maxLength: 36
custom-certificate_components-schemas-status:
description: Status of the zone's custom SSL.
enum:
- active
- expired
- deleted
- pending
- initializing
example: active
readOnly: true
custom-certificate_components-schemas-type:
type: string
description: The type 'legacy_custom' enables support for legacy clients which
do not include SNI in the TLS handshake.
enum:
- legacy_custom
- sni_custom
default: legacy_custom
example: sni_custom
custom-error-responses_components-schemas-rule:
properties:
action:
example: serve_error
action_parameters:
$ref: '#/components/schemas/action_parameters_serve_error'
description:
example: Change error response based on geolocation
expression:
example: ip.geoip.country eq "AL"
id:
example: 3a03d665bac047339bb530ecb439a90d
version:
example: "1"
custom-hostname:
allOf:
- $ref: '#/components/schemas/customhostname'
type: object
required:
- id
- hostname
- ssl
properties:
hostname:
$ref: '#/components/schemas/hostname'
id:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
ssl:
$ref: '#/components/schemas/schemas-ssl'
custom-hostname_components-schemas-identifier:
type: string
description: Custom hostname identifier tag.
example: 0d89c70d-ad9f-4843-b99f-6cc0252067e9
readOnly: true
minLength: 36
maxLength: 36
custom-hostname_components-schemas-status:
description: Status of the hostname's activation.
enum:
- active
- pending
- active_redeploying
- moved
- pending_deletion
- deleted
- pending_blocked
- pending_migration
- pending_provisioned
- test_pending
- test_active
- test_active_apex
- test_blocked
- test_failed
- provisioned
- blocked
example: pending
custom-ns_components-schemas-identifier:
type: string
description: Account identifier tag.
example: 372e67954025e0ba6aaa6d586b9e0b59
readOnly: true
maxLength: 32
custom-pages_components-schemas-identifier:
description: The name of the custom page type.
enum:
- basic_challenge
- managed_challenge
- waf_block
- ratelimit_block
- country_challenge
- ip_block
- under_attack
- 500_errors
- 1000_errors
example: basic_challenge
readOnly: true
custom-pages_components-schemas-identifier-2:
description: The name of the custom page type.
enum:
- basic_challenge
- managed_challenge
- waf_block
- country_challenge
- ip_block
- under_attack
- ratelimit_block
- 500_errors
- 1000_errors
example: basic_challenge
readOnly: true
custom_deny_message:
type: string
description: The custom error message shown to a user when they are denied access
to the application.
custom_deny_url:
type: string
description: The custom URL a user is redirected to when they are denied access
to the application.
custom_entry:
type: object
title: Custom entry
description: A custom entry that matches a profile
properties:
created_at:
$ref: '#/components/schemas/timestamp'
enabled:
type: boolean
description: Whether the entry is enabled or not.
example: true
id:
$ref: '#/components/schemas/entry_id'
name:
type: string
description: The name of the entry.
example: Credit card (Visa)
pattern:
$ref: '#/components/schemas/components-schemas-pattern'
profile_id:
description: ID of the parent profile
updated_at:
$ref: '#/components/schemas/timestamp'
custom_hostname_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/custom-hostname'
custom_hostname_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
custom_metadata:
anyOf:
- type: object
properties:
key:
type: string
description: Unique metadata for this hostname.
example: value
type: object
description: These are per-hostname (customer) settings.
custom_origin_server:
type: string
description: a valid hostname that’s been added to your DNS zone as an A, AAAA,
or CNAME record.
example: origin2.example.com
custom_origin_sni:
type: string
description: A hostname that will be sent to your custom origin server as SNI
for TLS handshake. This can be a valid subdomain of the zone or custom origin
server name or the string ':request_host_header:' which will cause the host
header in the request to be used as SNI. Not configurable with default/fallback
origin server.
example: sni.example.com
custom_page_html:
type: string
description: "Only available for the Waiting Room Advanced subscription. This
is a template html file that will be rendered at the edge. If no custom_page_html
is provided, the default waiting room will be used. The template is based
on mustache ( https://mustache.github.io/ ). There are several variables that
are evaluated by the Cloudflare edge:\n1. {{`waitTimeKnown`}} Acts like a
boolean value that indicates the behavior to take when wait time is not available,
for instance when queue_all is **true**. \n2. {{`waitTimeFormatted`}} Estimated
wait time for the user. For example, five minutes. Alternatively, you can
use: \n3. {{`waitTime`}} Number of minutes of estimated wait for a user.\n4.
{{`waitTimeHours`}} Number of hours of estimated wait for a user (`Math.floor(waitTime/60)`).
\n5. {{`waitTimeHourMinutes`}} Number of minutes above the `waitTimeHours`
value (`waitTime%60`). \n6. {{`queueIsFull`}} Changes to **true** when no
more people can be added to the queue.\n\nTo view the full list of variables,
look at the `cfWaitingRoom` object described under the `json_response_enabled`
property in other Waiting Room API calls."
default: ""
example: '{{#waitTimeKnown}} {{waitTime}} mins {{/waitTimeKnown}} {{^waitTimeKnown}}
Queue all enabled {{/waitTimeKnown}}'
custom_pages_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
custom_pages_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
custom_profile:
type: object
title: Custom profile
properties:
created_at:
$ref: '#/components/schemas/timestamp'
description:
type: string
description: The description of the profile.
example: A standard CVV card number
entries:
type: array
description: The entries for this profile.
items:
$ref: '#/components/schemas/custom_entry'
id:
$ref: '#/components/schemas/profile_id'
name:
type: string
description: The name of the profile.
example: Generic CVV Card Number
type:
type: string
description: The type of the profile.
enum:
- custom
example: custom
updated_at:
$ref: '#/components/schemas/timestamp'
custom_profile_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
allOf:
- $ref: '#/components/schemas/custom_profile'
custom_response:
anyOf:
- type: object
properties:
body:
$ref: '#/components/schemas/body'
content_type:
$ref: '#/components/schemas/content_type'
type: object
description: |-
A custom content type and reponse to return when the threshold is exceeded. The custom response configured in this object will override the custom error for the zone. This object is optional.
Notes: If you omit this object, Cloudflare will use the default HTML error page. If "mode" is "challenge", "managed_challenge", or "js_challenge", Cloudflare will use the zone challenge pages and you should not provide the "response" object.
customer_gre_endpoint:
type: string
description: The IP address assigned to the customer side of the GRE tunnel.
example: 203.0.113.1
customer_ipsec_endpoint:
type: string
description: The IP address assigned to the customer side of the IPsec tunnel.
example: 203.0.113.1
customhostname:
properties:
created_at:
$ref: '#/components/schemas/created_at'
custom_metadata:
$ref: '#/components/schemas/custom_metadata'
custom_origin_server:
$ref: '#/components/schemas/custom_origin_server'
custom_origin_sni:
$ref: '#/components/schemas/custom_origin_sni'
hostname:
$ref: '#/components/schemas/hostname'
id:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
ownership_verification:
$ref: '#/components/schemas/ownership_verification'
ownership_verification_http:
$ref: '#/components/schemas/ownership_verification_http'
ssl:
$ref: '#/components/schemas/schemas-ssl'
status:
$ref: '#/components/schemas/custom-hostname_components-schemas-status'
verification_errors:
$ref: '#/components/schemas/verification_errors'
dashboard:
type: object
title: Dashboard response
description: Totals and timeseries data.
properties:
timeseries:
$ref: '#/components/schemas/timeseries'
totals:
$ref: '#/components/schemas/totals'
dashboard_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
query:
$ref: '#/components/schemas/query_response'
result:
$ref: '#/components/schemas/dashboard'
data_points:
type: integer
description: The number of data points used for the threshold suggestion calculation.
readOnly: true
datacenters:
type: array
title: Analytics data by datacenter
description: A breakdown of all dashboard analytics data by co-locations. This
is limited to Enterprise zones only.
items:
type: object
properties:
colo_id:
type: string
description: The airport code identifer for the co-location.
example: SFO
timeseries:
$ref: '#/components/schemas/timeseries_by_colo'
totals:
$ref: '#/components/schemas/totals_by_colo'
dataset:
type: string
description: Dataset to be pulled.
example: http_requests
nullable: true
maxLength: 256
pattern: ^[a-zA-Z0-9_\-]*$
days_until_next_rotation:
type: number
description: The number of days until the next key rotation.
example: 1
readOnly: true
decision:
type: string
description: The action Access will take if a user matches this policy.
enum:
- allow
- deny
- non_identity
- bypass
example: allow
default:
type: number
description: The default amount allocated.
example: 5
default_device_settings_policy:
type: object
properties:
allow_mode_switch:
$ref: '#/components/schemas/allow_mode_switch'
allow_updates:
$ref: '#/components/schemas/allow_updates'
allowed_to_leave:
$ref: '#/components/schemas/allowed_to_leave'
auto_connect:
$ref: '#/components/schemas/auto_connect'
captive_portal:
$ref: '#/components/schemas/captive_portal'
default:
type: boolean
description: Whether the policy will be applied to matching devices.
example: true
disable_auto_fallback:
$ref: '#/components/schemas/disable_auto_fallback'
enabled:
type: boolean
description: Whether the policy will be applied to matching devices.
example: true
exclude:
$ref: '#/components/schemas/components-schemas-exclude'
fallback_domains:
$ref: '#/components/schemas/fallback_domains'
gateway_unique_id:
$ref: '#/components/schemas/gateway_unique_id'
include:
$ref: '#/components/schemas/schemas-include'
service_mode_v2:
$ref: '#/components/schemas/service_mode_v2'
support_url:
$ref: '#/components/schemas/support_url'
switch_locked:
$ref: '#/components/schemas/switch_locked'
default_device_settings_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/default_device_settings_policy'
default_mode:
description: The default action/mode of a rule.
enum:
- disable
- simulate
- block
- challenge
example: block
readOnly: true
default_pools:
type: array
description: A list of pool IDs ordered by their failover priority. Pools defined
here are used by default, or when region_pools are not configured for a given
region.
example:
- 17b5962d775c646f3f9725cbc7a53df4
- 9290f38c5d07c2e2f4df57b1f61d4196
- 00920f38ce07c2e2f4df50b1f61d4194
items:
type: string
description: A pool ID.
default_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
errors:
type: array
items: {}
messages:
type: array
items: {}
default_sni:
type: string
description: If you have legacy TLS clients which do not send the TLS server
name indicator, then you can specify one default SNI on the map. If Cloudflare
receives a TLS handshake from a client without an SNI, it will respond with
the default SNI on those IPs. The default SNI can be any valid zone or subdomain
owned by the account.
example: '*.example.com'
nullable: true
default_template_language:
type: string
description: The language of the default page template. If no default_template_language
is provided, then `en-US` (English) will be used.
enum:
- en-US
- es-ES
- de-DE
- fr-FR
- it-IT
- ja-JP
- ko-KR
- pt-BR
- zh-CN
- zh-TW
- nl-NL
- pl-PL
- id-ID
- tr-TR
- ar-EG
default: en-US
example: es-ES
delegated_account_identifier:
type: string
description: Account identifier for the account to which prefix is being delegated.
example: b1946ac92492d2347c6235b4d2611184
readOnly: true
maxLength: 32
delegation_identifier:
type: string
description: Delegation identifier tag.
example: d933b1530bc56c9953cf8ce166da8004
readOnly: true
maxLength: 32
delete_advanced_certificate_pack_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/certificate-packs_components-schemas-identifier'
delete_dnssec_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: string
example: ""
delete_filter_if_unused:
type: boolean
description: When true, indicates that Cloudflare should also delete the associated
filter if there are no other firewall rules referencing the filter.
deleted:
type: boolean
description: When true, indicates that the firewall rule was deleted.
example: true
deleted-filter:
required:
- id
- deleted
properties:
deleted:
$ref: '#/components/schemas/deleted'
id:
$ref: '#/components/schemas/filters_components-schemas-id'
deleted_at:
type: string
format: date-time
description: Date of deletion, if any.
nullable: true
readOnly: true
deleted_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: string
example: ""
deployment-list-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
- properties:
result:
type: array
items:
type: object
deployment-new-deployment:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
$ref: '#/components/schemas/deployments'
deployment-response-details:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
$ref: '#/components/schemas/deployments'
deployment-response-logs:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
example:
data:
- line: Cloning repository...
ts: "2021-04-20T19:35:29.0749819Z"
- line: From https://github.com/cloudflare/example
ts: "2021-04-20T19:35:30.0749819Z"
- line: ' * branch 209c5bb11d89533f426b2f8469bcae12fdccf71b
-> FETCH_HEAD'
ts: "2021-04-20T19:35:30.0749819Z"
- line: ""
ts: "2021-04-20T19:35:30.0749819Z"
- line: HEAD is now at 209c5bb Update index.html
ts: "2021-04-20T19:35:30.0749819Z"
- line: ""
ts: "2021-04-20T19:35:30.0749819Z"
- line: ""
ts: "2021-04-20T19:35:30.0749819Z"
- line: 'Success: Finished cloning repository files'
ts: "2021-04-20T19:35:30.0749819Z"
- line: Installing dependencies
ts: "2021-04-20T19:35:59.0749819Z"
- line: Python version set to 2.7
ts: "2021-04-20T19:35:59.0931208Z"
- line: v12.18.0 is already installed.
ts: "2021-04-20T19:36:02.2369501Z"
- line: Now using node v12.18.0 (npm v6.14.4)
ts: "2021-04-20T19:36:02.6028886Z"
- line: Started restoring cached build plugins
ts: "2021-04-20T19:36:02.624555Z"
- line: Finished restoring cached build plugins
ts: "2021-04-20T19:36:02.6340688Z"
- line: Attempting ruby version 2.7.1, read from environment
ts: "2021-04-20T19:36:02.963095Z"
- line: Using ruby version 2.7.1
ts: "2021-04-20T19:36:04.2236084Z"
- line: Using PHP version 5.6
ts: "2021-04-20T19:36:04.5450152Z"
- line: 5.2 is already installed.
ts: "2021-04-20T19:36:04.5740509Z"
- line: Using Swift version 5.2
ts: "2021-04-20T19:36:04.577035Z"
- line: Installing Hugo 0.54.0
ts: "2021-04-20T19:36:04.5771615Z"
- line: 'Hugo Static Site Generator v0.54.0-B1A82C61A/extended linux/amd64
BuildDate: 2019-02-01T10:04:38Z'
ts: "2021-04-20T19:36:05.4786868Z"
- line: Started restoring cached go cache
ts: "2021-04-20T19:36:05.4794366Z"
- line: Finished restoring cached go cache
ts: "2021-04-20T19:36:05.481977Z"
- line: go version go1.14.4 linux/amd64
ts: "2021-04-20T19:36:05.9049776Z"
- line: go version go1.14.4 linux/amd64
ts: "2021-04-20T19:36:05.9086053Z"
- line: Installing missing commands
ts: "2021-04-20T19:36:05.9163568Z"
- line: Verify run directory
ts: "2021-04-20T19:36:05.9163934Z"
- line: 'Executing user command: echo "skipping build step: no build
command specified"'
ts: "2021-04-20T19:36:05.9164636Z"
- line: 'skipping build step: no build command specified'
ts: "2021-04-20T19:36:05.9165087Z"
- line: Finished
ts: "2021-04-20T19:36:05.917412Z"
includes_container_logs: true
total: 30
deployment-response-stage-logs:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
example:
data:
- id: 15
message: Installing dependencies
timestamp: "2021-04-20T19:35:59.0749819Z"
- id: 16
message: Python version set to 2.7
timestamp: "2021-04-20T19:35:59.0931208Z"
- id: 17
message: v12.18.0 is already installed.
timestamp: "2021-04-20T19:36:02.2369501Z"
- id: 18
message: Now using node v12.18.0 (npm v6.14.4)
timestamp: "2021-04-20T19:36:02.6028886Z"
- id: 19
message: Started restoring cached build plugins
timestamp: "2021-04-20T19:36:02.624555Z"
- id: 20
message: Finished restoring cached build plugins
timestamp: "2021-04-20T19:36:02.6340688Z"
- id: 21
message: Attempting ruby version 2.7.1, read from environment
timestamp: "2021-04-20T19:36:02.963095Z"
- id: 22
message: Using ruby version 2.7.1
timestamp: "2021-04-20T19:36:04.2236084Z"
- id: 23
message: Using PHP version 5.6
timestamp: "2021-04-20T19:36:04.5450152Z"
- id: 24
message: 5.2 is already installed.
timestamp: "2021-04-20T19:36:04.5740509Z"
- id: 25
message: Using Swift version 5.2
timestamp: "2021-04-20T19:36:04.577035Z"
- id: 26
message: Installing Hugo 0.54.0
timestamp: "2021-04-20T19:36:04.5771615Z"
- id: 27
message: 'Hugo Static Site Generator v0.54.0-B1A82C61A/extended linux/amd64
BuildDate: 2019-02-01T10:04:38Z'
timestamp: "2021-04-20T19:36:05.4786868Z"
- id: 28
message: Started restoring cached go cache
timestamp: "2021-04-20T19:36:05.4794366Z"
- id: 29
message: Finished restoring cached go cache
timestamp: "2021-04-20T19:36:05.481977Z"
- id: 30
message: go version go1.14.4 linux/amd64
timestamp: "2021-04-20T19:36:05.9049776Z"
- id: 31
message: go version go1.14.4 linux/amd64
timestamp: "2021-04-20T19:36:05.9086053Z"
- id: 32
message: Installing missing commands
timestamp: "2021-04-20T19:36:05.9163568Z"
- id: 33
message: Verify run directory
timestamp: "2021-04-20T19:36:05.9163934Z"
- id: 34
message: 'Executing user command: echo "skipping build step: no build
command specified"'
timestamp: "2021-04-20T19:36:05.9164636Z"
- id: 35
message: 'skipping build step: no build command specified'
timestamp: "2021-04-20T19:36:05.9165087Z"
- id: 36
message: Finished
timestamp: "2021-04-20T19:36:05.917412Z"
end: 37
ended_on: "2021-04-20T19:36:06.38889Z"
name: build
start: 0
started_on: "2021-04-20T19:35:58.238757Z"
status: success
total: 37
deployment_configs:
type: object
description: Configs for deployments in a project.
properties:
preview:
anyOf:
- $ref: '#/components/schemas/deployment_configs_values'
type: object
description: Configs for preview deploys.
production:
anyOf:
- $ref: '#/components/schemas/deployment_configs_values'
type: object
description: Configs for production deploys.
deployment_configs_values:
type: object
properties:
compatibility_date:
type: string
description: Compatibility date used for Pages Functions.
example: "2022-01-01"
compatibility_flags:
type: array
description: Compatibility flags used for Pages Functions.
example:
- url_standard
d1_databases:
type: object
description: D1 databases used for Pages Functions.
nullable: true
properties:
D1_BINDING:
type: object
description: D1 binding.
example:
id: 445e2955-951a-43f8-a35b-a4d0c8138f63
properties:
id:
type: string
description: UUID of the D1 database.
example: 445e2955-951a-43f8-a35b-a4d0c8138f63
durable_object_namespaces:
type: object
description: Durabble Object namespaces used for Pages Functions.
nullable: true
properties:
DO_BINDING:
type: object
description: Durabble Object binding.
example:
namespace_id: 5eb63bbbe01eeed093cb22bb8f5acdc3
properties:
namespace_id:
type: string
description: ID of the Durabble Object namespace.
example: 5eb63bbbe01eeed093cb22bb8f5acdc3
env_vars:
type: object
description: Environment variables for build configs.
nullable: true
properties:
ENVIRONMENT_VARIABLE:
type: object
description: Environment variable.
example:
type: plain_text
value: hello world
properties:
type:
type: string
description: The type of environment variable (plain text or secret)
enum:
- plain_text
- secret_text
value:
type: string
description: Environment variable value.
kv_namespaces:
type: object
description: KV namespaces used for Pages Functions.
properties:
KV_BINDING:
type: object
description: KV binding.
example:
namespace_id: 5eb63bbbe01eeed093cb22bb8f5acdc3
properties:
namespace_id:
type: string
description: ID of the KV namespace.
example: 5eb63bbbe01eeed093cb22bb8f5acdc3
r2_buckets:
type: object
description: R2 buckets used for Pages Functions.
nullable: true
properties:
R2_BINDING:
type: object
description: R2 binding.
example:
name: some-bucket
properties:
name:
type: string
description: Name of the R2 bucket.
example: some-bucket
service_bindings:
type: object
description: Services used for Pages Functions.
nullable: true
properties:
SERVICE_BINDING:
type: object
description: Service binding.
example:
environment: production
service: example-worker
properties:
environment:
type: string
description: The Service environment.
service:
type: string
description: The Service name.
deployment_identifier:
type: string
example: bcf48806-b317-4351-9ee7-36e7d557d4de
readOnly: true
maxLength: 36
deployment_stage_name:
type: string
description: Deployment stage name.
example: deploy
pattern: queued|initialize|clone_repo|build|deploy
deployments:
type: object
properties:
aliases:
type: array
description: A list of alias URLs pointing to this deployment.
example:
- https://branchname.projectname.pages.dev
nullable: true
readOnly: true
items: {}
build_config:
readOnly: true
created_on:
type: string
format: date-time
description: When the deployment was created.
example: "2021-03-09T00:55:03.923456Z"
readOnly: true
deployment_trigger:
type: object
description: Info about what caused the deployment.
readOnly: true
properties:
metadata:
type: object
description: Additional info about the trigger.
properties:
branch:
type: string
description: Where the trigger happened.
example: main
readOnly: true
commit_hash:
type: string
description: Hash of the deployment trigger commit.
example: ad9ccd918a81025731e10e40267e11273a263421
readOnly: true
commit_message:
type: string
description: Message of the deployment trigger commit.
example: Update index.html
readOnly: true
type:
type: string
description: What caused the deployment.
example: ad_hoc
readOnly: true
pattern: push|ad_hoc
env_vars:
type: object
description: A dict of env variables to build this deploy.
example:
BUILD_VERSION:
value: "3.3"
ENV:
value: STAGING
readOnly: true
environment:
type: string
description: Type of deploy.
example: preview
readOnly: true
pattern: preview|production
id:
type: string
description: Id of the deployment.
example: f64788e9-fccd-4d4a-a28a-cb84f88f6
readOnly: true
is_skipped:
type: boolean
description: If the deployment has been skipped.
example: true
readOnly: true
latest_stage:
readOnly: true
modified_on:
type: string
format: date-time
description: When the deployment was last modified.
example: 2021-03-09T00:58:59.045655
readOnly: true
project_id:
type: string
description: Id of the project.
example: 7b162ea7-7367-4d67-bcde-1160995d5
readOnly: true
project_name:
type: string
description: Name of the project.
example: ninjakittens
readOnly: true
short_id:
type: string
description: Short Id (8 character) of the deployment.
example: f64788e9
readOnly: true
source:
readOnly: true
stages:
type: array
description: List of past stages.
example:
- ended_on: "2021-06-03T15:39:03.134378Z"
name: queued
started_on: "2021-06-03T15:38:15.608194Z"
status: active
- ended_on: null
name: initialize
started_on: null
status: idle
- ended_on: null
name: clone_repo
started_on: null
status: idle
- ended_on: null
name: build
started_on: null
status: idle
- ended_on: null
name: deploy
started_on: null
status: idle
readOnly: true
items:
$ref: '#/components/schemas/stage'
url:
type: string
description: The live URL to view this deployment.
example: https://f64788e9.ninjakittens.pages.dev
readOnly: true
deployments-list-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
items:
type: array
example:
- id: bcf48806-b317-4351-9ee7-36e7d557d4de
metadata:
author_email: user@example.com
author_id: 408cbcdfd4dda4617efef40b04d168a1
created_on: "2022-11-15T18:25:44.442097Z"
modified_on: "2022-11-15T18:25:44.442097Z"
source: api
number: 2
- id: 18f97339-c287-4872-9bdd-e2135c07ec12
metadata:
author_email: user@example.com
author_id: 408cbcdfd4dda4617efef40b04d168a1
created_on: "2022-11-08T17:30:56.968096Z"
modified_on: "2022-11-08T17:30:56.968096Z"
source: api
number: 1
items: {}
latest:
type: object
example:
id: bcf48806-b317-4351-9ee7-36e7d557d4de
metadata:
author_email: user@example.com
author_id: 408cbcdfd4dda4617efef40b04d168a1
created_on: "2022-11-15T18:25:44.442097Z"
modified_on: "2022-11-15T18:25:44.442097Z"
source: api
number: 2
resources:
bindings:
- json: example_binding
name: JSON_VAR
type: json
script:
etag: 13a3240e8fb414561b0366813b0b8f42b3e6cfa0d9e70e99835dae83d0d8a794
handlers:
- fetch
last_deployed_from: api
script_runtime:
usage_model: bundled
deployments-single-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
id:
type: string
example: 18f97339-c287-4872-9bdd-e2135c07ec12
metadata:
type: object
example:
author_email: user@example.com
author_id: 408cbcdfd4dda4617efef40b04d168a1
created_on: "2022-11-08T17:19:29.176266Z"
modified_on: "2022-11-08T17:19:29.176266Z"
source: api
number:
type: number
example: 1
resources:
type: object
example:
bindings:
- json: example_binding
name: JSON_VAR
type: json
script:
etag: 13a3240e8fb414561b0366813b0b8f42b3e6cfa0d9e70e99835dae83d0d8a794
handlers:
- fetch
last_deployed_from: api
script_runtime:
usage_model: bundled
deprecate_any_requests:
type: boolean
description: Deprecate the response to ANY requests.
example: true
description:
type: string
description: Description of role's permissions.
example: Administrative access to the entire Organization
readOnly: true
destination_address_identifier:
type: string
description: Destination address identifier.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
destination_address_properties:
type: object
properties:
created:
$ref: '#/components/schemas/created'
email:
$ref: '#/components/schemas/email'
modified:
$ref: '#/components/schemas/modified'
tag:
$ref: '#/components/schemas/destination_address_identifier'
verified:
$ref: '#/components/schemas/verified'
destination_address_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
destination_addresses_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/addresses'
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 20
total_count:
example: 1
destination_conf:
type: string
format: uri
description: Uniquely identifies a resource (such as an s3 bucket) where data
will be pushed. Additional configuration parameters supported by the destination
may be included.
example: s3://mybucket/logs?region=us-west-2
maxLength: 4096
destination_exists_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
nullable: true
properties:
exists:
type: boolean
example: false
detection_mode:
type: string
description: The mode that defines how rules within the package are evaluated
during the course of a request. When a package uses anomaly detection mode
(`anomaly` value), each rule is given a score when triggered. If the total
score of all triggered rules exceeds the sensitivity defined in the WAF package,
the action configured in the package will be performed. Traditional detection
mode (`traditional` value) will decide the action to take when it is triggered
by the request. If multiple rules are triggered, the action providing the
highest protection will be applied (for example, a 'block' action will win
over a 'challenge' action).
enum:
- anomaly
- traditional
example: traditional
readOnly: true
development_mode:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- development_mode
example: development_mode
time_remaining:
type: number
description: |-
Value of the zone setting.
Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
example: 3600
readOnly: true
value:
$ref: '#/components/schemas/development_mode_value'
title: Development Mode
description: Development Mode temporarily allows you to enter development mode
for your websites if you need to make changes to your site. This will bypass
Cloudflare's accelerated cache and slow down your site, but is useful if you
are making changes to cacheable content (like images, css, or JavaScript)
and would like to see those changes right away. Once entered, development
mode will last for 3 hours and then automatically toggle off.
development_mode_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
device-posture-integrations:
type: object
properties:
config:
$ref: '#/components/schemas/config_response'
id:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-uuid'
interval:
$ref: '#/components/schemas/schemas-interval'
name:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-name'
type:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-type'
device-posture-integrations_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
nullable: true
device-posture-integrations_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
device-posture-integrations_components-schemas-name:
type: string
description: The name of the Device Posture Integration.
example: My Workspace One Integration
device-posture-integrations_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/device-posture-integrations'
device-posture-integrations_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/device-posture-integrations'
device-posture-integrations_components-schemas-type:
type: string
description: The type of Device Posture Integration.
enum:
- workspace_one
- crowdstrike_s2s
- uptycs
- intune
example: workspace_one
device-posture-integrations_components-schemas-uuid:
type: string
description: API uuid tag.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
device-posture-rules:
type: object
properties:
description:
$ref: '#/components/schemas/device-posture-rules_components-schemas-description'
expiration:
$ref: '#/components/schemas/schemas-expiration'
id:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
input:
$ref: '#/components/schemas/schemas-input'
match:
$ref: '#/components/schemas/schemas-match'
name:
$ref: '#/components/schemas/device-posture-rules_components-schemas-name'
schedule:
$ref: '#/components/schemas/schedule'
type:
$ref: '#/components/schemas/device-posture-rules_components-schemas-type'
device-posture-rules_components-schemas-description:
type: string
description: The description of the Device Posture Rule.
example: The rule for admin serial numbers
device-posture-rules_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
device-posture-rules_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
device-posture-rules_components-schemas-name:
type: string
description: The name of the Device Posture Rule.
example: Admin Serial Numbers
device-posture-rules_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/device-posture-rules'
device-posture-rules_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/device-posture-rules'
device-posture-rules_components-schemas-type:
type: string
description: The type of Device Posture Rule.
enum:
- file
- application
- serial_number
- tanium
- gateway
- warp
example: file
device-posture-rules_components-schemas-uuid:
type: string
description: API uuid tag.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
device_posture:
type: string
description: The wirefilter expression to be used for device posture check matching.
example: any(device_posture.checks.passed[*] in {"1308749e-fcfb-4ebc-b051-fe022b632644"})
device_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
device_settings_policy:
type: object
properties:
allow_mode_switch:
$ref: '#/components/schemas/allow_mode_switch'
allow_updates:
$ref: '#/components/schemas/allow_updates'
allowed_to_leave:
$ref: '#/components/schemas/allowed_to_leave'
auto_connect:
$ref: '#/components/schemas/auto_connect'
captive_portal:
$ref: '#/components/schemas/captive_portal'
default:
$ref: '#/components/schemas/schemas-default'
disable_auto_fallback:
$ref: '#/components/schemas/disable_auto_fallback'
enabled:
type: boolean
description: Whether the policy will be applied to matching devices.
example: true
exclude:
$ref: '#/components/schemas/components-schemas-exclude'
fallback_domains:
$ref: '#/components/schemas/fallback_domains'
gateway_unique_id:
$ref: '#/components/schemas/gateway_unique_id'
include:
$ref: '#/components/schemas/schemas-include'
match:
$ref: '#/components/schemas/components-schemas-match'
name:
type: string
description: The name of the device settings policy.
example: Allow Developers
maxLength: 100
policy_id:
$ref: '#/components/schemas/uuid'
precedence:
$ref: '#/components/schemas/components-schemas-precedence'
service_mode_v2:
$ref: '#/components/schemas/service_mode_v2'
support_url:
$ref: '#/components/schemas/support_url'
switch_locked:
$ref: '#/components/schemas/switch_locked'
device_settings_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/device_settings_policy'
device_settings_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/device_settings_policy'
devices:
type: object
properties:
created:
$ref: '#/components/schemas/devices_components-schemas-created'
deleted:
$ref: '#/components/schemas/schemas-deleted'
device_type:
$ref: '#/components/schemas/platform'
id:
$ref: '#/components/schemas/devices_components-schemas-uuid'
ip:
$ref: '#/components/schemas/devices_components-schemas-ip'
key:
$ref: '#/components/schemas/schemas-key'
last_seen:
$ref: '#/components/schemas/last_seen'
mac_address:
$ref: '#/components/schemas/mac_address'
manufacturer:
$ref: '#/components/schemas/manufacturer'
model:
$ref: '#/components/schemas/model'
name:
$ref: '#/components/schemas/devices_components-schemas-name'
os_distro_name:
$ref: '#/components/schemas/os_distro_name'
os_distro_revision:
$ref: '#/components/schemas/os_distro_revision'
os_version:
$ref: '#/components/schemas/os_version'
revoked_at:
$ref: '#/components/schemas/revoked_at'
serial_number:
$ref: '#/components/schemas/schemas-serial_number'
updated:
$ref: '#/components/schemas/updated'
user:
$ref: '#/components/schemas/user'
version:
$ref: '#/components/schemas/devices_components-schemas-version'
devices_components-schemas-created:
type: string
format: date-time
description: When the device was created.
example: "2017-06-14T00:00:00Z"
devices_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
devices_components-schemas-ip:
type: string
description: IPv4 or IPv6 address.
example: 1.1.1.1
devices_components-schemas-name:
type: string
description: The device name.
example: My mobile device
devices_components-schemas-uuid:
type: string
description: Device ID.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
devices_components-schemas-version:
type: string
description: The WARP client version.
example: 1.0.0
devices_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/devices'
dimension_value:
anyOf:
- type: object
description: Dimension value, may contain dimension identifier for drill down.
required:
- name
properties:
id:
type: string
description: Dimension value identifier that can be used for drill down.
name:
type: string
description: Dimension value.
example: NODATA
- type: string
description: Dimension value.
example: NODATA
direct_upload_request:
type: object
required:
- maxDurationSeconds
properties:
allowedOrigins:
$ref: '#/components/schemas/allowedOrigins'
creator:
$ref: '#/components/schemas/creator'
expiry:
type: string
format: date-time
description: The date and time after upload when videos will not be accepted.
default: Now + 30 minutes
example: "2021-01-02T02:20:00Z"
maxDurationSeconds:
type: integer
description: Calculates the amount of time a video occupies before the video
is uploaded. Direct uploads occupy minutes of videos on your Stream account
until they are expired. After upload, the upload duration is used instead.
If a video longer than the value is uploaded, the video results in an
error.
minimum: 1
maximum: 21600
requireSignedURLs:
$ref: '#/components/schemas/requireSignedURLs'
thumbnailTimestampPct:
$ref: '#/components/schemas/thumbnailTimestampPct'
watermark:
$ref: '#/components/schemas/watermark_at_upload'
direct_upload_request_v2:
type: object
properties:
expiry:
type: string
format: date-time
description: 'The date after which the upload will not be accepted. Minimum:
Now + 2 minutes. Maximum: Now + 6 hours.'
default: Now + 30 minutes
example: "2021-01-02T02:20:00Z"
metadata:
type: object
description: User modifiable key-value store. Can be used for keeping references
to another system of record, for managing images.
requireSignedURLs:
type: boolean
description: Indicates whether the image requires a signature token to be
accessed.
default: false
example: true
direct_upload_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
uid:
$ref: '#/components/schemas/videos_components-schemas-identifier'
uploadURL:
type: string
description: The URL an unauthenticated upload can use for a single
`HTTP POST multipart/form-data` request.
example: www.example.com/samplepath
watermark:
$ref: '#/components/schemas/watermarks'
direct_upload_response_v2:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
type: string
description: Image unique identifier.
example: e22e9e6b-c02b-42fd-c405-6c32af5fe600
readOnly: true
maxLength: 32
uploadURL:
type: string
description: The URL the unauthenticated upload can be performed to
using a single HTTP POST (multipart/form-data) request.
example: https://upload.imagedelivery.net/FxUufywByo0m2v3xhKSiU8/e22e9e6b-c02b-42fd-c405-6c32af5fe600
disable_auto_fallback:
type: boolean
description: If the dns_server field of a fallback domain is not present, the
client will fall back to a best guess of the default/system DNS resolvers,
unless this policy option is set.
example: true
disable_for_time:
type: object
properties:
"1":
description: Override code that is valid for 1 hour.
example: "9106681"
"3":
description: Override code that is valid for 3 hours.
example: "5356247"
"6":
description: Override code that is valid for 6 hours.
example: "9478972"
"12":
description: Override code that is valid for 12 hour2.
example: "3424359"
"24":
description: Override code that is valid for 24 hour.2.
example: "2887634"
disable_session_renewal:
type: boolean
description: Only available for the Waiting Room Advanced subscription. Disables
automatic renewal of session cookies. If `true`, an accepted user will have
session_duration minutes to browse the site. After that, they will have to
go through the waiting room again. If `false`, a user's session cookie will
be automatically renewed on every request.
default: false
example: false
disable_transfer_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/disable_transfer_result'
disable_transfer_result:
type: string
description: The zone transfer status of a primary zone
example: Disabled
disabled:
type: boolean
description: When true, indicates that the rate limit is currently disabled.
example: false
disabled_at:
type: string
format: date-time
description: This field shows up only if the origin is disabled. This field
is set with the time the origin was disabled.
readOnly: true
display_name:
type: string
description: Alert type name.
example: Origin Error Rate Alert
dlq_name:
type: string
example: example-dlq
dns:
type: object
description: The name and type of DNS record for the Spectrum application.
properties:
name:
$ref: '#/components/schemas/dns_name'
type:
$ref: '#/components/schemas/dns_type'
dns-firewall:
type: object
required:
- id
- name
- origin_ips
- dns_firewall_ips
- minimum_cache_ttl
- maximum_cache_ttl
- deprecate_any_requests
- ecs_fallback
- modified_on
properties:
attack_mitigation:
$ref: '#/components/schemas/attack_mitigation'
deprecate_any_requests:
$ref: '#/components/schemas/deprecate_any_requests'
dns_firewall_ips:
$ref: '#/components/schemas/dns_firewall_ips'
ecs_fallback:
$ref: '#/components/schemas/ecs_fallback'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
maximum_cache_ttl:
$ref: '#/components/schemas/maximum_cache_ttl'
minimum_cache_ttl:
$ref: '#/components/schemas/minimum_cache_ttl'
modified_on:
$ref: '#/components/schemas/schemas-modified_on'
name:
$ref: '#/components/schemas/dns-firewall_components-schemas-name'
negative_cache_ttl:
$ref: '#/components/schemas/negative_cache_ttl'
origin_ips:
$ref: '#/components/schemas/origin_ips'
ratelimit:
$ref: '#/components/schemas/ratelimit'
dns-firewall_components-schemas-name:
type: string
description: DNS Firewall Cluster Name.
example: My Awesome DNS Firewall cluster
maxLength: 160
dns-record:
oneOf:
- $ref: '#/components/schemas/ARecord'
- $ref: '#/components/schemas/AAAARecord'
- $ref: '#/components/schemas/CNAMERecord'
- $ref: '#/components/schemas/HTTPSRecord'
- $ref: '#/components/schemas/NSRecord'
- $ref: '#/components/schemas/MXRecord'
- $ref: '#/components/schemas/TXTRecord'
- $ref: '#/components/schemas/LOCRecord'
- $ref: '#/components/schemas/SRVRecord'
- $ref: '#/components/schemas/CERTRecord'
- $ref: '#/components/schemas/DNSKEYRecord'
- $ref: '#/components/schemas/DSRecord'
- $ref: '#/components/schemas/NAPTRRecord'
- $ref: '#/components/schemas/SMIMEARecord'
- $ref: '#/components/schemas/SSHFPRecord'
- $ref: '#/components/schemas/SVCBRecord'
- $ref: '#/components/schemas/TLSARecord'
- $ref: '#/components/schemas/URIRecord'
type: object
required:
- id
- type
- name
- content
- proxiable
- proxied
- ttl
- locked
- zone_name
- created_on
- modified_on
dns-record_components-schemas-base:
properties:
content:
$ref: '#/components/schemas/content'
created_on:
type: string
format: date-time
description: When the record was created.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
data:
type: object
description: Metadata about the record.
example: {}
id:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
locked:
type: boolean
description: Whether this record can be modified/deleted (true means it's
managed by Cloudflare).
example: false
readOnly: true
meta:
type: object
description: Extra Cloudflare-specific information about the record.
properties:
auto_added:
type: boolean
description: Will exist if Cloudflare automatically added this DNS record
during initial setup.
example: true
source:
type: string
description: Where the record originated from.
example: primary
modified_on:
type: string
format: date-time
description: When the record was last modified.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
proxiable:
type: boolean
description: Whether the record can be proxied by Cloudflare or not.
example: true
readOnly: true
proxied:
$ref: '#/components/schemas/proxied'
ttl:
$ref: '#/components/schemas/ttl'
type:
$ref: '#/components/schemas/dns-record_components-schemas-type'
zone_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
zone_name:
type: string
format: hostname
description: The domain of the record.
example: example.com
readOnly: true
dns-record_components-schemas-identifier:
type: string
description: DNS record identifier tag.
example: 372e67954025e0ba6aaa6d586b9e0b59
readOnly: true
maxLength: 32
dns-record_components-schemas-name:
type: string
description: DNS record name (or @ for the zone apex).
example: example.com
maxLength: 255
dns-record_components-schemas-type:
type: string
description: DNS record type.
enum:
- A
- AAAA
- CNAME
- HTTPS
- TXT
- SRV
- LOC
- MX
- NS
- CERT
- DNSKEY
- DS
- NAPTR
- SMIMEA
- SSHFP
- SVCB
- TLSA
- URI
example: A
readOnly: true
dns-secondary-primary-zone_components-schemas-identifier:
example: 269d8f4853475ca241c4e730be286b20
dns-secondary-primary-zone_components-schemas-name:
type: string
description: Zone name.
example: www.example.com.
dns-secondary-secondary-zone:
type: object
required:
- id
- name
- peers
- auto_refresh_seconds
properties:
auto_refresh_seconds:
$ref: '#/components/schemas/auto_refresh_seconds'
id:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
name:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-name'
peers:
$ref: '#/components/schemas/peers'
dns-secondary-secondary-zone_components-schemas-identifier:
example: 269d8f4853475ca241c4e730be286b20
dns-secondary-secondary-zone_components-schemas-name:
type: string
description: Zone name.
example: www.example.com.
dns-settings_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-dns-record'
dns_firewall_ips:
type: array
example:
- 203.0.113.1
- 203.0.113.254
- 2001:DB8:AB::CF
- 2001:DB8:CD::CF
items:
anyOf:
- type: string
format: ipv4
description: Origin DNS Server IPv4 Address.
example: 203.0.113.1
- type: string
format: ipv6
description: Origin DNS Server IPv6 Address.
example: 2001:DB8:ab::CF
dns_firewall_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/dns-firewall'
dns_firewall_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/dns-firewall'
dns_name:
type: string
format: hostname
description: The name of the DNS record associated with the application.
example: ssh.example.com
dns_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/dns-record'
dns_response_import_scan:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
recs_added:
type: number
description: Number of DNS records added.
example: 5
total_records_parsed:
type: number
description: Total number of DNS records parsed.
example: 5
timing:
type: object
properties:
end_time:
type: string
format: date-time
description: When the file parsing ended.
example: "2014-03-01T12:20:01Z"
process_time:
type: number
description: Processing time of the file in seconds.
example: 1
start_time:
type: string
format: date-time
description: When the file parsing started.
example: "2014-03-01T12:20:00Z"
dns_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
dns_ttl:
type: integer
description: The TTL of our resolution of your DNS record in seconds.
minimum: 600
dns_type:
type: string
description: The type of DNS record associated with the application.
enum:
- CNAME
- ADDRESS
example: CNAME
dnslink:
type: string
description: DNSLink value used if the target is ipfs.
example: /ipns/onboarding.ipfs.cloudflare.com
dnssec_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
domain:
type: object
properties:
environment:
$ref: '#/components/schemas/environment'
hostname:
$ref: '#/components/schemas/components-schemas-hostname'
id:
$ref: '#/components/schemas/domain_identifier'
service:
$ref: '#/components/schemas/service'
zone_id:
$ref: '#/components/schemas/zone_identifier'
zone_name:
$ref: '#/components/schemas/zone_name'
domain-history:
properties:
categorizations:
type: array
items:
type: object
properties:
categories:
example:
- id: 155
name: Technology
end:
type: string
format: date
example: "2021-04-30"
start:
type: string
format: date
example: "2021-04-01"
domain:
$ref: '#/components/schemas/schemas-domain_name'
domain-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
- properties:
result:
type: array
items:
type: object
domain-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
domain_components-schemas-domain:
properties:
additional_information:
$ref: '#/components/schemas/additional_information'
application:
$ref: '#/components/schemas/schemas-application'
content_categories:
$ref: '#/components/schemas/content_categories'
domain:
$ref: '#/components/schemas/schemas-domain_name'
popularity_rank:
$ref: '#/components/schemas/popularity_rank'
resolves_to_refs:
$ref: '#/components/schemas/resolves_to_refs'
risk_score:
$ref: '#/components/schemas/risk_score'
risk_types:
$ref: '#/components/schemas/risk_types'
domain_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/domain_components-schemas-domain'
domain_identifier:
description: Identifer of the Worker Domain.
example: dbe10b4bc17c295377eabd600e1787fd
domain_name:
type: string
description: Name of the domain.
example: this-is-my-domain-01.com
pattern: ^[a-z0-9][a-z0-9-]*$
domain_names:
type: array
description: List of domain names.
example:
- cloudflare.com
- cloudflare.net
items:
type: string
domain_properties:
type: object
properties:
available:
$ref: '#/components/schemas/schemas-available'
can_register:
$ref: '#/components/schemas/can_register'
created_at:
$ref: '#/components/schemas/components-schemas-created_at'
current_registrar:
$ref: '#/components/schemas/current_registrar'
expires_at:
$ref: '#/components/schemas/expires_at'
id:
$ref: '#/components/schemas/schemas-domain_identifier'
locked:
$ref: '#/components/schemas/locked'
registrant_contact:
$ref: '#/components/schemas/registrant_contact'
registry_statuses:
$ref: '#/components/schemas/registry_statuses'
supported_tld:
$ref: '#/components/schemas/supported_tld'
transfer_in:
$ref: '#/components/schemas/transfer_in'
updated_at:
$ref: '#/components/schemas/components-schemas-updated_at'
domain_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/domains'
domain_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
domain_rule:
type: object
title: Email domain
description: Match an entire email domain.
required:
- email_domain
properties:
email_domain:
type: object
required:
- domain
properties:
domain:
type: string
description: The email domain to match.
example: example.com
domain_update_properties:
type: object
properties:
auto_renew:
$ref: '#/components/schemas/auto_renew'
locked:
$ref: '#/components/schemas/locked'
name_servers:
$ref: '#/components/schemas/name_servers'
privacy:
$ref: '#/components/schemas/privacy'
domains:
allOf:
- $ref: '#/components/schemas/domain_properties'
type: object
domains-post:
example:
name: example.com
domains_components-schemas-account_identifier:
example: 9a7806061c88ada191ed06f989cc3dac
downloadedFrom:
type: string
description: The source URL for a downloaded image. If the watermark profile
was created via direct upload, this field is null.
example: https://company.com/logo.png
readOnly: true
downloads_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
duration:
type: number
description: The duration of the plan subscription.
example: 1
early_hints:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- early_hints
example: early_hints
value:
$ref: '#/components/schemas/early_hints_value'
title: Early Hints
description: When enabled, Cloudflare will attempt to speed up overall page
loads by serving `103` responses with `Link` headers from the final response.
Refer to [Early Hints](https://developers.cloudflare.com/cache/about/early-hints)
for more information.
early_hints_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
ecs-support:
type: boolean
description: Set if the location needs to resolve EDNS queries.
example: false
ecs_fallback:
type: boolean
description: Forward client IP (resolver) subnet if no EDNS Client Subnet is
sent.
example: false
edge_cache_ttl:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- edge_cache_ttl
example: edge_cache_ttl
value:
$ref: '#/components/schemas/edge_cache_ttl_value'
title: Edge Cache TTL
description: Time (in seconds) that a resource will be ensured to remain on
Cloudflare's cache servers.
edge_cache_ttl_value:
type: number
description: |-
Value of the zone setting.
Notes: The minimum TTL available depends on the plan level of the zone. (Enterprise = 30, Business = 1800, Pro = 3600, Free = 7200)
enum:
- 30
- 60
- 300
- 1200
- 1800
- 3600
- 7200
- 10800
- 14400
- 18000
- 28800
- 43200
- 57600
- 72000
- 86400
- 172800
- 259200
- 345600
- 432000
- 518400
- 604800
default: 7200
edge_ips:
oneOf:
- type: object
properties:
connectivity:
type: string
description: The IP versions supported for inbound connections on Spectrum
anycast IPs.
enum:
- all
- ipv4
- ipv6
example: all
type:
type: string
description: The type of edge IP configuration specified. Dynamically
allocated edge IPs use Spectrum anycast IPs in accordance with the connectivity
you specify. Only valid with CNAME DNS names.
enum:
- dynamic
example: dynamic
- type: object
properties:
ips:
type: array
description: The array of customer owned IPs we broadcast via anycast
for this hostname and application.
example:
- 192.0.2.1
items:
type: string
description: Edge anycast IPs.
example: 192.0.2.1
type:
type: string
description: The type of edge IP configuration specified. Statically allocated
edge IPs use customer IPs in accordance with the ips array you specify.
Only valid with ADDRESS DNS names.
enum:
- static
example: static
description: The anycast edge IP configuration for the hostname of this application.
default:
connectivity: all
type: dynamic
editable:
type: boolean
description: Whether or not this setting can be modified for this zone (based
on your Cloudflare plan level).
enum:
- true
- false
default: true
readOnly: true
effect:
type: string
description: Allow or deny operations against the resources.
enum:
- allow
- deny
example: allow
either_profile_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
anyOf:
- $ref: '#/components/schemas/predefined_profile'
- $ref: '#/components/schemas/custom_profile'
eligibility:
type: object
properties:
eligible:
$ref: '#/components/schemas/eligible'
ready:
$ref: '#/components/schemas/ready'
type:
$ref: '#/components/schemas/eligibility_components-schemas-type'
eligibility_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: object
example:
email:
eligible: true
ready: true
type: email
eligibility_components-schemas-type:
type: string
description: Determines type of delivery mechanism.
enum:
- email
- pagerduty
- webhook
example: email
eligible:
type: boolean
description: Determines whether or not the account is eligible for the delivery
mechanism.
example: true
email:
type: string
description: The contact email address of the user.
example: user@example.com
maxLength: 90
email-settings_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
email_obfuscation:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- email_obfuscation
example: email_obfuscation
value:
$ref: '#/components/schemas/email_obfuscation_value'
title: Email Obfuscation
description: Encrypt email adresses on your web page from bots, while keeping
them visible to humans. (https://support.cloudflare.com/hc/en-us/articles/200170016).
email_obfuscation_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
email_rule:
type: object
title: Email
description: Matches a specific email.
required:
- email
properties:
email:
type: object
required:
- email
properties:
email:
type: string
format: email
description: The email of the user.
example: test@example.com
empty_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
maxItems: 0
items: {}
enable_binding_cookie:
type: boolean
description: Enables the binding cookie, which increases security against compromised
authorization tokens and CSRF attacks.
default: false
enable_transfer_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/enable_transfer_result'
enable_transfer_result:
type: string
description: The zone transfer status of a primary zone
example: Enabled
enabled:
type: boolean
description: Flag that indicates if the job was enabled.
example: false
enabled_download_phase:
type: boolean
description: Set to enable antivirus scan on downloads.
example: false
enabled_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
enabled:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-enabled'
enabled_upload_phase:
type: boolean
description: Set to enable antivirus scan on uploads.
example: false
end_time_seconds:
type: integer
description: Specifies the end time for the video clip in seconds.
readOnly: true
endpoint:
type: string
format: uri-template
description: 'The endpoint which can contain path parameter templates in curly
braces, each will be replaced from left to right with {varN}, starting with
{var1}, during insertion. This will further be Cloudflare-normalized upon
insertion. See: https://developers.cloudflare.com/rules/normalization/how-it-works/.'
example: /api/v1/users/{var1}
maxLength: 4096
pattern: ^/.*$
entry_id:
allOf:
- $ref: '#/components/schemas/uuid'
description: The ID for this entry
example: 719d1215-260f-41d0-8c32-eb320ad107f7
environment:
type: string
description: Worker environment associated with the zone and hostname.
example: production
error:
type: string
description: Errors resulting from collecting traceroute from colo to target.
enum:
- ""
- 'Could not gather traceroute data: Code 1'
- 'Could not gather traceroute data: Code 2'
- 'Could not gather traceroute data: Code 3'
- 'Could not gather traceroute data: Code 4'
example: ""
errorReasonCode:
type: string
description: Specifies why the video failed to encode. This field is empty if
the video is not in an `error` state. Preferred for programmatic use.
example: ERR_NON_VIDEO
readOnly: true
errorReasonText:
type: string
description: Specifies why the video failed to encode using a human readable
error message in English. This field is empty if the video is not in an `error`
state.
example: The file was not recognized as a valid video file.
readOnly: true
estimated_queued_users:
type: integer
estimated_total_active_users:
type: integer
event_custom_page_html:
type: string
description: If set, the event will override the waiting room's `custom_page_html`
property while it is active. If null, the event will inherit it.
example: '{{#waitTimeKnown}} {{waitTime}} mins {{/waitTimeKnown}} {{^waitTimeKnown}}
Event is prequeueing / Queue all enabled {{/waitTimeKnown}}'
nullable: true
event_description:
type: string
description: A note that you can use to add more details about the event.
default: ""
example: Production event - DO NOT MODIFY
event_details_custom_page_html:
type: string
example: '{{#waitTimeKnown}} {{waitTime}} mins {{/waitTimeKnown}} {{^waitTimeKnown}}
Event is prequeueing / Queue all enabled {{/waitTimeKnown}}'
event_details_disable_session_renewal:
type: boolean
example: false
event_details_new_users_per_minute:
type: integer
event_details_queueing_method:
type: string
example: random
event_details_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/event_details_result'
event_details_result:
type: object
properties:
created_on:
$ref: '#/components/schemas/timestamp'
custom_page_html:
$ref: '#/components/schemas/event_details_custom_page_html'
description:
$ref: '#/components/schemas/event_description'
disable_session_renewal:
$ref: '#/components/schemas/event_details_disable_session_renewal'
event_end_time:
$ref: '#/components/schemas/event_end_time'
event_start_time:
$ref: '#/components/schemas/event_start_time'
id:
$ref: '#/components/schemas/event_id'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/event_name'
new_users_per_minute:
$ref: '#/components/schemas/event_details_new_users_per_minute'
prequeue_start_time:
$ref: '#/components/schemas/event_prequeue_start_time'
queueing_method:
$ref: '#/components/schemas/event_details_queueing_method'
session_duration:
$ref: '#/components/schemas/event_details_session_duration'
shuffle_at_event_start:
$ref: '#/components/schemas/event_shuffle_at_event_start'
suspended:
$ref: '#/components/schemas/event_suspended'
total_active_users:
$ref: '#/components/schemas/event_details_total_active_users'
event_details_session_duration:
type: integer
event_details_total_active_users:
type: integer
event_disable_session_renewal:
type: boolean
description: If set, the event will override the waiting room's `disable_session_renewal`
property while it is active. If null, the event will inherit it.
nullable: true
event_end_time:
type: string
description: An ISO 8601 timestamp that marks the end of the event.
example: "2021-09-28T17:00:00.000Z"
event_id:
example: 25756b2dfe6e378a06b033b670413757
event_id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/event_id'
event_name:
type: string
description: A unique name to identify the event. Only alphanumeric characters,
hyphens and underscores are allowed.
example: production_webinar_event
event_new_users_per_minute:
type: integer
description: If set, the event will override the waiting room's `new_users_per_minute`
property while it is active. If null, the event will inherit it. This can
only be set if the event's `total_active_users` property is also set.
nullable: true
minimum: 200
maximum: 2.147483647e+09
event_prequeue_start_time:
type: string
description: An ISO 8601 timestamp that marks when to begin queueing all users
before the event starts. The prequeue must start at least five minutes before
`event_start_time`.
example: "2021-09-28T15:00:00.000Z"
nullable: true
event_queueing_method:
type: string
description: If set, the event will override the waiting room's `queueing_method`
property while it is active. If null, the event will inherit it.
example: random
nullable: true
event_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/event_result'
event_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/event_result'
event_result:
type: object
properties:
created_on:
$ref: '#/components/schemas/timestamp'
custom_page_html:
$ref: '#/components/schemas/event_custom_page_html'
description:
$ref: '#/components/schemas/event_description'
disable_session_renewal:
$ref: '#/components/schemas/event_disable_session_renewal'
event_end_time:
$ref: '#/components/schemas/event_end_time'
event_start_time:
$ref: '#/components/schemas/event_start_time'
id:
$ref: '#/components/schemas/event_id'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/event_name'
new_users_per_minute:
$ref: '#/components/schemas/event_new_users_per_minute'
prequeue_start_time:
$ref: '#/components/schemas/event_prequeue_start_time'
queueing_method:
$ref: '#/components/schemas/event_queueing_method'
session_duration:
$ref: '#/components/schemas/event_session_duration'
shuffle_at_event_start:
$ref: '#/components/schemas/event_shuffle_at_event_start'
suspended:
$ref: '#/components/schemas/event_suspended'
total_active_users:
$ref: '#/components/schemas/event_total_active_users'
event_session_duration:
type: integer
description: If set, the event will override the waiting room's `session_duration`
property while it is active. If null, the event will inherit it.
nullable: true
minimum: 1
maximum: 30
event_shuffle_at_event_start:
type: boolean
description: If enabled, users in the prequeue will be shuffled randomly at
the `event_start_time`. Requires that `prequeue_start_time` is not null. This
is useful for situations when many users will join the event prequeue at the
same time and you want to shuffle them to ensure fairness. Naturally, it makes
the most sense to enable this feature when the `queueing_method` during the
event respects ordering such as **fifo**, or else the shuffling may be unnecessary.
default: false
event_start_time:
type: string
description: An ISO 8601 timestamp that marks the start of the event. At this
time, queued users will be processed with the event's configuration. The start
time must be at least one minute before `event_end_time`.
example: "2021-09-28T15:30:00.000Z"
event_suspended:
type: boolean
description: Suspends or allows an event. If set to `true`, the event is ignored
and traffic will be handled based on the waiting room configuration.
default: false
event_total_active_users:
type: integer
description: If set, the event will override the waiting room's `total_active_users`
property while it is active. If null, the event will inherit it. This can
only be set if the event's `new_users_per_minute` property is also set.
nullable: true
minimum: 200
maximum: 2.147483647e+09
everyone_rule:
type: object
title: Everyone
description: Matches everyone.
required:
- everyone
properties:
everyone:
type: object
description: An empty object which matches on all users.
example: {}
exclude:
type: array
description: Rules evaluated with a NOT logical operator. To match a policy,
a user cannot meet any of the Exclude rules.
items:
$ref: '#/components/schemas/rule_components-schemas-rule'
expected_body:
type: string
description: A case-insensitive sub-string to look for in the response body.
If this string is not found, the origin will be marked as unhealthy. This
parameter is only valid for HTTP and HTTPS monitors.
example: alive
expected_codes:
type: string
description: The expected HTTP response code or code range of the health check.
This parameter is only valid for HTTP and HTTPS monitors.
default: "200"
example: 2xx
expiration:
type: number
description: The time, measured in number of seconds since the UNIX epoch, at
which the key should expire.
example: 1.578435e+09
expiration_ttl:
type: number
description: The number of seconds for which the key should be visible before
it expires. At least 60.
example: 300
expires_at:
type: string
format: date-time
description: Shows when domain name registration expires.
example: "2019-08-28T23:59:59Z"
expires_on:
type: string
format: date-time
description: The expiration time on or after which the JWT MUST NOT be accepted
for processing.
example: "2020-01-01T00:00:00Z"
expression:
type: string
description: The filter expression. For more information, refer to [Expressions](https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/).
example: (http.request.uri.path ~ ".*wp-login.php" or http.request.uri.path
~ ".*xmlrpc.php") and ip.addr ne 172.16.22.155
externally_managed:
type: boolean
description: Indicates whether this plan is managed externally.
default: false
example: false
fail_closed:
type: boolean
description: Block requests for files that cannot be scanned.
example: false
failed_login_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
properties:
expiration:
type: integer
metadata:
type: object
example:
app_name: Test App
aud: 39691c1480a2352a18ece567debc2b32552686cbd38eec0887aa18d5d3f00c04
datetime: "2022-02-02T21:54:34.914Z"
ray_id: 6d76a8a42ead4133
user_email: test@cloudflare.com
user_uuid: 57171132-e453-4ee8-b2a5-8cbaad333207
failure_reason:
type: string
description: The current failure reason if status is unhealthy.
example: ""
readOnly: true
fallback_domain:
type: object
required:
- suffix
properties:
description:
type: string
description: A description of the fallback domain, displayed in the client
UI.
example: Domain bypass for local development
maxLength: 100
dns_server:
type: array
description: A list of IP addresses to handle domain resolution.
items: {}
suffix:
type: string
description: The domain suffix to match when resolving locally.
example: example.com
fallback_domain_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/fallback_domain'
fallback_domains:
type: array
items:
$ref: '#/components/schemas/fallback_domain'
fallback_origin_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
fallback_pool:
description: The pool ID to use when all other pools are detected as unhealthy.
fax:
type: string
description: Contact fax number.
example: 123-867-5309
feature_app_props:
type: object
properties:
allowed_idps:
$ref: '#/components/schemas/allowed_idps'
auto_redirect_to_identity:
$ref: '#/components/schemas/auto_redirect_to_identity'
domain:
$ref: '#/components/schemas/schemas-domain'
name:
$ref: '#/components/schemas/apps_components-schemas-name'
session_duration:
$ref: '#/components/schemas/session_duration'
type:
$ref: '#/components/schemas/apps_components-schemas-type'
features:
anyOf:
- $ref: '#/components/schemas/thresholds'
type: object
readOnly: true
fetched_at:
type: string
description: The timestamp of when the script was last fetched.
nullable: true
fields_response:
type: object
properties:
key:
type: string
example: value
filename:
type: string
description: Image file name.
example: logo.png
readOnly: true
maxLength: 32
filter:
type: object
properties:
description:
$ref: '#/components/schemas/filters_components-schemas-description'
expression:
$ref: '#/components/schemas/expression'
id:
$ref: '#/components/schemas/filters_components-schemas-id'
paused:
$ref: '#/components/schemas/filters_components-schemas-paused'
ref:
$ref: '#/components/schemas/schemas-ref'
filter-delete-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/filter'
- type: object
required:
- id
filter-delete-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
allOf:
- $ref: '#/components/schemas/filter'
- type: object
required:
- id
filter-no-id:
required:
- pattern
- enabled
properties:
enabled:
$ref: '#/components/schemas/filters_components-schemas-enabled'
pattern:
$ref: '#/components/schemas/schemas-pattern'
filter-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/filters'
filter-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/filters'
filter-rule-base:
type: object
properties:
action:
$ref: '#/components/schemas/firewall-rules_components-schemas-action'
description:
$ref: '#/components/schemas/firewall-rules_components-schemas-description'
id:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
paused:
$ref: '#/components/schemas/firewall-rules_components-schemas-paused'
priority:
$ref: '#/components/schemas/firewall-rules_components-schemas-priority'
products:
$ref: '#/components/schemas/products'
ref:
$ref: '#/components/schemas/ref'
filter-rule-response:
allOf:
- $ref: '#/components/schemas/filter-rule-base'
- properties:
filter:
oneOf:
- $ref: '#/components/schemas/filter'
- $ref: '#/components/schemas/deleted-filter'
type: object
filter-rules-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- result
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/filter-rule-response'
- type: object
required:
- id
- filter
- action
- paused
filter-rules-response-collection-delete:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- result
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/filter-rule-response'
- type: object
required:
- id
filter-rules-single-response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
allOf:
- $ref: '#/components/schemas/filter-rule-response'
- type: object
required:
- id
- filter
- action
- paused
filter-rules-single-response-delete:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
allOf:
- $ref: '#/components/schemas/filter-rule-response'
- type: object
required:
- id
filter_options:
type: object
description: Filter options for a particular resource type (pool or origin).
Use null to reset.
nullable: true
properties:
disable:
type: boolean
description: If set true, disable notifications for this type of resource
(pool or origin).
default: false
healthy:
type: boolean
description: If present, send notifications only for this health status
(e.g. false for only DOWN events). Use null to reset (all events).
nullable: true
filters:
type: object
required:
- id
- pattern
- enabled
properties:
enabled:
$ref: '#/components/schemas/filters_components-schemas-enabled'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
pattern:
$ref: '#/components/schemas/schemas-pattern'
filters_components-schemas-description:
type: string
description: An informative summary of the filter.
example: Restrict access from these browsers on this address range.
maxLength: 500
filters_components-schemas-enabled:
type: boolean
title: Whether or not this filter will run a script
example: true
filters_components-schemas-id:
type: string
description: The unique identifier of the filter.
example: 372e67954025e0ba6aaa6d586b9e0b61
readOnly: true
minLength: 32
maxLength: 32
filters_components-schemas-paused:
type: boolean
description: When true, indicates that the filter is currently paused.
example: false
fingerprint:
type: string
description: The MD5 fingerprint of the certificate.
example: MD5 Fingerprint=1E:80:0F:7A:FD:31:55:96:DE:D5:CB:E2:F0:91:F6:91
fips-settings:
type: object
description: FIPS settings.
properties:
tls:
type: boolean
description: Enable only cipher suites and TLS versions compliant with FIPS
140-2.
example: true
firewall-rules_components-schemas-action:
type: string
description: The action to apply to a matched request. The `log` action is only
available on an Enterprise plan.
enum:
- block
- challenge
- js_challenge
- managed_challenge
- allow
- log
- bypass
example: block
firewall-rules_components-schemas-description:
type: string
description: An informative summary of the firewall rule.
example: Blocks traffic identified during investigation for MIR-31
maxLength: 500
firewall-rules_components-schemas-id:
type: string
description: The unique identifier of the firewall rule.
example: 372e67954025e0ba6aaa6d586b9e0b60
readOnly: true
maxLength: 32
firewall-rules_components-schemas-paused:
type: boolean
description: When true, indicates that the firewall rule is currently paused.
example: false
firewall-rules_components-schemas-priority:
type: number
description: The priority of the rule. Optional value used to define the processing
order. A lower number indicates a higher priority. If not provided, rules
with a defined priority will be processed before rules without a priority.
example: 50
minimum: 0
maximum: 2.147483647e+09
firewalluablock:
properties:
configuration:
$ref: '#/components/schemas/components-schemas-configuration'
description:
$ref: '#/components/schemas/ua-rules_components-schemas-description'
id:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
mode:
$ref: '#/components/schemas/ua-rules_components-schemas-mode'
paused:
$ref: '#/components/schemas/components-schemas-paused'
firewalluablock_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/ua-rules'
firewalluablock_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
first_name:
type: string
description: User's first name
example: John
nullable: true
maxLength: 60
fit:
type: string
description: The fit property describes how the width and height dimensions
should be interpreted.
enum:
- scale-down
- contain
- cover
- crop
- pad
example: scale-down
flag:
type: boolean
description: The log retention flag for Logpull API.
example: true
flag_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
flag:
type: boolean
example: true
follow_redirects:
type: boolean
description: Follow redirects if returned by the origin. This parameter is only
valid for HTTP and HTTPS monitors.
default: false
example: true
force_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/force_result'
force_result:
type: string
description: When force_axfr query parameter is set to true, the response is
a simple string
example: OK
frequency:
type: string
description: How often the subscription is renewed automatically.
enum:
- weekly
- monthly
- quarterly
- yearly
example: monthly
full_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
allOf:
- $ref: '#/components/schemas/address-maps'
- type: object
properties:
ips:
$ref: '#/components/schemas/schemas-ips'
memberships:
$ref: '#/components/schemas/memberships'
gateway-account-device-settings:
type: object
properties:
gateway_proxy_enabled:
type: boolean
description: Enable gateway proxy filtering on TCP.
example: true
gateway_udp_proxy_enabled:
type: boolean
description: Enable gateway proxy filtering on UDP.
example: true
gateway-account-device-settings-response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/gateway-account-device-settings'
type: object
gateway-account-logging-settings:
type: object
properties:
redact_pii:
type: boolean
description: 'Redact personally identifiable information from activity logging
(PII fields are: source IP, user email, user ID, device ID, URL, referrer,
user agent).'
example: true
settings_by_rule_type:
type: object
description: Logging settings by rule type.
properties:
dns:
type: object
description: Logging settings for DNS firewall.
http:
type: object
description: Logging settings for HTTP/HTTPS firewall.
l4:
type: object
description: Logging settings for Network firewall.
gateway-account-logging-settings-response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/gateway-account-logging-settings'
type: object
gateway-account-settings:
type: object
description: account settings.
properties:
settings:
type: object
description: account settings.
properties:
activity_log:
$ref: '#/components/schemas/activity-log-settings'
antivirus:
$ref: '#/components/schemas/anti-virus-settings'
block_page:
$ref: '#/components/schemas/block-page-settings'
browser_isolation:
$ref: '#/components/schemas/browser-isolation-settings'
fips:
$ref: '#/components/schemas/fips-settings'
tls_decrypt:
$ref: '#/components/schemas/tls-settings'
gateway_account:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
gateway_tag:
$ref: '#/components/schemas/gateway_tag'
id:
$ref: '#/components/schemas/cf_account_id'
provider_name:
$ref: '#/components/schemas/provider_name'
type: object
gateway_account_config:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
allOf:
- $ref: '#/components/schemas/gateway-account-settings'
- properties:
created_at:
$ref: '#/components/schemas/timestamp'
updated_at:
$ref: '#/components/schemas/timestamp'
type: object
type: object
gateway_seat:
type: boolean
description: True if the seat is part of Gateway.
example: false
gateway_tag:
type: string
description: Gateway internal id.
example: f174e90afafe4643bbbc4a0ed4fc8415
maxLength: 32
gateway_unique_id:
type: string
example: 699d98642c564d2e855e9661899b7252
geo_restrictions:
type: object
description: Specify the region where your private key can be held locally for
optimal TLS performance. HTTPS connections to any excluded data center will
still be fully encrypted, but will incur some latency while Keyless SSL is
used to complete the handshake with the nearest allowed data center. Options
allow distribution to only to U.S. data centers, only to E.U. data centers,
or only to highest security data centers. Default distribution is to all Cloudflare
datacenters, for optimal performance.
properties:
label:
enum:
- us
- eu
- highest_security
example: us
get-zone-connection-response:
allOf:
- $ref: '#/components/schemas/connection'
get-zone-script-response:
allOf:
- $ref: '#/components/schemas/script'
- properties:
versions:
type: array
example:
- fetched_at: "2021-08-18T10:51:08Z"
hash: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b423
js_integrity_score: 2
nullable: true
items:
$ref: '#/components/schemas/components-schemas-version'
get-zone-settings-response:
properties:
enabled:
$ref: '#/components/schemas/script-monitor_components-schemas-enabled'
updated_at:
$ref: '#/components/schemas/schemas-updated_at'
use_cloudflare_reporting_endpoint:
$ref: '#/components/schemas/use_cloudflare_reporting_endpoint'
use_connection_url_path:
$ref: '#/components/schemas/use_connection_url_path'
get_ownership_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
nullable: true
properties:
filename:
type: string
example: logs/challenge-filename.txt
message:
type: string
example: ""
valid:
type: boolean
example: true
get_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/zone_metadata'
github_organization_rule:
type: object
title: Github organization
description: |-
Matches a Github organization.
Requires a Github identity provider.
required:
- github-organization
properties:
github-organization:
type: object
required:
- name
- connection_id
properties:
connection_id:
type: string
description: The ID of your Github identity provider.
example: ea85612a-29c8-46c2-bacb-669d65136971
name:
type: string
description: The name of the organization.
example: cloudflare
grants:
type: object
example:
read: true
write: false
properties:
read:
type: boolean
example: true
write:
type: boolean
example: true
gre:
type: object
description: The configuration specific to GRE interconnects.
properties:
cloudflare_endpoint:
type: string
description: The IP address assigned to the Cloudflare side of the GRE tunnel
created as part of the Interconnect.
example: 203.0.113.1
customer_endpoint:
type: string
description: The IP address assigned to the customer side of the GRE tunnel
created as part of the Interconnect.
example: 203.0.113.1
gre-tunnel:
type: object
required:
- name
- customer_gre_endpoint
- cloudflare_gre_endpoint
- interface_address
properties:
cloudflare_gre_endpoint:
$ref: '#/components/schemas/cloudflare_gre_endpoint'
created_on:
$ref: '#/components/schemas/common_components-schemas-created_on'
customer_gre_endpoint:
$ref: '#/components/schemas/customer_gre_endpoint'
description:
$ref: '#/components/schemas/gre-tunnel_components-schemas-description'
health_check:
$ref: '#/components/schemas/health_check'
id:
$ref: '#/components/schemas/common_components-schemas-identifier-2'
interface_address:
$ref: '#/components/schemas/interface_address'
modified_on:
$ref: '#/components/schemas/common_components-schemas-modified_on'
mtu:
$ref: '#/components/schemas/mtu'
name:
$ref: '#/components/schemas/gre-tunnel_components-schemas-name'
ttl:
$ref: '#/components/schemas/components-schemas-ttl'
gre-tunnel_components-schemas-description:
type: string
description: An optional description of the GRE tunnel.
example: Tunnel for ISP X
gre-tunnel_components-schemas-name:
type: string
description: The name of the tunnel. The name cannot contain spaces or special
characters, must be 15 characters or less, and cannot share a name with another
GRE tunnel.
example: GRE_1
group:
type: object
properties:
description:
$ref: '#/components/schemas/group_components-schemas-description'
id:
$ref: '#/components/schemas/group_components-schemas-identifier'
modified_rules_count:
$ref: '#/components/schemas/modified_rules_count'
name:
$ref: '#/components/schemas/group_components-schemas-name'
package_id:
$ref: '#/components/schemas/package_components-schemas-identifier'
rules_count:
$ref: '#/components/schemas/rules_count'
group_components-schemas-description:
type: string
description: An informative summary of what the rule group does.
example: Group designed to protect against IP addresses that are a threat and
typically used to launch DDoS attacks
nullable: true
readOnly: true
group_components-schemas-identifier:
type: string
description: The unique identifier of the rule group.
example: de677e5818985db1285d0e80225f06e5
readOnly: true
maxLength: 32
group_components-schemas-name:
type: string
description: The name of the rule group.
example: Project Honey Pot
readOnly: true
groups:
type: object
description: An object that allows you to enable or disable WAF rule groups
for the current WAF override. Each key of this object must be the ID of a
WAF rule group, and each value must be a valid WAF action (usually `default`
or `disable`). When creating a new URI-based WAF override, you must provide
a `groups` object or a `rules` object.
example:
ea8687e59929c1fd05ba97574ad43f77: default
groups_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/schemas-uuid'
groups_components-schemas-name:
type: string
description: The name of the Access group.
example: Allow devs
groups_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-groups'
groups_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-groups'
gsuite_group_rule:
type: object
title: Google Workspace group
description: |-
Matches a group in Google Workspace.
Requires a Google Workspace identity provider.
required:
- gsuite
properties:
gsuite:
type: object
required:
- email
- connection_id
properties:
connection_id:
type: string
description: The ID of your Google Workspace identity provider.
example: ea85612a-29c8-46c2-bacb-669d65136971
email:
type: string
description: The email of the Google Workspace group.
example: devs@cloudflare.com
h2_prioritization:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- h2_prioritization
example: h2_prioritization
value:
$ref: '#/components/schemas/h2_prioritization_value'
title: HTTP/2 Edge Prioritization
description: HTTP/2 Edge Prioritization optimises the delivery of resources
served through HTTP/2 to improve page load performance. It also supports fine
control of content delivery when used in conjunction with Workers.
h2_prioritization_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
- custom
default: "off"
hash:
type: string
description: The computed hash of the analyzed script.
nullable: true
minLength: 64
maxLength: 64
header:
type: object
description: The HTTP request headers to send in the health check. It is recommended
you set a Host header by default. The User-Agent header cannot be overridden.
This parameter is only valid for HTTP and HTTPS monitors.
example:
Host:
- example.com
X-App-ID:
- abc123
header_name:
type: string
description: The name of the response header to match.
example: Cf-Cache-Status
header_op:
type: string
description: 'The operator used when matching: `eq` means "equal" and `ne` means
"not equal".'
enum:
- eq
- ne
example: ne
header_value:
type: string
description: The value of the response header, which must match exactly.
example: HIT
health_check:
type: object
properties:
enabled:
type: boolean
description: Determines whether to run healthchecks for a tunnel.
default: true
example: true
target:
type: string
description: The address used to run healthchecks for a tunnel. This field
defaults to `customer_gre_endpoint address`.
example: 203.0.113.1
type:
type: string
description: The type of healthcheck to run, reply or request. The default
value is `reply`.
enum:
- reply
- request
default: reply
example: request
health_details:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
description: A list of regions from which to run health checks. Null means
every Cloudflare data center.
example:
pool_id: 17b5962d775c646f3f9725cbc7a53df4
pop_health:
Amsterdam, NL:
healthy: true
origins:
- 2001:DB8::5:
failure_reason: No failures
healthy: true
response_code: 401
rtt: 12.1ms
healthchecks:
type: object
properties:
address:
$ref: '#/components/schemas/schemas-address'
check_regions:
$ref: '#/components/schemas/schemas-check_regions'
consecutive_fails:
$ref: '#/components/schemas/consecutive_fails'
consecutive_successes:
$ref: '#/components/schemas/consecutive_successes'
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/healthchecks_components-schemas-description'
failure_reason:
$ref: '#/components/schemas/failure_reason'
http_config:
$ref: '#/components/schemas/http_config'
id:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
interval:
$ref: '#/components/schemas/components-schemas-interval'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/healthchecks_components-schemas-name'
retries:
$ref: '#/components/schemas/retries'
status:
$ref: '#/components/schemas/healthchecks_components-schemas-status'
suspended:
$ref: '#/components/schemas/suspended'
tcp_config:
$ref: '#/components/schemas/tcp_config'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/healthchecks_components-schemas-type'
healthchecks_components-schemas-description:
type: string
description: A human-readable description of the health check.
example: Health check for www.example.com
healthchecks_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
healthchecks_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
healthchecks_components-schemas-name:
type: string
description: A short name to identify the health check. Only alphanumeric characters,
hyphens and underscores are allowed.
example: server-1
healthchecks_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/healthchecks'
healthchecks_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/healthchecks'
healthchecks_components-schemas-status:
type: string
description: The current status of the origin server according to the health
check.
enum:
- unknown
- healthy
- unhealthy
- suspended
example: healthy
readOnly: true
healthchecks_components-schemas-type:
type: string
description: The protocol to use for the health check. Currently supported protocols
are 'HTTP', 'HTTPS' and 'TCP'.
default: HTTP
example: HTTPS
height:
type: integer
description: The height of the image in pixels.
readOnly: true
hero_url:
type: string
format: uri
description: URI to hero variant for an image.
example: https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/hero
readOnly: true
history:
type: object
properties:
alert_body:
$ref: '#/components/schemas/alert_body'
alert_type:
$ref: '#/components/schemas/schemas-alert_type'
description:
$ref: '#/components/schemas/history_components-schemas-description'
id:
$ref: '#/components/schemas/uuid'
mechanism:
$ref: '#/components/schemas/mechanism'
mechanism_type:
$ref: '#/components/schemas/mechanism_type'
name:
$ref: '#/components/schemas/history_components-schemas-name'
sent:
$ref: '#/components/schemas/sent'
history_components-schemas-description:
type: string
description: Description of the notification policy (if present).
example: Universal Certificate validation status, issuance, renewal, and expiration
notices
history_components-schemas-name:
type: string
description: Name of the policy.
example: SSL Notification Event Policy
history_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
example:
- alert_body: SSL certificate has expired
alert_type: universal_ssl_event_type
description: Universal Certificate validation status, issuance, renewal,
and expiration notices.
id: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
mechanism: test@example.com
mechanism_type: email
name: SSL Notification Event Policy
sent: "2021-10-08T17:52:17.571336Z"
items:
$ref: '#/components/schemas/history'
result_info:
type: object
example:
count: 1
page: 1
per_page: 20
hop_result:
type: object
properties:
nodes:
type: array
description: An array of node objects.
items:
$ref: '#/components/schemas/node_result'
packets_lost:
$ref: '#/components/schemas/packets_lost'
packets_sent:
$ref: '#/components/schemas/packets_sent'
packets_ttl:
$ref: '#/components/schemas/packets_ttl'
host:
type: string
format: hostname
description: RFC3986-compliant host.
example: www.example.com
maxLength: 255
hostname:
type: string
description: The custom hostname that will point to your hostname via CNAME.
example: app.example.com
readOnly: true
maxLength: 255
hostname-authenticated-origin-pull:
allOf:
- $ref: '#/components/schemas/hostname_certid_object'
type: object
properties:
cert_id:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
certificate:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate'
enabled:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-enabled'
hostname:
$ref: '#/components/schemas/schemas-hostname'
id:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
private_key:
$ref: '#/components/schemas/schemas-private_key'
hostname-authenticated-origin-pull_components-schemas-certificate:
type: string
description: The hostname certificate.
example: |
-----BEGIN CERTIFICATE-----
MIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
BAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX
aWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF
MQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50
ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1
CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB
KwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5
0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI
dZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2
izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4
9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI
GKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV
BAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF
MAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2
2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP
Mlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG
SvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq
2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw
YbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=
-----END CERTIFICATE-----
hostname-authenticated-origin-pull_components-schemas-certificate_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/hostname-authenticated-origin-pull'
hostname-authenticated-origin-pull_components-schemas-enabled:
type: boolean
description: Indicates whether hostname-level authenticated origin pulls is
enabled. A null value voids the association.
example: true
nullable: true
hostname-authenticated-origin-pull_components-schemas-expires_on:
type: string
format: date-time
description: The date when the certificate expires.
example: "2100-01-01T05:20:00Z"
readOnly: true
hostname-authenticated-origin-pull_components-schemas-identifier:
type: string
description: Certificate identifier tag.
example: 2458ce5a-0c35-4c7f-82c7-8e9487d3ff60
readOnly: true
maxLength: 36
hostname-authenticated-origin-pull_components-schemas-status:
description: Status of the certificate or the association.
enum:
- initializing
- pending_deployment
- pending_deletion
- active
- deleted
- deployment_timed_out
- deletion_timed_out
example: active
readOnly: true
hostname_aop_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/hostname-authenticated-origin-pull'
hostname_aop_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/hostname_certid_object'
hostname_certid_input:
type: object
properties:
cert_id:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
enabled:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-enabled'
hostname:
$ref: '#/components/schemas/schemas-hostname'
hostname_certid_object:
properties:
cert_id:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
cert_status:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-status'
cert_updated_at:
$ref: '#/components/schemas/updated_at'
cert_uploaded_on:
$ref: '#/components/schemas/components-schemas-uploaded_on'
certificate:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate'
created_at:
$ref: '#/components/schemas/schemas-created_at'
enabled:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-enabled'
expires_on:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-expires_on'
hostname:
$ref: '#/components/schemas/schemas-hostname'
issuer:
$ref: '#/components/schemas/issuer'
serial_number:
$ref: '#/components/schemas/serial_number'
signature:
$ref: '#/components/schemas/signature'
status:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-status'
updated_at:
$ref: '#/components/schemas/updated_at'
hostnames:
type: array
description: Array of hostnames or wildcard names (e.g., *.example.com) bound
to the certificate.
example:
- example.com
- '*.example.com'
items: {}
hosts:
type: array
items:
type: string
description: The valid hosts for the certificates.
example: example.com
readOnly: true
maxLength: 253
hotlink_protection:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- hotlink_protection
example: hotlink_protection
value:
$ref: '#/components/schemas/hotlink_protection_value'
title: Hotlink Protection
description: When enabled, the Hotlink Protection option ensures that other
sites cannot suck up your bandwidth by building pages that use images hosted
on your site. Anytime a request for an image on your site hits Cloudflare,
we check to ensure that it's not another site requesting them. People will
still be able to download and view images from your page, but other sites
won't be able to steal them for use on their own pages. (https://support.cloudflare.com/hc/en-us/articles/200170026).
hotlink_protection_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
http_config:
type: object
description: Parameters specific to an HTTP or HTTPS health check.
nullable: true
properties:
allow_insecure:
type: boolean
description: Do not validate the certificate when the health check uses
HTTPS.
default: false
expected_body:
type: string
description: A case-insensitive sub-string to look for in the response body.
If this string is not found, the origin will be marked as unhealthy.
example: success
expected_codes:
type: array
description: The expected HTTP response codes (e.g. "200") or code ranges
(e.g. "2xx" for all codes starting with 2) of the health check.
default: "200"
example:
- 2xx
- "302"
nullable: true
items:
type: string
follow_redirects:
type: boolean
description: Follow redirects if the origin returns a 3xx status code.
default: false
header:
type: object
description: The HTTP request headers to send in the health check. It is
recommended you set a Host header by default. The User-Agent header cannot
be overridden.
example:
Host:
- example.com
X-App-ID:
- abc123
nullable: true
method:
type: string
description: The HTTP method to use for the health check.
enum:
- GET
- HEAD
default: GET
path:
type: string
description: The endpoint path to health check against.
default: /
example: /health
port:
type: integer
description: Port number to connect to for the health check. Defaults to
80 if type is HTTP or 443 if type is HTTPS.
default: 80
http_only_cookie_attribute:
type: boolean
description: Enables the HttpOnly cookie attribute, which increases security
against XSS attacks.
default: true
example: true
http2:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- http2
example: http2
value:
$ref: '#/components/schemas/http2_value'
title: HTTP2 Value
description: HTTP2 enabled for this zone.
http2_value:
type: string
description: Value of the HTTP2 setting.
enum:
- "on"
- "off"
default: "off"
http3:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- http3
example: http3
value:
$ref: '#/components/schemas/http3_value'
title: HTTP3 Value
description: HTTP3 enabled for this zone.
http3_value:
type: string
description: Value of the HTTP3 setting.
enum:
- "on"
- "off"
default: "off"
id:
type: integer
description: Unique id of the job.
minimum: 1
id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
identifier:
type: string
description: Identifier
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
identity:
type: string
description: The wirefilter expression to be used for identity matching.
example: any(identity.groups.name[*] in {"finance"})
identity-providers:
type: object
properties:
config:
$ref: '#/components/schemas/schemas-config'
id:
$ref: '#/components/schemas/uuid'
name:
$ref: '#/components/schemas/identity-providers_components-schemas-name'
type:
$ref: '#/components/schemas/identity-providers_components-schemas-type'
identity-providers_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
identity-providers_components-schemas-name:
type: string
description: The name of the identity provider, shown to users on the login
page.
example: Widget Corps OTP
identity-providers_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/identity-providers'
identity-providers_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/identity-providers'
identity-providers_components-schemas-type:
type: string
description: The type of identity provider. To determine the value for a specific
provider, refer to our [developer documentation](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/).
example: onetimepin
image_basic_upload_via_url:
type: object
required:
- url
properties:
metadata:
type: object
description: User modifiable key-value store. Can use used for keeping references
to another system of record for managing images.
requireSignedURLs:
type: boolean
description: Indicates whether the image requires a signature token for
the access.
default: false
example: true
url:
type: string
description: A URL to fetch an image from origin.
example: https://example.com/path/to/logo.png
image_patch_request:
type: object
properties:
metadata:
type: object
description: User modifiable key-value store. Can be used for keeping references
to another system of record for managing images. No change if not specified.
requireSignedURLs:
type: boolean
description: Indicates whether the image can be accessed using only its
UID. If set to `true`, a signed token needs to be generated with a signing
key to view the image. Returns a new UID on a change. No change if not
specified.
example: true
image_resizing:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- image_resizing
example: image_resizing
value:
$ref: '#/components/schemas/image_resizing_value'
title: Image Resizing
description: Image Resizing provides on-demand resizing, conversion and optimisation
for images served through Cloudflare's network. Refer to the [Image Resizing
documentation](https://developers.cloudflare.com/images/) for more information.
image_resizing_value:
type: string
description: Whether the feature is enabled, disabled, or enabled in `open proxy`
mode.
enum:
- "on"
- "off"
- open
default: "off"
image_response_blob:
anyOf:
- type: string
- type: object
example:
image_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/images'
image_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
images:
type: object
properties:
filename:
$ref: '#/components/schemas/filename'
id:
$ref: '#/components/schemas/images_components-schemas-identifier'
metadata:
$ref: '#/components/schemas/metadata'
requireSignedURLs:
$ref: '#/components/schemas/schemas-requireSignedURLs'
uploaded:
$ref: '#/components/schemas/schemas-uploaded'
variants:
$ref: '#/components/schemas/schemas-variants'
images_components-schemas-account_identifier:
type: string
description: Account identifier tag.
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
images_components-schemas-identifier:
type: string
description: Image unique identifier.
example: 107b9558-dd06-4bbd-5fef-9c2c16bb7900
readOnly: true
maxLength: 32
images_count:
type: object
properties:
allowed:
$ref: '#/components/schemas/allowed'
current:
$ref: '#/components/schemas/current'
images_stats:
type: object
properties:
count:
$ref: '#/components/schemas/images_count'
include:
type: array
description: Rules evaluated with an OR logical operator. A user needs to meet
only one of the Include rules.
items:
$ref: '#/components/schemas/rule_components-schemas-rule'
input:
type: object
readOnly: true
properties:
height:
type: integer
description: The video height in pixels. A value of `-1` means the height
is unknown. The value becomes available after the upload and before the
video is ready.
readOnly: true
width:
type: integer
description: The video width in pixels. A value of `-1` means the width
is unknown. The value becomes available after the upload and before the
video is ready.
readOnly: true
install_id:
type: string
description: app install id.
interconnect:
type: object
properties:
colo_name:
$ref: '#/components/schemas/interconnect_components-schemas-name'
created_on:
$ref: '#/components/schemas/common_components-schemas-created_on'
description:
$ref: '#/components/schemas/interconnect_components-schemas-description'
gre:
$ref: '#/components/schemas/gre'
health_check:
$ref: '#/components/schemas/schemas-health_check'
id:
$ref: '#/components/schemas/common_components-schemas-identifier-2'
interface_address:
$ref: '#/components/schemas/interface_address'
modified_on:
$ref: '#/components/schemas/common_components-schemas-modified_on'
mtu:
$ref: '#/components/schemas/schemas-mtu'
name:
$ref: '#/components/schemas/interconnect_components-schemas-name'
interconnect_components-schemas-description:
type: string
description: An optional description of the interconnect.
example: Tunnel for Interconnect to ORD
interconnect_components-schemas-name:
type: string
description: The name of the interconnect. The name cannot share a name with
other tunnels.
example: pni_ord
interface_address:
type: string
description: 'A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one
for each side of the tunnel. Select the subnet from the following private
IP space: 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.'
example: 192.0.2.0/31
interval:
type: integer
description: The interval between each health check. Shorter intervals may improve
failover time, but will increase load on the origins as we check from multiple
locations.
default: 60
intune_config_request:
type: object
required:
- customer_id
- client_id
- client_secret
properties:
client_id:
type: string
description: The Intune client ID.
example: example client id
client_secret:
type: string
description: The Intune client secret.
example: example client secret
customer_id:
type: string
description: The Intune customer ID.
example: example customer id
invite:
allOf:
- $ref: '#/components/schemas/organization_invite'
type: object
invite_components-schemas-identifier:
type: string
description: Invite identifier tag.
example: 4f5f0c14a2a41d5063dd301b2f829f04
readOnly: true
maxLength: 32
invited_by:
type: string
description: The email address of the user who created the invite.
example: user@example.com
maxLength: 90
invited_member_email:
type: string
description: Email address of the user to add to the organization.
example: user@example.com
maxLength: 90
invited_on:
type: string
format: date-time
description: When the invite was sent.
example: "2014-01-01T05:20:00Z"
readOnly: true
ip:
type: string
description: IPv4/IPv6 address of primary or secondary nameserver, depending
on what zone this peer is linked to. For primary zones this IP defines the
IP of the secondary nameserver Cloudflare will NOTIFY upon zone changes. For
secondary zones this IP defines the IP of the primary nameserver Cloudflare
will send AXFR/IXFR requests to.
example: 192.0.2.53
ip-list:
properties:
description:
type: string
id:
type: integer
name:
type: string
example: Malware
ip_address:
type: string
description: An IPv4 or IPv6 address.
example: 192.0.2.1
ip_components-schemas-ip:
properties:
belongs_to_ref:
type: object
description: Specifies a reference to the autonomous systems (AS) that the
IP address belongs to.
properties:
country:
type: string
example: US
description:
type: string
example: CLOUDFLARENET
id:
example: autonomous-system--2fa28d71-3549-5a38-af05-770b79ad6ea8
type:
type: string
description: Infrastructure type of this ASN.
enum:
- hosting_provider
- isp
- organization
example: hosting_provider
value:
type: string
ip:
$ref: '#/components/schemas/common_components-schemas-ip'
risk_types:
example:
- id: 131
name: Phishing
super_category_id: 21
ip_configuration:
title: An IP address configuration.
properties:
target:
description: The configuration target. You must set the target to `ip` when
specifying an IP address in the rule.
enum:
- ip
example: ip
value:
type: string
description: The IP address to match. This address will be compared to the
IP address of incoming requests.
example: 198.51.100.4
ip_firewall:
type: boolean
description: |-
Enables IP Access Rules for this application.
Notes: Only available for TCP applications.
example: true
ip_geolocation:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- ip_geolocation
example: ip_geolocation
value:
$ref: '#/components/schemas/ip_geolocation_value'
title: IP Geolocation
description: Enable IP Geolocation to have Cloudflare geolocate visitors to
your website and pass the country code to you. (https://support.cloudflare.com/hc/en-us/articles/200168236).
ip_geolocation_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
ip_list_rule:
type: object
title: IP list
description: Matches an IP address from a list.
required:
- ip_list
properties:
ip_list:
type: object
required:
- id
properties:
id:
type: string
description: The ID of a previously created IP list.
example: aa0a4aab-672b-4bdb-bc33-a59f1130a11f
ip_network:
type: string
description: The private IPv4 or IPv6 range connected by the route, in CIDR
notation.
example: 172.16.0.0/16
ip_network_encoded:
type: string
description: IP/CIDR range in URL-encoded format
example: 172.16.0.0%2F16
ip_range:
type: string
description: Allowed IPv4/IPv6 address range of primary or secondary nameservers.
This will be applied for the entire account. The IP range is used to allow
additional NOTIFY IPs for secondary zones and IPs Cloudflare allows AXFR/IXFR
requests from for primary zones. CIDRs are limited to a maximum of /24 for
IPv4 and /64 for IPv6 respectively.
example: 192.0.2.53/28
ip_rule:
type: object
title: IP ranges
description: Matches an IP address block.
required:
- ip
properties:
ip:
type: object
required:
- ip
properties:
ip:
type: string
description: An IPv4 or IPv6 CIDR block.
example: 2400:cb00:21:10a::/64
ipam-delegations:
type: object
properties:
cidr:
$ref: '#/components/schemas/cidr'
created_at:
$ref: '#/components/schemas/timestamp'
delegated_account_id:
$ref: '#/components/schemas/delegated_account_identifier'
id:
$ref: '#/components/schemas/delegation_identifier'
modified_at:
$ref: '#/components/schemas/timestamp'
parent_prefix_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
ipam-delegations_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/delegation_identifier'
ipam-delegations_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/ipam-delegations'
ipam-delegations_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/ipam-delegations'
ipam-prefixes:
type: object
properties:
account_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
advertised:
$ref: '#/components/schemas/advertised'
advertised_modified_at:
$ref: '#/components/schemas/modified_at_nullable'
approved:
$ref: '#/components/schemas/approved'
asn:
$ref: '#/components/schemas/asn'
cidr:
$ref: '#/components/schemas/cidr'
created_at:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-description'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
loa_document_id:
$ref: '#/components/schemas/loa_document_identifier'
modified_at:
$ref: '#/components/schemas/timestamp'
on_demand_enabled:
$ref: '#/components/schemas/on_demand_enabled'
on_demand_locked:
$ref: '#/components/schemas/on_demand_locked'
ipam-prefixes_components-schemas-description:
type: string
description: Description of the prefix.
example: Internal test prefix
maxLength: 1000
ipam-prefixes_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/ipam-prefixes'
ipam-prefixes_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/ipam-prefixes'
ips:
type: object
properties:
etag:
type: string
description: A digest of the IP data. Useful for determining if the data
has changed.
example: a8e453d9d129a3769407127936edfdb0
ipv4_cidrs:
type: array
description: List of Cloudflare IPv4 CIDR addresses.
items:
type: string
description: IPv4 CIDR.
example: 199.27.128.0/21
ipv6_cidrs:
type: array
description: List of Cloudflare IPv6 CIDR addresses.
items:
type: string
description: IPv6 CIDR.
example: 2400:cb00::/32
ipsec-tunnel:
type: object
required:
- name
- cloudflare_endpoint
- interface_address
properties:
allow_null_cipher:
$ref: '#/components/schemas/allow_null_cipher'
cloudflare_endpoint:
$ref: '#/components/schemas/cloudflare_ipsec_endpoint'
created_on:
$ref: '#/components/schemas/common_components-schemas-created_on'
customer_endpoint:
$ref: '#/components/schemas/customer_ipsec_endpoint'
description:
$ref: '#/components/schemas/ipsec-tunnel_components-schemas-description'
id:
$ref: '#/components/schemas/common_components-schemas-identifier-2'
interface_address:
$ref: '#/components/schemas/interface_address'
modified_on:
$ref: '#/components/schemas/common_components-schemas-modified_on'
name:
$ref: '#/components/schemas/ipsec-tunnel_components-schemas-name'
psk_metadata:
$ref: '#/components/schemas/psk_metadata'
tunnel_health_check:
$ref: '#/components/schemas/tunnel_health_check'
ipsec-tunnel_components-schemas-description:
type: string
description: An optional description forthe IPsec tunnel.
example: Tunnel for ISP X
ipsec-tunnel_components-schemas-name:
type: string
description: The name of the IPsec tunnel. The name cannot share a name with
other tunnels.
example: IPsec_1
ipv4:
type: string
format: ipv4
example: 192.0.2.0
ipv6:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- ipv6
example: ipv6
value:
$ref: '#/components/schemas/ipv6_value'
title: IPv6
description: Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).
ipv6_configuration:
title: An IPv6 address configuration.
properties:
target:
description: The configuration target. You must set the target to `ip6`
when specifying an IPv6 address in the rule.
enum:
- ip6
example: ip6
value:
type: string
description: The IPv6 address to match.
example: 2001:DB8:100::CF
ipv6_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
is_default_network:
type: boolean
description: If `true`, this virtual network is the default for the account.
example: true
is_pending_reconnect:
type: boolean
description: Cloudflare continues to track connections for several minutes after
they disconnect. This is an optimization to improve latency and reliability
of reconnecting. If `true`, the connection has disconnected but is still
being tracked. If `false`, the connection is actively serving traffic.
example: false
is_subscribed:
type: boolean
description: Indicates whether you are currently subscribed to this plan.
default: false
example: false
is_ui_read_only:
type: boolean
description: Lock all settings as Read-Only in the Dashboard, regardless of
user permission. Updates may only be made via the API or Terraform for this
account when enabled.
example: "false"
issued_on:
type: string
format: date-time
description: The time on which the token was created.
example: "2018-07-01T05:20:00Z"
readOnly: true
issuer:
type: string
description: The certificate authority that issued the certificate.
example: GlobalSign
readOnly: true
item:
oneOf:
- required:
- ip
- required:
- redirect
type: object
example:
comment: Private IP address
created_on: "2020-01-01T08:00:00Z"
id: 2c0fc9fa937b11eaa1b71c4d701ab86e
ip: 10.0.0.1
modified_on: "2020-01-10T14:00:00Z"
properties:
comment:
$ref: '#/components/schemas/item_comment'
created_on:
type: string
description: The RFC 3339 timestamp of when the item was created.
example: "2020-01-01T08:00:00Z"
readOnly: true
id:
$ref: '#/components/schemas/list_id'
ip:
$ref: '#/components/schemas/item_ip'
modified_on:
type: string
description: The RFC 3339 timestamp of when the item was last modified.
example: "2020-01-10T14:00:00Z"
readOnly: true
redirect:
$ref: '#/components/schemas/item_redirect'
item-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
$ref: '#/components/schemas/item'
item_comment:
type: string
description: An informative summary of the list item.
example: Private IP address
item_id:
type: string
description: The unique ID of the item in the List.
example: 34b12448945f11eaa1b71c4d701ab86e
item_ip:
type: string
description: An IPv4 address, an IPv4 CIDR, or an IPv6 CIDR. IPv6 CIDRs are
limited to a maximum of /64.
example: 10.0.0.1
item_redirect:
type: object
description: The definition of the redirect.
required:
- source_url
- target_url
properties:
include_subdomains:
type: boolean
default: false
preserve_path_suffix:
type: boolean
default: true
preserve_query_string:
type: boolean
default: false
source_url:
type: string
example: example.com/arch
status_code:
type: integer
enum:
- 301
- 302
- 307
- 308
default: 301
subpath_matching:
type: boolean
default: false
target_url:
type: string
example: https://archlinux.org/
items:
type: array
items:
$ref: '#/components/schemas/item'
items-list-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
$ref: '#/components/schemas/items'
result_info:
type: object
properties:
cursors:
type: object
properties:
after:
type: string
example: yyy
before:
type: string
example: xxx
items-update-request-collection:
type: array
items:
allOf:
- oneOf:
- required:
- ip
- required:
- redirect
type: object
properties:
comment:
$ref: '#/components/schemas/item_comment'
ip:
$ref: '#/components/schemas/item_ip'
redirect:
$ref: '#/components/schemas/item_redirect'
ixfr_enable:
type: boolean
description: Enable IXFR transfer protocol, default is AXFR. Only applicable
to secondary zones.
example: false
js_integrity_score:
type: integer
description: The integrity score of the JavaScript content.
nullable: true
minimum: 1
maximum: 99
json_response_enabled:
type: boolean
description: "Only available for the Waiting Room Advanced subscription. If
`true`, requests to the waiting room with the header `Accept: application/json`
will receive a JSON response object with information on the user's status
in the waiting room as opposed to the configured static HTML page. This JSON
response object has one property `cfWaitingRoom` which is an object containing
the following fields:\n1. `inWaitingRoom`: Boolean indicating if the user
is in the waiting room (always **true**).\n2. `waitTimeKnown`: Boolean indicating
if the current estimated wait times are accurate. If **false**, they are not
available.\n3. `waitTime`: Valid only when `waitTimeKnown` is **true**. Integer
indicating the current estimated time in minutes the user will wait in the
waiting room. When `queueingMethod` is **random**, this is set to `waitTime50Percentile`.\n4.
`waitTime25Percentile`: Valid only when `queueingMethod` is **random** and
`waitTimeKnown` is **true**. Integer indicating the current estimated maximum
wait time for the 25% of users that gain entry the fastest (25th percentile).\n5.
`waitTime50Percentile`: Valid only when `queueingMethod` is **random** and
`waitTimeKnown` is **true**. Integer indicating the current estimated maximum
wait time for the 50% of users that gain entry the fastest (50th percentile).
In other words, half of the queued users are expected to let into the origin
website before `waitTime50Percentile` and half are expected to be let in after
it.\n6. `waitTime75Percentile`: Valid only when `queueingMethod` is **random**
and `waitTimeKnown` is **true**. Integer indicating the current estimated
maximum wait time for the 75% of users that gain entry the fastest (75th percentile).\n7.
`waitTimeFormatted`: String displaying the `waitTime` formatted in English
for users. If `waitTimeKnown` is **false**, `waitTimeFormatted` will display
**unavailable**.\n8. `queueIsFull`: Boolean indicating if the waiting room's
queue is currently full and not accepting new users at the moment.\n9. `queueAll`:
Boolean indicating if all users will be queued in the waiting room and no
one will be let into the origin website.\n10. `lastUpdated`: String displaying
the timestamp as an ISO 8601 string of the user's last attempt to leave the
waiting room and be let into the origin website. The user is able to make
another attempt after `refreshIntervalSeconds` past this time. If the user
makes a request too soon, it will be ignored and `lastUpdated` will not change.\n11.
`refreshIntervalSeconds`: Integer indicating the number of seconds after `lastUpdated`
until the user is able to make another attempt to leave the waiting room and
be let into the origin website. When the `queueingMethod` is `reject`, there
is no specified refresh time — it will always be **zero**.\n12. `queueingMethod`:
The queueing method currently used by the waiting room. It is either **fifo**,
**random**, **passthrough**, or **reject**.\n13. `isFIFOQueue`: Boolean indicating
if the waiting room uses a FIFO (First-In-First-Out) queue.\n14. `isRandomQueue`:
Boolean indicating if the waiting room uses a Random queue where users gain
access randomly.\n15. `isPassthroughQueue`: Boolean indicating if the waiting
room uses a passthrough queue. Keep in mind that when passthrough is enabled,
this JSON response will only exist when `queueAll` is **true** or `isEventPrequeueing`
is **true** because in all other cases requests will go directly to the origin.\n16.
`isRejectQueue`: Boolean indicating if the waiting room uses a reject queue.\n17.
`isEventActive`: Boolean indicating if an event is currently occurring. Events
are able to change a waiting room's behavior during a specified period of
time. For additional information, look at the event properties `prequeue_start_time`,
`event_start_time`, and `event_end_time` in the documentation for creating
waiting room events. Events are considered active between these start and
end times, as well as during the prequeueing period if it exists.\n18. `isEventPrequeueing`:
Valid only when `isEventActive` is **true**. Boolean indicating if an event
is currently prequeueing users before it starts.\n19. `timeUntilEventStart`:
Valid only when `isEventPrequeueing` is **true**. Integer indicating the number
of minutes until the event starts.\n20. `timeUntilEventStartFormatted`: String
displaying the `timeUntilEventStart` formatted in English for users. If `isEventPrequeueing`
is **false**, `timeUntilEventStartFormatted` will display **unavailable**.\n21.
`timeUntilEventEnd`: Valid only when `isEventActive` is **true**. Integer
indicating the number of minutes until the event ends.\n22. `timeUntilEventEndFormatted`:
String displaying the `timeUntilEventEnd` formatted in English for users.
If `isEventActive` is **false**, `timeUntilEventEndFormatted` will display
**unavailable**.\n23. `shuffleAtEventStart`: Valid only when `isEventActive`
is **true**. Boolean indicating if the users in the prequeue are shuffled
randomly when the event starts.\n\nAn example cURL to a waiting room could
be:\n\n\tcurl -X GET \"https://example.com/waitingroom\" \\\n\t\t-H \"Accept:
application/json\"\n\nIf `json_response_enabled` is **true** and the request
hits the waiting room, an example JSON response when `queueingMethod` is **fifo**
and no event is active could be:\n\n\t{\n\t\t\"cfWaitingRoom\": {\n\t\t\t\"inWaitingRoom\":
true,\n\t\t\t\"waitTimeKnown\": true,\n\t\t\t\"waitTime\": 10,\n\t\t\t\"waitTime25Percentile\":
0,\n\t\t\t\"waitTime50Percentile\": 0,\n\t\t\t\"waitTime75Percentile\": 0,\n\t\t\t\"waitTimeFormatted\":
\"10 minutes\",\n\t\t\t\"queueIsFull\": false,\n\t\t\t\"queueAll\": false,\n\t\t\t\"lastUpdated\":
\"2020-08-03T23:46:00.000Z\",\n\t\t\t\"refreshIntervalSeconds\": 20,\n\t\t\t\"queueingMethod\":
\"fifo\",\n\t\t\t\"isFIFOQueue\": true,\n\t\t\t\"isRandomQueue\": false,\n\t\t\t\"isPassthroughQueue\":
false,\n\t\t\t\"isRejectQueue\": false,\n\t\t\t\"isEventActive\": false,\n\t\t\t\"isEventPrequeueing\":
false,\n\t\t\t\"timeUntilEventStart\": 0,\n\t\t\t\"timeUntilEventStartFormatted\":
\"unavailable\",\n\t\t\t\"timeUntilEventEnd\": 0,\n\t\t\t\"timeUntilEventEndFormatted\":
\"unavailable\",\n\t\t\t\"shuffleAtEventStart\": false\n\t\t}\n\t}\n\nIf `json_response_enabled`
is **true** and the request hits the waiting room, an example JSON response
when `queueingMethod` is **random** and an event is active could be:\n\n\t{\n\t\t\"cfWaitingRoom\":
{\n\t\t\t\"inWaitingRoom\": true,\n\t\t\t\"waitTimeKnown\": true,\n\t\t\t\"waitTime\":
10,\n\t\t\t\"waitTime25Percentile\": 5,\n\t\t\t\"waitTime50Percentile\": 10,\n\t\t\t\"waitTime75Percentile\":
15,\n\t\t\t\"waitTimeFormatted\": \"5 minutes to 15 minutes\",\n\t\t\t\"queueIsFull\":
false,\n\t\t\t\"queueAll\": false,\n\t\t\t\"lastUpdated\": \"2020-08-03T23:46:00.000Z\",\n\t\t\t\"refreshIntervalSeconds\":
20,\n\t\t\t\"queueingMethod\": \"random\",\n\t\t\t\"isFIFOQueue\": false,\n\t\t\t\"isRandomQueue\":
true,\n\t\t\t\"isPassthroughQueue\": false,\n\t\t\t\"isRejectQueue\": false,\n\t\t\t\"isEventActive\":
true,\n\t\t\t\"isEventPrequeueing\": false,\n\t\t\t\"timeUntilEventStart\":
0,\n\t\t\t\"timeUntilEventStartFormatted\": \"unavailable\",\n\t\t\t\"timeUntilEventEnd\":
15,\n\t\t\t\"timeUntilEventEndFormatted\": \"15 minutes\",\n\t\t\t\"shuffleAtEventStart\":
true\n\t\t}\n\t}."
default: false
example: false
jwk:
type: string
description: The signing key in JWK format.
example: eyJ1c2UiOiJzaWciLCJrdHkiOiJSU0EiLCJraWQiOiI1MjEzY2ZhMTIxZjcwYjhjMTM4MDY4NmZmYzM3MWJhMyIsImFsZyI6IlJTMjU2IiwibiI6IjBUandqT2laV21KNDN2ZjNUbzREb1htWFd0SkdOR3lYZmh5dHRMYUJnRjEtRVFXUURLaG9LYm9hS21xakNBc21za3V0YkxVN1BVOGRrUU5ER1p3S3VWczA4elNaNGt4aTR0RWdQUFp5dDdkWEMtbFlSWW95ckFHRjRBWGh5MzI5YkhDUDFJbHJCQl9Ba0dnbmRMQWd1bnhZMHJSZ2N2T3ppYXc2S0p4Rm5jMlVLMFdVOGIwcDRLS0hHcDFLTDlkazBXVDhkVllxYmVSaUpqQ2xVRW1oOHl2OUNsT1ZhUzRLeGlYNnhUUTREWnc2RGFKZklWM1F0Tmd2cG1ieWxOSmFQSG5zc3JodDJHS1A5NjJlS2poUVJsaWd2SFhKTE9uSm9KZkxlSUVIWi1peFdmY1RETUg5MnNHdm93MURPanhMaUNOMXpISy1oN2JMb1hUaUxnYzRrdyIsImUiOiJBUUFCIiwiZCI6IndpQWEwaU5mWnNYSGNOcVMxSWhnUmdzVHJHay1TcFlYV2lReDZHTU9kWlJKekhGazN0bkRERFJvNHNKZTBxX0dEOWkzNlEyZkVadS15elpEcEJkc3U5OHNtaHhNU19Ta0s5X3VFYUo1Zm96V2IyN3JRRnFoLVliUU9MUThkUnNPRHZmQl9Hb2txWWJzblJDR3kzWkFaOGZJZ25ocXBUNEpiOHdsaWxpMUgxeFpzM3RnTWtkTEluTm1yMFAtcTYxZEtNd3JYZVRoSWNEc0kyb2Z1LTFtRm1MWndQb2ZGbmxaTW9QN1pfRU5pUGNfWGtWNzFhaHBOZE9pcW5ablZtMHBCNE5QS1UweDRWTjQyYlAzWEhMUmpkV2hJOGt3SC1BdXhqb3BLaHJ0R2tvcG1jZFRkM1ZRdElaOGRpZHByMXpBaEpvQi16ZVlIaTFUel9ZSFFld0FRUSIsInAiOiIyVTZFVUJka3U3TndDYXoyNzZuWGMxRXgwVHpNZjU4U0UtU2M2eUNaYWk2TkwzVURpWi1mNHlIdkRLYnFGUXdLWDNwZ0l2aVE3Y05QYUpkbE9NeS1mU21GTXU3V3hlbVZYamFlTjJCMkRDazhQY0NEOVgxU2hhR3E1ZUdSSHNObVUtSDNxTG1FRGpjLWliazRHZ0RNb2lVYjQ2OGxFZHAwU2pIOXdsOUdsYTgiLCJxIjoiOW5ucXg5ZnNNY2dIZ29DemhfVjJmaDhoRUxUSUM5aFlIOVBCTG9aQjZIaE1TWG1ja1BSazVnUlpPWlFEN002TzlMaWZjNmFDVXdEbjBlQzU2YkFDNUNrcWxjODJsVDhzTWlMeWJyTjh3bWotcjNjSTBGQTlfSGQySEY1ZkgycnJmenVqd0NWM3czb09Ud3p4d1g3c2xKbklRanphel91SzEyWEtucVZZcUYwIiwiZHAiOiJxQklTUTlfVUNWaV9Ucng0UU9VYnZoVU9jc2FUWkNHajJiNzNudU9YeElnOHFuZldSSnN4RG5zd2FKaXdjNWJjYnZ3M1h0VGhRd1BNWnhpeE1UMHFGNlFGWVY5WXZibnJ6UEp4YkdNdTZqajZYc2lIUjFlbWU3U09lVDM4Xzg0aFZyOXV6UkN2RWstb0R0MHlodW9YVzFGWVFNRTE2cGtMV0ZkUjdRUERsQUUiLCJkcSI6Im5zQUp3eXZFbW8tdW5wU01qYjVBMHB6MExCRjBZNFMxeGRJYXNfLVBSYzd0dThsVFdWMl8teExEOFR6dmhqX0lmY0RJR3JJZGNKNjlzVVZnR1M3ZnZkcng3Y21uNjFyai1XcmU0UVJFRC1lV1dxZDlpc2FVRmg5UGVKZ2tCbFZVVnYtdnladVlWdFF2a1NUU05ZR3RtVXl2V2xKZDBPWEFHRm9jdGlfak9aVSIsInFpIjoib0dYaWxLQ2NKRXNFdEE1eG54WUdGQW5UUjNwdkZLUXR5S0F0UGhHaHkybm5ya2VzN1RRaEFxMGhLRWZtU1RzaE1hNFhfd05aMEstX1F0dkdoNDhpeHdTTDVLTEwxZnFsY0k2TF9XUnF0cFQxS21LRERlUHR2bDVCUzFGbjgwSGFwR215cmZRWUU4S09QR2UwUl82S1BOZE1vc3dYQ3Nfd0RYMF92ZzNoNUxRIn0=
readOnly: true
key:
type: object
description: A name for a value. A value stored under a given key may be retrieved
via the same key.
required:
- name
properties:
expiration:
type: number
description: The time, measured in number of seconds since the UNIX epoch,
at which the key will expire. This property is omitted for keys that will
not expire.
example: 1.5778368e+09
metadata:
$ref: '#/components/schemas/list_metadata'
name:
$ref: '#/components/schemas/key_name'
key_config:
type: object
properties:
days_until_next_rotation:
$ref: '#/components/schemas/days_until_next_rotation'
key_rotation_interval_days:
$ref: '#/components/schemas/key_rotation_interval_days'
last_key_rotation_at:
$ref: '#/components/schemas/last_key_rotation_at'
key_generation_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/keys'
key_name:
type: string
description: A key's name. The name may be at most 512 bytes. All printable,
non-whitespace characters are valid. Use percent-encoding to define key names
as part of a URL.
example: My-Key
maxLength: 512
key_name_bulk:
type: string
description: A key's name. The name may be at most 512 bytes. All printable,
non-whitespace characters are valid.
example: My-Key
maxLength: 512
key_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
properties:
created:
$ref: '#/components/schemas/keys_components-schemas-created'
id:
$ref: '#/components/schemas/keys_components-schemas-identifier'
key_rotation_interval_days:
type: number
description: The number of days between key rotations.
example: 30
minimum: 21
maximum: 365
keyless-certificate:
allOf:
- $ref: '#/components/schemas/keyless-certificate_components-schemas-base'
type: object
keyless-certificate_components-schemas-base:
type: object
required:
- id
- name
- host
- port
- status
- enabled
- permissions
- created_on
- modified_on
properties:
created_on:
type: string
format: date-time
description: When the Keyless SSL was created.
example: "2014-01-01T05:20:00Z"
readOnly: true
enabled:
$ref: '#/components/schemas/schemas-enabled'
host:
$ref: '#/components/schemas/schemas-host'
id:
$ref: '#/components/schemas/keyless-certificate_components-schemas-identifier'
modified_on:
type: string
format: date-time
description: When the Keyless SSL was last modified.
example: "2014-01-01T05:20:00Z"
readOnly: true
name:
$ref: '#/components/schemas/keyless-certificate_components-schemas-name'
permissions:
type: array
description: Available permissions for the Keyless SSL for the current user
requesting the item.
example:
- '#ssl:read'
- '#ssl:edit'
readOnly: true
items: {}
port:
$ref: '#/components/schemas/schemas-port'
status:
$ref: '#/components/schemas/keyless-certificate_components-schemas-status'
keyless-certificate_components-schemas-identifier:
type: string
description: Keyless certificate identifier tag.
example: 4d2844d2ce78891c34d0b6c0535a291e
readOnly: true
maxLength: 32
keyless-certificate_components-schemas-name:
type: string
description: The keyless SSL name.
example: example.com Keyless SSL
readOnly: true
maxLength: 180
keyless-certificate_components-schemas-status:
type: string
description: Status of the Keyless SSL.
enum:
- active
- deleted
example: active
readOnly: true
keyless_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/keyless-certificate'
keyless_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
keyless_response_single_id:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/keyless-certificate_components-schemas-identifier'
keys:
type: object
properties:
created:
$ref: '#/components/schemas/keys_components-schemas-created'
id:
$ref: '#/components/schemas/keys_components-schemas-identifier'
jwk:
$ref: '#/components/schemas/jwk'
pem:
$ref: '#/components/schemas/pem'
keys_components-schemas-created:
type: string
format: date-time
description: The date and time a signing key was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
keys_components-schemas-identifier:
example: 5213cfa121f70b8c1380686ffc371ba3
keys_components-schemas-identifier-2:
example: 699d98642c564d2e855e9661899b7252
keys_components-schemas-name:
type: string
description: Key name.
example: default
readOnly: true
keys_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/key_config'
keys_components-schemas-value:
type: string
description: Key value.
example: Oix0bbNaT8Rge9PuyxUBrjI6zrgnsyJ5=
readOnly: true
keys_response:
type: object
properties:
keys:
type: array
items:
$ref: '#/components/schemas/schemas-keys'
kind:
type: string
description: The type of the list. Each type supports specific list items (IP
addresses or redirects).
enum:
- ip
- redirect
example: ip
kv_components-schemas-value:
type: string
description: A byte sequence to be stored, up to 10 MB in length.
example: Some Value
kv_namespace_binding:
type: object
required:
- name
- type
- namespace_id
properties:
name:
$ref: '#/components/schemas/binding_name'
namespace_id:
$ref: '#/components/schemas/namespace_identifier'
type:
type: string
description: The class of resource that the binding provides.
enum:
- kv_namespace
example: kv_namespace
label:
type: string
description: The language label displayed in the native language to users.
example: Türkçe
readOnly: true
labels:
type: array
description: Field appears if there is an additional annotation printed when
the probe returns. Field also appears when running a GRE+ICMP traceroute to
denote which traceroute a node comes from.
items:
type: string
language:
type: string
description: The language tag in BCP 47 format.
example: tr
readOnly: true
language_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/captions'
language_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
last_failure:
type: string
format: date-time
description: Timestamp of the last time an attempt to dispatch a notification
to this webhook failed.
example: "2020-10-26T18:25:04.532316Z"
readOnly: true
last_key_rotation_at:
type: string
format: date-time
description: The timestamp of the previous key rotation.
example: "2014-01-01T05:20:00.12345Z"
last_name:
type: string
description: User's last name
example: Appleseed
nullable: true
maxLength: 60
last_seen:
type: string
format: date-time
description: When the device last connected to Cloudflare services.
example: "2017-06-14T00:00:00Z"
last_success:
type: string
format: date-time
description: Timestamp of the last time Cloudflare was able to successfully
dispatch a notification using this webhook.
example: "2020-10-26T18:25:04.532316Z"
readOnly: true
last_successful_login:
type: string
format: date-time
description: The time at which the user last successfully logged in.
example: "2020-07-01T05:20:00Z"
last_updated:
type: string
description: The timestamp of when the ruleset was last modified.
example: "2000-01-01T00:00:00.000000Z"
latitude:
type: number
description: The latitude of the data center containing the origins used in
this pool in decimal degrees. If this is set, longitude must also be set.
legacy_discount:
type: boolean
description: Indicates whether this plan has a legacy discount applied.
default: false
example: false
legacy_id:
type: string
description: The legacy identifier for this rate plan, if any.
example: free
readOnly: true
list:
properties:
created_on:
$ref: '#/components/schemas/components-schemas-created_on'
description:
$ref: '#/components/schemas/lists_components-schemas-description'
id:
$ref: '#/components/schemas/list_id'
kind:
$ref: '#/components/schemas/kind'
modified_on:
$ref: '#/components/schemas/lists_components-schemas-modified_on'
name:
$ref: '#/components/schemas/lists_components-schemas-name'
num_items:
$ref: '#/components/schemas/num_items'
num_referencing_filters:
$ref: '#/components/schemas/num_referencing_filters'
list-delete-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/item_id'
list-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
$ref: '#/components/schemas/list'
list-zone-connections-response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/connection'
result_info:
$ref: '#/components/schemas/result_info'
list-zone-scripts-response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/script'
result_info:
$ref: '#/components/schemas/result_info'
list_id:
type: string
description: The unique ID of the list.
example: 2c0fc9fa937b11eaa1b71c4d701ab86e
readOnly: true
minLength: 32
maxLength: 32
list_item_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-items'
- properties:
result_info:
type: object
properties:
count:
type: number
description: Total results returned based on your search parameters.
example: 1
page:
type: number
description: Current page within paginated list of results.
example: 1
per_page:
type: number
description: Number of results per page of results.
example: 20
total_count:
type: number
description: Total results available without any search parameters.
example: 2000
list_metadata:
type: object
description: Arbitrary JSON that is associated with a key.
example:
someMetadataKey: someMetadataValue
lists:
type: object
properties:
count:
$ref: '#/components/schemas/count'
created_at:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/lists_components-schemas-description-2'
id:
$ref: '#/components/schemas/lists_components-schemas-uuid'
name:
$ref: '#/components/schemas/lists_components-schemas-name-2'
type:
$ref: '#/components/schemas/lists_components-schemas-type'
updated_at:
$ref: '#/components/schemas/timestamp'
lists-async-response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: object
properties:
operation_id:
$ref: '#/components/schemas/schemas-operation_id'
lists-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/list'
- type: object
required:
- id
- name
- kind
- num_items
- created_on
- modified_on
lists_components-schemas-description:
type: string
description: An informative summary of the list.
example: This is a note.
maxLength: 500
lists_components-schemas-description-2:
type: string
description: The description of the List.
example: The serial numbers for administrators
lists_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
lists_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
lists_components-schemas-modified_on:
type: string
description: The RFC 3339 timestamp of when the list was last modified.
example: "2020-01-10T14:00:00Z"
lists_components-schemas-name:
type: string
description: An informative name for the list. Use this name in filter and rule
expressions.
example: list1
maxLength: 50
pattern: ^[a-zA-Z0-9_]+$
lists_components-schemas-name-2:
type: string
description: The name of the List.
example: Admin Serial Numbers
lists_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/lists'
lists_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/lists'
lists_components-schemas-type:
type: string
description: The type of List.
enum:
- SERIAL
- URL
- DOMAIN
- EMAIL
- IP
example: SERIAL
lists_components-schemas-uuid:
type: string
description: API Resource UUID tag.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
lists_components-schemas-value:
type: string
description: The value of the item in a List.
example: 8GE8721REF
live_input_default_creator:
type: string
description: Sets the creator ID asssociated with this live input.
live_input_identifier:
type: string
description: A unique identifier for a live input.
example: 66be4bf738797e01e1fca35a7bdecdcd
readOnly: true
maxLength: 32
live_input_metadata:
type: object
description: A user modifiable key-value store used to reference other systems
of record for managing live inputs.
example:
name: test stream 1
live_input_object_without_url:
properties:
created:
$ref: '#/components/schemas/connect_components-schemas-created'
meta:
$ref: '#/components/schemas/live_input_metadata'
modified:
$ref: '#/components/schemas/components-schemas-modified'
uid:
$ref: '#/components/schemas/live_input_identifier'
live_input_recording_allowedOrigins:
type: array
description: Lists the origins allowed to display videos created with this input.
Enter allowed origin domains in an array and use `*` for wildcard subdomains.
An empty array allows videos to be viewed on any origin.
example:
- example.com
items:
type: string
live_input_recording_mode:
type: string
description: Specifies the recording behavior for the live input. Set this value
to `off` to prevent a recording. Set the value to `automatic` to begin a recording
and transition to on-demand after Stream Live stops receiving input.
enum:
- "off"
- automatic
default: "off"
example: automatic
live_input_recording_requireSignedURLs:
type: boolean
description: Indicates if a video using the live input has the `requireSignedURLs`
property set. Also enforces access controls on any video recording of the
livestream with the live input.
default: false
example: true
live_input_recording_settings:
type: object
description: Records the input to a Cloudflare Stream video. Behavior depends
on the mode. In most cases, the video will initially be viewable as a live
video and transition to on-demand after a condition is satisfied.
example:
mode: "off"
requireSignedURLs: false
timeoutSeconds: 0
properties:
allowedOrigins:
$ref: '#/components/schemas/live_input_recording_allowedOrigins'
mode:
$ref: '#/components/schemas/live_input_recording_mode'
requireSignedURLs:
$ref: '#/components/schemas/live_input_recording_requireSignedURLs'
timeoutSeconds:
$ref: '#/components/schemas/live_input_recording_timeoutSeconds'
live_input_recording_timeoutSeconds:
type: integer
description: Determines the amount of time a live input configured in `automatic`
mode should wait before a recording transitions from live to on-demand. `0`
is recommended for most use cases and indicates the platform default should
be used.
default: 0
live_input_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: object
properties:
liveInputs:
type: array
items:
$ref: '#/components/schemas/live_input_object_without_url'
range:
type: integer
description: The total number of remaining live inputs based on cursor
position.
example: 1000
readOnly: true
total:
type: integer
description: The total number of live inputs that match the provided
filters.
example: 35586
readOnly: true
live_input_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
liveInput:
type: string
description: The live input ID used to upload a video with Stream Live.
example: fc0a8dc887b16759bfd9ad922230a014
readOnly: true
maxLength: 32
loa_document_identifier:
type: string
description: Identifier for the uploaded LOA document.
example: d933b1530bc56c9953cf8ce166da8004
nullable: true
readOnly: true
maxLength: 32
loa_upload_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
filename:
type: string
description: Name of LOA document.
example: document.pdf
load-balancer:
type: object
properties:
adaptive_routing:
$ref: '#/components/schemas/adaptive_routing'
country_pools:
$ref: '#/components/schemas/country_pools'
created_on:
$ref: '#/components/schemas/timestamp'
default_pools:
$ref: '#/components/schemas/default_pools'
description:
$ref: '#/components/schemas/load-balancer_components-schemas-description'
enabled:
$ref: '#/components/schemas/load-balancer_components-schemas-enabled'
fallback_pool:
$ref: '#/components/schemas/fallback_pool'
id:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
location_strategy:
$ref: '#/components/schemas/location_strategy'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/load-balancer_components-schemas-name'
pop_pools:
$ref: '#/components/schemas/pop_pools'
proxied:
$ref: '#/components/schemas/schemas-proxied'
random_steering:
$ref: '#/components/schemas/random_steering'
region_pools:
$ref: '#/components/schemas/region_pools'
rules:
$ref: '#/components/schemas/load-balancer_components-schemas-rules'
session_affinity:
$ref: '#/components/schemas/session_affinity'
session_affinity_attributes:
$ref: '#/components/schemas/session_affinity_attributes'
session_affinity_ttl:
$ref: '#/components/schemas/session_affinity_ttl'
steering_policy:
$ref: '#/components/schemas/steering_policy'
ttl:
$ref: '#/components/schemas/schemas-ttl'
load-balancer_components-schemas-description:
type: string
description: Object description.
example: Load Balancer for www.example.com
load-balancer_components-schemas-enabled:
type: boolean
description: Whether to enable (the default) this load balancer.
default: true
example: true
load-balancer_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
load-balancer_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
load-balancer_components-schemas-name:
type: string
description: The DNS hostname to associate with your Load Balancer. If this
hostname already exists as a DNS record in Cloudflare's DNS, the Load Balancer
will take precedence and the DNS record will not be used.
example: www.example.com
load-balancer_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/load-balancer'
load-balancer_components-schemas-rules:
type: array
description: 'BETA Field Not General Access: A list of rules for this load balancer
to execute.'
items:
type: object
description: A rule object containing conditions and overrides for this load
balancer to evaluate.
properties:
condition:
type: string
description: The condition expressions to evaluate. If the condition evaluates
to true, the overrides or fixed_response in this rule will be applied.
An empty condition is always true. For more details on condition expressions,
please see https://developers.cloudflare.com/load-balancing/understand-basics/load-balancing-rules/expressions.
example: http.request.uri.path contains "/testing"
disabled:
type: boolean
description: Disable this specific rule. It will no longer be evaluated
by this load balancer.
default: false
fixed_response:
type: object
description: A collection of fields used to directly respond to the eyeball
instead of routing to a pool. If a fixed_response is supplied the rule
will be marked as terminates.
properties:
content_type:
type: string
description: The http 'Content-Type' header to include in the response.
example: application/json
maxLength: 32
location:
type: string
description: The http 'Location' header to include in the response.
example: www.example.com
maxLength: 2048
message_body:
type: string
description: Text to include as the http body.
example: Testing Hello
maxLength: 1024
status_code:
type: integer
description: The http status code to respond with.
name:
type: string
description: Name of this rule. Only used for human readability.
example: route the path /testing to testing datacenter.
maxLength: 200
overrides:
type: object
description: A collection of overrides to apply to the load balancer when
this rule's condition is true. All fields are optional.
properties:
adaptive_routing:
$ref: '#/components/schemas/adaptive_routing'
country_pools:
$ref: '#/components/schemas/country_pools'
default_pools:
$ref: '#/components/schemas/default_pools'
fallback_pool:
$ref: '#/components/schemas/fallback_pool'
location_strategy:
$ref: '#/components/schemas/location_strategy'
pop_pools:
$ref: '#/components/schemas/pop_pools'
random_steering:
$ref: '#/components/schemas/random_steering'
region_pools:
$ref: '#/components/schemas/region_pools'
session_affinity:
$ref: '#/components/schemas/session_affinity'
session_affinity_attributes:
$ref: '#/components/schemas/session_affinity_attributes'
session_affinity_ttl:
$ref: '#/components/schemas/session_affinity_ttl'
steering_policy:
$ref: '#/components/schemas/steering_policy'
ttl:
$ref: '#/components/schemas/schemas-ttl'
priority:
type: integer
description: The order in which rules should be executed in relation to
each other. Lower values are executed first. Values do not need to be
sequential. If no value is provided for any rule the array order of
the rules field will be used to assign a priority.
default: 0
terminates:
type: boolean
description: If this rule's condition is true, this causes rule evaluation
to stop after processing this rule.
default: false
load-balancer_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/load-balancer'
load_shedding:
type: object
description: Configures load shedding policies and percentages for the pool.
properties:
default_percent:
type: number
description: The percent of traffic to shed from the pool, according to
the default policy. Applies to new sessions and traffic without session
affinity.
default: 0
minimum: 0
maximum: 100
default_policy:
type: string
description: The default policy to use when load shedding. A random policy
randomly sheds a given percent of requests. A hash policy computes a hash
over the CF-Connecting-IP address and sheds all requests originating from
a percent of IPs.
enum:
- random
- hash
default: random
session_percent:
type: number
description: The percent of existing sessions to shed from the pool, according
to the session policy.
default: 0
minimum: 0
maximum: 100
session_policy:
type: string
description: Only the hash policy is supported for existing sessions (to
avoid exponential decay).
enum:
- hash
default: hash
location_strategy:
type: object
description: Controls location-based steering for non-proxied requests. See
`steering_policy` to learn how steering is affected.
properties:
mode:
type: string
description: |-
Determines the authoritative location when ECS is not preferred, does not exist in the request, or its GeoIP lookup is unsuccessful.
- `"pop"`: Use the Cloudflare PoP location.
- `"resolver_ip"`: Use the DNS resolver GeoIP location. If the GeoIP lookup is unsuccessful, use the Cloudflare PoP location.
enum:
- pop
- resolver_ip
default: pop
example: resolver_ip
prefer_ecs:
type: string
description: |-
Whether the EDNS Client Subnet (ECS) GeoIP should be preferred as the authoritative location.
- `"always"`: Always prefer ECS.
- `"never"`: Never prefer ECS.
- `"proximity"`: Prefer ECS only when `steering_policy="proximity"`.
- `"geo"`: Prefer ECS only when `steering_policy="geo"`.
enum:
- always
- never
- proximity
- geo
default: proximity
example: always
locations:
type: object
properties:
client_default:
$ref: '#/components/schemas/client-default'
created_at:
$ref: '#/components/schemas/timestamp'
doh_subdomain:
$ref: '#/components/schemas/subdomain'
ecs_support:
$ref: '#/components/schemas/ecs-support'
id:
$ref: '#/components/schemas/locations_components-schemas-uuid'
ip:
$ref: '#/components/schemas/locations_components-schemas-ip'
name:
$ref: '#/components/schemas/locations_components-schemas-name'
networks:
$ref: '#/components/schemas/network'
updated_at:
$ref: '#/components/schemas/timestamp'
locations_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
locations_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
locations_components-schemas-ip:
type: string
description: IPV6 destination ip assigned to this location. DNS requests sent
to this IP will counted as the request under this location. (auto-generated).
example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
locations_components-schemas-name:
type: string
description: The name of the Location.
example: Austin Office Location
locations_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/locations'
locations_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/locations'
locations_components-schemas-uuid:
example: ed35569b41ce4d1facfe683550f54086
lockdowns_components-schemas-description:
type: string
description: An informative summary of the rule.
example: Restrict access to these endpoints to requests from a known IP address
maxLength: 1024
lockdowns_components-schemas-id:
type: string
description: The unique identifier of the Zone Lockdown rule.
example: 372e67954025e0ba6aaa6d586b9e0b59
readOnly: true
maxLength: 32
lockdowns_components-schemas-modified_on:
type: string
format: date-time
description: The timestamp of when the rule was last modified.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
locked:
type: boolean
description: Shows whether a registrar lock is in place for a domain.
example: false
logging:
type: object
description: An object configuring the rule's logging behavior.
example:
enabled: true
properties:
enabled:
type: boolean
description: Whether to generate a log when the rule matches.
example: true
login_design:
properties:
background_color:
type: string
description: The background color on your login page.
example: '#c5ed1b'
footer_text:
type: string
description: The text at the bottom of your login page.
example: This is an example description.
header_text:
type: string
description: The text at the top of your login page.
example: This is an example description.
logo_path:
type: string
description: The URL of the logo on your login page.
example: https://example.com/logo.png
text_color:
type: string
description: The text color on your login page.
example: '#c5ed1b'
logo_url:
type: string
description: The image URL for the logo shown in the App Launcher dashboard.
example: https://www.cloudflare.com/img/logo-web-badges/cf-logo-on-white-bg.svg
logpull_options:
type: string
format: uri-reference
description: Configuration string. It specifies things like requested fields
and timestamp formats. If migrating from the logpull api, copy the url (full
url or just the query string) of your call here, and logpush will keep on
making this call for you, setting start and end times appropriately.
example: fields=RayID,ClientIP,EdgeStartTimestamp×tamps=rfc3339
nullable: true
maxLength: 4096
logpush_components-schemas-name:
type: string
description: Optional human readable job name. Not unique. Cloudflare suggests
that you set this to a meaningful string, like the domain name, to make it
easier to identify your job.
example: example.com
nullable: true
maxLength: 512
pattern: ^[a-zA-Z0-9\-\.]*$
logpush_field_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
items:
type: object
nullable: true
properties:
key:
type: string
example: value
logpush_job_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
type: object
nullable: true
logpush_job_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
nullable: true
logs:
anyOf:
- type: string
- type: object
example: |-
{"ClientIP":"192.0.2.1","RayID":"41ddf1740f67442d","EdgeStartTimestamp":1526810289280000000}
{"ClientIP":"192.0.2.1","RayID":"41ddf1740f67442d","EdgeStartTimestamp":1526810289280000000}
{"ClientIP":"192.0.2.1","RayID":"41ddf1740f67442d","EdgeStartTimestamp":1526810289280000000}
longitude:
type: number
description: The longitude of the data center containing the origins used in
this pool in decimal degrees. If this is set, latitude must also be set.
mac_address:
type: string
description: The device mac address.
example: 00-00-5E-00-53-00
managed_headers_components-schemas-enabled:
type: boolean
description: When true, the Managed Transform is enabled.
example: true
managed_headers_components-schemas-id:
type: string
description: Human-readable identifier of the Managed Transform.
example: add_cf-bot-score_header
manufacturer:
type: string
description: The device manufacturer name.
example: My phone corp
match:
oneOf:
- type: object
properties:
headers:
type: array
items:
type: object
properties:
name:
$ref: '#/components/schemas/header_name'
op:
$ref: '#/components/schemas/header_op'
value:
$ref: '#/components/schemas/header_value'
request:
type: object
properties:
methods:
$ref: '#/components/schemas/methods'
schemes:
$ref: '#/components/schemas/schemes'
url:
$ref: '#/components/schemas/schemas-url'
response:
type: object
properties:
origin_traffic:
$ref: '#/components/schemas/origin_traffic'
type: object
description: Determines which traffic the rate limit counts towards the threshold.
match_item:
type: object
properties:
platform:
$ref: '#/components/schemas/platform'
matcher:
type: object
description: Matching pattern to forward your actions.
required:
- type
- field
- value
properties:
field:
type: string
description: Field for type matcher.
enum:
- to
example: to
type:
type: string
description: Type of matcher.
enum:
- literal
example: literal
value:
type: string
description: Value for matcher.
example: test@example.com
maxLength: 90
matchers:
type: array
description: Matching patterns to forward to your actions.
items:
$ref: '#/components/schemas/matcher'
max_age:
type: number
description: The maximum number of seconds the results of a preflight request
can be cached.
example: -1
minimum: -1
maximum: 86400
max_estimated_time_minutes:
type: integer
max_retries:
type: number
example: 3
max_rtt_ms:
type: number
description: Maximum RTT in ms.
max_ttl:
type: integer
description: Max TTL.
default: 15
minimum: 0
maximum: 64
max_upload:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: identifier of the zone setting.
enum:
- max_upload
example: max_upload
value:
$ref: '#/components/schemas/max_upload_value'
title: Max Upload
description: Maximum size of an allowable upload.
max_upload_value:
type: number
description: |-
Value of the zone setting.
Notes: The size depends on the plan level of the zone. (Enterprise = 500, Business = 200, Pro = 100, Free = 100)
enum:
- 100
- 200
- 500
default: 100
max_wait_time_ms:
type: number
example: 5000
maxDurationSeconds:
type: integer
description: The maximum duration in seconds for a video upload. Can be set
for a video that is not yet uploaded to limit its duration. Uploads that exceed
the specified duration will fail during processing. A value of `-1` means
the value is unknown.
maximum_cache_ttl:
type: number
description: Maximum DNS Cache TTL.
default: 900
example: 900
minimum: 30
maximum: 36000
mean_rtt_ms:
type: number
description: Mean RTT in ms.
mechanism:
type: string
description: The mechanism to which the notification has been dispatched.
example: test@example.com
mechanism_type:
type: string
description: The type of mechanism to which the notification has been dispatched.
This can be email/pagerduty/webhook based on the mechanism configured.
enum:
- email
- pagerduty
- webhook
example: email
mechanisms:
type: object
description: List of IDs that will be used when dispatching a notification.
IDs for email type will be the email address.
example:
email:
- id: test@example.com
pagerduty:
- id: e8133a15-00a4-4d69-aec1-32f70c51f6e5
webhooks:
- id: 14cc1190-5d2b-4b98-a696-c424cb2ad05f
media_metadata:
type: object
description: A user modifiable key-value store used to reference other systems
of record for managing videos.
example: {}
media_state:
type: string
description: Specifies the processing status of the video.
enum:
- pendingupload
- downloading
- queued
- inprogress
- ready
- error
example: inprogress
readOnly: true
media_status:
description: Specifies a detailed status for a video. If the `state` is `inprogress`
or `error`, the `step` field returns `encoding` or `manifest`. If the `state`
is `inprogress`, `pctComplete` returns a number between 0 and 100 to indicate
the approximate percent of completion. If the `state` is `error`, `errorReasonCode`
and `errorReasonText` provide additional details.
readOnly: true
properties:
errorReasonCode:
$ref: '#/components/schemas/errorReasonCode'
errorReasonText:
$ref: '#/components/schemas/errorReasonText'
pctComplete:
$ref: '#/components/schemas/pctComplete'
state:
$ref: '#/components/schemas/media_state'
member:
type: object
required:
- id
- user
- status
- roles
properties:
code:
$ref: '#/components/schemas/code'
id:
$ref: '#/components/schemas/membership_components-schemas-identifier'
roles:
type: array
description: Roles assigned to this member.
items:
$ref: '#/components/schemas/role'
status:
readOnly: true
user:
type: object
readOnly: true
required:
- email
properties:
email:
$ref: '#/components/schemas/email'
first_name:
$ref: '#/components/schemas/first_name'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
last_name:
$ref: '#/components/schemas/last_name'
two_factor_authentication_enabled:
$ref: '#/components/schemas/two_factor_authentication_enabled'
member_components-schemas-name:
type: string
description: Member Name.
example: John Smith
nullable: true
maxLength: 100
membership:
type: object
properties:
account:
$ref: '#/components/schemas/schemas-account'
api_access_enabled:
$ref: '#/components/schemas/api_access_enabled'
code:
$ref: '#/components/schemas/code'
id:
$ref: '#/components/schemas/membership_components-schemas-identifier'
permissions:
allOf:
- $ref: '#/components/schemas/permissions'
description: All access permissions for the user at the account.
readOnly: true
roles:
$ref: '#/components/schemas/roles'
status:
$ref: '#/components/schemas/schemas-status'
membership_components-schemas-identifier:
type: string
description: Membership identifier tag.
example: 4536bcfad5faccb111b47003c79917fa
readOnly: true
maxLength: 32
memberships:
type: array
description: Zones and Accounts which will be assigned IPs on this Address Map.
A zone membership will take priority over an account membership.
items:
$ref: '#/components/schemas/address-maps-membership'
messages:
type: array
example: []
items:
type: object
uniqueItems: true
required:
- code
- message
properties:
code:
type: integer
minimum: 1000
message:
type: string
metadata:
type: object
description: User modifiable key-value store. Can be used for keeping references
to another system of record for managing images. Metadata must not exceed
1024 bytes.
example:
key: value
method:
type: string
description: The HTTP method used to access the endpoint.
enum:
- GET
- POST
- HEAD
- OPTIONS
- PUT
- DELETE
- CONNECT
- PATCH
- TRACE
example: GET
methods:
type: array
description: The HTTP methods to match. You can specify a subset (for example,
`['POST','PUT']`) or all methods (`['_ALL_']`). This field is optional when
creating a rate limit.
example:
- GET
- POST
items:
type: string
description: An HTTP method or `_ALL_` to indicate all methods.
enum:
- GET
- POST
- PUT
- DELETE
- PATCH
- HEAD
- _ALL_
example: GET
min_rtt_ms:
type: number
description: Minimum RTT in ms.
min_tls_version:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- min_tls_version
example: min_tls_version
value:
$ref: '#/components/schemas/min_tls_version_value'
title: Zone Minimum TLS Version value
description: Only accepts HTTPS requests that use at least the TLS protocol
version specified. For example, if TLS 1.1 is selected, TLS 1.0 connections
will be rejected, while 1.1, 1.2, and 1.3 (if enabled) will be permitted.
default: "1.0"
min_tls_version_value:
type: string
description: Value of the zone setting.
enum:
- "1.0"
- "1.1"
- "1.2"
- "1.3"
default: "1.0"
minify:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Zone setting identifier.
enum:
- minify
example: minify
value:
$ref: '#/components/schemas/minify_value'
title: Auto-Minify Assets
description: Automatically minify certain assets for your website. Refer to
[Using Cloudflare Auto Minify](https://support.cloudflare.com/hc/en-us/articles/200168196)
for more information.
minify_value:
type: object
description: Value of the zone setting.
properties:
css:
description: Automatically minify all CSS files for your website.
enum:
- "on"
- "off"
default: "off"
html:
description: Automatically minify all HTML files for your website.
enum:
- "on"
- "off"
default: "off"
js:
description: Automatically minify all JavaScript files for your website.
enum:
- "on"
- "off"
default: "off"
minimum_cache_ttl:
type: number
description: Minimum DNS Cache TTL.
default: 60
example: 60
minimum: 30
maximum: 36000
minimum_origins:
type: integer
description: The minimum number of origins that must be healthy for this pool
to serve traffic. If the number of healthy origins falls below this number,
the pool will be marked unhealthy and will failover to the next available
pool.
default: 1
mirage:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- mirage
example: mirage
value:
$ref: '#/components/schemas/mirage_value'
title: Mirage Image Optimization
description: Automatically optimize image loading for website visitors on mobile
devices. Refer to [our blog post](http://blog.cloudflare.com/mirage2-solving-mobile-speed)
for more information.
mirage_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
miscategorization:
properties:
content_adds:
description: Content category IDs to add.
example:
- 82
content_removes:
description: Content category IDs to remove.
example:
- 155
indicator_type:
enum:
- domain
- ipv4
- ipv6
- url
example: domain
ip:
description: Provide only if indicator_type is `ipv4` or `ipv6`.
security_adds:
description: Security category IDs to add.
example:
- 117
- 131
security_removes:
description: Security category IDs to remove.
example:
- 83
url:
type: string
description: 'Provide only if indicator_type is `domain` or `url`. Example
if indicator_type is `domain`: `example.com`. Example if indicator_type
is `url`: `https://example.com/news/`.'
mnm_config:
type: object
required:
- name
- default_sampling
- router_ips
properties:
default_sampling:
$ref: '#/components/schemas/mnm_config_default_sampling'
name:
$ref: '#/components/schemas/mnm_config_name'
router_ips:
$ref: '#/components/schemas/mnm_config_router_ips'
mnm_config_default_sampling:
type: number
description: Fallback sampling rate of flow messages being sent in packets per
second. This should match the packet sampling rate configured on the router.
default: 1
minimum: 1
mnm_config_name:
type: string
description: The account name.
example: cloudflare user's account
mnm_config_router_ip:
type: string
description: IPv4 CIDR of the router sourcing flow data. Only /32 addresses
are currently supported.
example: 203.0.113.1/32
mnm_config_router_ips:
type: array
items:
$ref: '#/components/schemas/mnm_config_router_ip'
mnm_rule:
type: object
required:
- name
- prefixes
- automatic_advertisement
- duration
properties:
automatic_advertisement:
$ref: '#/components/schemas/mnm_rule_automatic_advertisement'
bandwidth_threshold:
$ref: '#/components/schemas/mnm_rule_bandwidth_threshold'
duration:
$ref: '#/components/schemas/mnm_rule_duration'
id:
$ref: '#/components/schemas/schemas-rule_identifier'
name:
$ref: '#/components/schemas/mnm_rule_name'
packet_threshold:
$ref: '#/components/schemas/mnm_rule_packet_threshold'
prefixes:
$ref: '#/components/schemas/mnm_rule_ip_prefixes'
mnm_rule_automatic_advertisement:
type: boolean
description: Toggle on if you would like Cloudflare to automatically advertise
the IP Prefixes within the rule via Magic Transit when the rule is triggered.
Only available for users of Magic Transit.
example: "false"
mnm_rule_bandwidth_threshold:
type: number
description: The number of bits per second for the rule. When this value is
exceeded for the set duration, an alert notification is sent. Minimum of 1
and no maximum.
example: 1000
minimum: 1
mnm_rule_duration:
type: string
description: The amount of time that the rule threshold must be exceeded to
send an alert notification. The minimum is 60 seconds and maximum is 21600
seconds. The format is XhYmZs where X, Y, and Z durations are optional; however
at least one unit must be provided.
default: 60s
example: 1h2m3s
mnm_rule_ip_prefix:
type: string
description: The IP prefixes that are monitored for this rule. Must be a CIDR
range like 203.0.113.0/24. Max 5000 different CIDR ranges.
example: 203.0.113.1/32
mnm_rule_ip_prefixes:
type: array
items:
$ref: '#/components/schemas/mnm_rule_ip_prefix'
mnm_rule_name:
type: string
description: The name of the rule. Must be unique. Supports characters A-Z,
a-z, 0-9, underscore (_), dash (-), period (.), and tilde (~). You can’t have
a space in the rule name. Max 256 characters.
example: my_rule_1
mnm_rule_packet_threshold:
type: number
description: The number of packets per second for the rule. When this value
is exceeded for the set duration, an alert notification is sent. Minimum of
1 and no maximum.
example: 10000
minimum: 1
mnm_rules:
type: array
items:
$ref: '#/components/schemas/mnm_rule'
mobile_redirect:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Identifier of the zone setting.
enum:
- mobile_redirect
example: mobile_redirect
value:
$ref: '#/components/schemas/mobile_redirect_value'
title: Mobile Redirect
description: Automatically redirect visitors on mobile devices to a mobile-optimized
subdomain. Refer to [Understanding Cloudflare Mobile Redirect](https://support.cloudflare.com/hc/articles/200168336)
for more information.
mobile_redirect_value:
type: object
description: Value of the zone setting.
properties:
mobile_subdomain:
type: string
description: Which subdomain prefix you wish to redirect visitors on mobile
devices to (subdomain must already exist).
example: m
nullable: true
minLength: 1
status:
description: Whether or not mobile redirect is enabled.
enum:
- "on"
- "off"
default: "off"
strip_uri:
type: boolean
description: Whether to drop the current page path and redirect to the mobile
subdomain URL root, or keep the path and redirect to the same page on
the mobile subdomain.
default: false
example: false
mode:
type: string
description: The action to perform.
enum:
- simulate
- ban
- challenge
- js_challenge
- managed_challenge
example: challenge
mode_allow_traditional:
type: string
description: When set to `on`, the current rule will be used when evaluating
the request. Applies to traditional (allow) WAF rules.
enum:
- "on"
- "off"
example: "on"
mode_anomaly:
type: string
description: When set to `on`, the current WAF rule will be used when evaluating
the request. Applies to anomaly detection WAF rules.
enum:
- "on"
- "off"
example: "on"
mode_deny_traditional:
type: string
description: The action that the current WAF rule will perform when triggered.
Applies to traditional (deny) WAF rules.
enum:
- default
- disable
- simulate
- block
- challenge
example: block
model:
type: string
description: The device model name.
example: MyPhone(pro-X)
modified:
type: string
format: date-time
description: The date and time the destination address was last modified.
example: "2014-01-02T02:20:00Z"
readOnly: true
modified_at_nullable:
type: string
format: date-time
description: Last time the advertisement status was changed. This field is only
not 'null' if on demand is enabled.
example: "2014-01-01T05:20:00.12345Z"
nullable: true
modified_on:
type: string
format: date-time
description: Last time the token was modified.
example: "2018-07-02T05:20:00Z"
readOnly: true
modified_rules_count:
type: number
description: The number of rules within the group that have been modified from
their default configuration.
default: 0
example: 2
readOnly: true
modified_tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_gre_tunnels:
type: array
items:
$ref: '#/components/schemas/gre-tunnel'
modify_request:
type: object
properties:
description:
$ref: '#/components/schemas/web3-hostname_components-schemas-description'
dnslink:
$ref: '#/components/schemas/dnslink'
monitor:
type: object
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
id:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
modified_on:
$ref: '#/components/schemas/timestamp'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
monitor_components-schemas-description:
type: string
description: Object description.
example: Login page monitor
monitor_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
monitor_components-schemas-identifier:
example: f1aba936b94213e5b8dca0c0dbf1f9cc
monitor_components-schemas-port:
type: integer
description: 'The port number to connect to for the health check. Required for
TCP, UDP, and SMTP checks. HTTP and HTTPS checks should only define the port
when using a non-standard port (HTTP: default 80, HTTPS: default 443).'
default: 0
monitor_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/monitor'
monitor_components-schemas-response_collection-2:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-monitor'
monitor_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/monitor'
monitor_components-schemas-single_response-2:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/components-schemas-monitor'
monitor_components-schemas-type:
type: string
description: The protocol to use for the health check. Currently supported protocols
are 'HTTP','HTTPS', 'TCP', 'ICMP-PING', 'UDP-ICMP', and 'SMTP'.
enum:
- http
- https
- tcp
- udp_icmp
- icmp_ping
- smtp
default: http
example: https
mtu:
type: integer
description: Maximum Transmission Unit (MTU) in bytes for the GRE tunnel. The
minimum value is 576.
default: 1476
multiple_route_modified_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_routes:
type: array
items:
$ref: '#/components/schemas/schemas-route'
name:
type: string
description: Token name.
example: readonly token
maxLength: 120
name_servers:
type: array
description: List of name servers.
example:
- preston.ns.cloudflare.com
- oli.ns.cloudflare.com
items:
type: string
namespace:
type: object
required:
- id
- title
properties:
id:
$ref: '#/components/schemas/namespace_identifier'
supports_url_encoding:
type: boolean
description: True if keys written on the URL will be URL-decoded before
storing. For example, if set to "true", a key written on the URL as "%3F"
will be stored as "?".
example: true
readOnly: true
title:
$ref: '#/components/schemas/namespace_title'
namespace_identifier:
type: string
description: Namespace identifier tag.
example: 0f2ac74b498b48028cb68387c421e279
readOnly: true
maxLength: 32
namespace_title:
type: string
description: A human-readable string name for a Namespace.
example: My Own Namespace
namespaces_components-schemas-id:
type: string
description: ID of the namespace.
example: 5fd1cafff895419c8bcc647fc64ab8f0
negative_cache_ttl:
type: number
description: Negative DNS Cache TTL.
example: 900
nullable: true
minimum: 30
maximum: 36000
nel:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Zone setting identifier.
enum:
- nel
example: nel
value:
$ref: '#/components/schemas/nel_value'
title: Network Error Logging
description: 'Enable Network Error Logging reporting on your zone. (Beta) '
nel_value:
type: object
description: Value of the zone setting.
properties:
enabled:
type: boolean
default: false
example: false
network:
type: array
description: A list of network ranges that requests from this location would
originate from.
items:
type: string
description: The IPv4 address or IPv4 CIDR. IPv4 CIDRs are limited to a maximum
of /24.
example: 192.0.2.1/32
neverRequireSignedURLs:
type: boolean
description: Indicates whether the variant can access an image without a signature,
regardless of image access control.
default: false
example: true
new-project-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
new_custom_entry:
type: object
title: Custom entry
description: A custom entry create payload
required:
- name
- enabled
- pattern
properties:
enabled:
type: boolean
description: Whether the entry is enabled or not.
example: true
name:
type: string
description: The name of the entry.
example: Credit card (Visa)
pattern:
$ref: '#/components/schemas/components-schemas-pattern'
new_custom_profile:
type: object
properties:
description:
type: string
description: The description of the profile.
example: A standard CVV card number
entries:
type: array
description: The entries for this profile.
items:
$ref: '#/components/schemas/new_custom_entry'
name:
type: string
description: The name of the profile.
example: Generic CVV Card Number
new_users_per_minute:
type: integer
description: Sets the number of new users that will be let into the route every
minute. This value is used as baseline for the number of users that are let
in per minute. So it is possible that there is a little more or little less
traffic coming to the route based on the traffic patterns at that time around
the world.
minimum: 200
maximum: 2.147483647e+09
next_event_prequeue_start_time:
type: string
description: An ISO 8601 timestamp that marks when the next event will begin
queueing.
example: "2021-09-28T15:00:00.000Z"
nullable: true
next_event_start_time:
type: string
description: An ISO 8601 timestamp that marks when the next event will start.
example: "2021-09-28T15:00:00.000Z"
nullable: true
nexthop:
type: string
description: The next-hop IP Address for the static route.
example: 203.0.113.1
nft:
type: object
readOnly: true
properties:
contract:
type: string
description: The ERC-721 compatible contract address.
example: 0x57f1887a8bf19b14fc0d912b9b2acc9af147ea85
readOnly: true
minLength: 42
maxLength: 42
token:
type: integer
description: The token ID for the NFT.
readOnly: true
node_result:
type: object
example:
asn: AS13335
ip: 1.1.1.1
max_latency_ms: 0.034
mean_latency_ms: 0.021
min_latency_ms: 0.014
name: one.one.one.one
packet_count: 3
std_dev_latency_ms: 0.011269427669584647
properties:
asn:
$ref: '#/components/schemas/schemas-asn'
ip:
$ref: '#/components/schemas/traceroute_components-schemas-ip'
labels:
$ref: '#/components/schemas/labels'
max_rtt_ms:
$ref: '#/components/schemas/max_rtt_ms'
mean_rtt_ms:
$ref: '#/components/schemas/mean_rtt_ms'
min_rtt_ms:
$ref: '#/components/schemas/min_rtt_ms'
name:
$ref: '#/components/schemas/traceroute_components-schemas-name'
packet_count:
$ref: '#/components/schemas/packet_count'
std_dev_rtt_ms:
$ref: '#/components/schemas/std_dev_rtt_ms'
not_before:
type: string
format: date-time
description: The time before which the token MUST NOT be accepted for processing.
example: "2018-07-01T05:20:00Z"
notes:
type: string
description: An informative summary of the rule, typically used as a reminder
or explanation.
example: This rule is enabled because of an event that occurred on date X.
notification_email:
type: string
description: The email address to send health status notifications to. This
can be an individual mailbox or a mailing list. Multiple emails can be supplied
as a comma delimited list.
example: someone@example.com,sometwo@example.com
notification_filter:
type: object
description: Filter pool and origin health notifications by resource type or
health status. Use null to reset.
example:
origin:
disable: true
pool:
healthy: false
nullable: true
properties:
origin:
$ref: '#/components/schemas/filter_options'
pool:
$ref: '#/components/schemas/filter_options'
notificationUrl:
type: string
format: uri
description: The URL where webhooks will be sent.
example: https://example.com
ns_name:
type: string
format: hostname
description: The FQDN of the name server.
example: ns1.example.com
num_items:
type: number
description: The number of items in the list.
example: 10
num_referencing_filters:
type: number
description: The number of [filters](#filters) referencing the list.
example: 2
object:
type: object
properties:
hasStoredData:
type: boolean
description: Whether the Durable Object has stored data.
example: true
readOnly: true
id:
type: string
description: ID of the Durable Object.
example: fe7803fc55b964e09d94666545aab688d360c6bda69ba349ced1e5f28d2fc2c8
readOnly: true
occurred_at:
type: string
format: date-time
description: When the billing item was created.
example: "2014-03-01T12:21:59.3456Z"
readOnly: true
okta_group_rule:
type: object
title: Okta group
description: |-
Matches an Okta group.
Requires an Okta identity provider.
required:
- okta
properties:
okta:
type: object
required:
- email
- connection_id
properties:
connection_id:
type: string
description: The ID of your Okta identity provider.
example: ea85612a-29c8-46c2-bacb-669d65136971
email:
type: string
description: The email of the Okta group.
example: devs@cloudflare.com
on_demand_enabled:
type: boolean
description: Whether advertisement of the prefix to the Internet may be dynamically
enabled or disabled.
example: true
on_demand_locked:
type: boolean
description: Whether advertisement status of the prefix is locked, meaning it
cannot be changed.
example: false
oneTimeUploadExpiry:
type: string
format: date-time
description: The date and time when the video upload URL is no longer valid
for direct user uploads.
example: "2014-01-02T02:20:00Z"
opacity:
type: number
description: The translucency of the image. A value of `0.0` makes the image
completely transparent, and `1.0` makes the image completely opaque. Note
that if the image is already semi-transparent, setting this to `1.0` will
not make the image completely opaque.
default: 1
example: 0.75
readOnly: true
minimum: 0
maximum: 1
openapi:
type: object
description: A OpenAPI 3.0.0 compliant schema.
example:
info:
title: OpenAPI JSON schema for www.example.com
version: "1.0"
openapi: 3.0.0
paths:
'... Further paths ...': {}
/api/v1/users/{var1}:
get:
parameters:
- in: path
name: var1
required: true
schema:
type: string
servers:
- url: www.example.com
openapiwiththresholds:
type: object
description: A OpenAPI 3.0.0 compliant schema.
example:
info:
title: OpenAPI JSON schema for www.example.com
version: "1.0"
openapi: 3.0.0
paths:
'... Further paths ...': {}
/api/v1/users/{var1}:
get:
parameters:
- in: path
name: var1
required: true
schema:
type: string
servers:
- url: www.example.com
operation:
type: object
required:
- operation_id
- method
- host
- endpoint
- last_updated
properties:
endpoint:
$ref: '#/components/schemas/endpoint'
features:
$ref: '#/components/schemas/features'
host:
$ref: '#/components/schemas/host'
last_updated:
$ref: '#/components/schemas/timestamp'
method:
$ref: '#/components/schemas/method'
operation_id:
$ref: '#/components/schemas/operation_id'
operation_id:
description: The ID that identifies the API operation.
opportunistic_encryption:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- opportunistic_encryption
example: opportunistic_encryption
value:
$ref: '#/components/schemas/opportunistic_encryption_value'
title: Enable Opportunistic Encryption for a zone
description: Enables the Opportunistic Encryption feature for a zone.
opportunistic_encryption_value:
type: string
description: |-
Value of the zone setting.
Notes: Default value depends on the zone's plan level.
enum:
- "on"
- "off"
default: "on"
opportunistic_onion:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- opportunistic_onion
example: opportunistic_onion
value:
$ref: '#/components/schemas/opportunistic_onion_value'
title: Zone Enable Onion Routing
description: Add an Alt-Svc header to all legitimate requests from Tor, allowing
the connection to use our onion services instead of exit nodes.
default: "off"
opportunistic_onion_value:
type: string
description: |-
Value of the zone setting.
Notes: Default value depends on the zone's plan level.
enum:
- "on"
- "off"
default: "off"
options:
type: object
description: Allows you to define image resizing sizes for different use cases.
required:
- fit
- metadata
- width
- height
properties:
fit:
$ref: '#/components/schemas/fit'
height:
$ref: '#/components/schemas/schemas-height'
metadata:
$ref: '#/components/schemas/schemas-metadata'
width:
$ref: '#/components/schemas/schemas-width'
orange_to_orange:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- orange_to_orange
example: orange_to_orange
value:
$ref: '#/components/schemas/orange_to_orange_value'
title: Orange to Orange
description: Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other
zones also on Cloudflare.
orange_to_orange_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
organization:
type: object
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
$ref: '#/components/schemas/schemas-name'
permissions:
$ref: '#/components/schemas/schemas-permissions'
roles:
type: array
description: List of roles that a user has within an organization.
readOnly: true
items:
type: string
example: All Privileges - Super Administrator
maxLength: 120
status:
$ref: '#/components/schemas/components-schemas-status'
organization_components-schemas-identifier:
type: string
description: Organization identifier tag.
example: 01a7362d577a6c3019a474fd6f485823
readOnly: true
maxLength: 32
organization_invite:
allOf:
- $ref: '#/components/schemas/base'
- properties:
organization_is_enforcing_twofactor:
type: boolean
description: Current status of two-factor enforcement on the organization.
default: false
example: true
status:
type: string
description: Current status of the invitation.
enum:
- pending
- accepted
- rejected
- canceled
- left
- expired
example: accepted
organizations:
type: object
properties:
auth_domain:
$ref: '#/components/schemas/auth_domain'
created_at:
$ref: '#/components/schemas/timestamp'
is_ui_read_only:
$ref: '#/components/schemas/is_ui_read_only'
login_design:
$ref: '#/components/schemas/login_design'
name:
$ref: '#/components/schemas/organizations_components-schemas-name'
updated_at:
$ref: '#/components/schemas/timestamp'
organizations_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
organizations_components-schemas-name:
type: string
description: The name of your Zero Trust organization.
example: Widget Corps Internal Applications
organizations_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/organizations'
origin:
type: string
description: Your origin hostname that requests to your custom hostnames will
be sent to.
example: fallback.example.com
maxLength: 255
origin_components-schemas-enabled:
type: boolean
description: Whether to enable (the default) this origin within the pool. Disabled
origins will not receive traffic and are excluded from health checks. The
origin will only be disabled for the current pool.
default: true
example: true
origin_components-schemas-name:
type: string
description: A human-identifiable name for the origin.
example: app-server-1
origin_dns:
type: object
description: The name and type of DNS record for the Spectrum application.
properties:
name:
$ref: '#/components/schemas/origin_dns_name'
ttl:
$ref: '#/components/schemas/dns_ttl'
type:
$ref: '#/components/schemas/origin_dns_type'
origin_dns_name:
type: string
format: hostname
description: The name of the DNS record associated with the origin.
example: origin.example.com
origin_dns_type:
type: string
description: The type of DNS record associated with the origin. "" is used to
specify a combination of A/AAAA records.
enum:
- ""
- A
- AAAA
- SRV
example: ""
origin_error_page_pass_thru:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- origin_error_page_pass_thru
example: origin_error_page_pass_thru
value:
$ref: '#/components/schemas/origin_error_page_pass_thru_value'
title: Error Pages On
description: Cloudflare will proxy customer error pages on any 502,504 errors
on origin server instead of showing a default Cloudflare error page. This
does not apply to 522 errors and is limited to Enterprise Zones.
default: "off"
origin_error_page_pass_thru_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
origin_ips:
type: array
example:
- 192.0.2.1
- 198.51.100.1
- 2001:DB8:100::CF
items:
anyOf:
- type: string
format: ipv4
description: Origin DNS Server IPv4 Address.
example: 192.0.2.1
- type: string
format: ipv6
description: Origin DNS Server IPv6 Address.
example: 2001:DB8:100::CF
origin_max_http_version:
allOf:
- required:
- id
properties:
id:
description: Identifier of the zone setting.
enum:
- origin_max_http_version
example: origin_max_http_version
modified_on:
type: string
format: date-time
description: last time this setting was modified.
example: "2014-01-01T05:20:00.12345Z"
nullable: true
readOnly: true
title: Origin Max HTTP version
description: The highest HTTP version Cloudflare will attempt to use with your
origin. This setting allows Cloudflare to make HTTP/2 requests to your origin.
(Refer to [Enable HTTP/2 to Origin](https://developers.cloudflare.com/cache/how-to/enable-http2-to-origin/),
for more information.).
origin_max_http_version_response_value:
properties:
result:
allOf:
- $ref: '#/components/schemas/origin_max_http_version'
- required:
- value
properties:
value:
$ref: '#/components/schemas/origin_max_http_version_value'
origin_max_http_version_value:
type: string
description: Value of the Origin Max HTTP version setting (Note that the default
value for Enterprise is "1").
enum:
- "1"
- "2"
default: "2"
origin_port:
anyOf:
- type: integer
- type: string
description: |-
The destination port at the origin. Only specified in conjunction with origin_dns. May use an integer to specify a single origin port, for example `1000`, or a string to specify a range of origin ports, for example `"1000-2000"`.
Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the "protocol" field.
example: 22
minimum: 1
maximum: 65535
origin_steering:
type: object
description: Configures origin steering for the pool. Controls how origins are
selected for new sessions and traffic without session affinity.
properties:
policy:
type: string
description: The type of origin steering policy to use, either "random"
or "hash" (based on CF-Connecting-IP).
enum:
- random
- hash
default: random
origin_traffic:
type: boolean
description: |-
When true, only the uncached traffic served from your origin servers will count towards rate limiting. In this case, any cached traffic served by Cloudflare will not count towards rate limiting. This field is optional.
Notes: This field is deprecated. Instead, use response headers and set "origin_traffic" to "false" to avoid legacy behaviour interacting with the "response_headers" property.
original_url:
type: string
format: uri
description: URI to original variant for an image.
example: https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/original
readOnly: true
origins:
type: array
description: The list of origins within this pool. Traffic directed at this
pool is balanced across all currently healthy origins, provided the pool itself
is healthy.
items:
$ref: '#/components/schemas/schemas-origin'
os_distro_name:
type: string
description: The Linux distro name.
example: ubuntu
os_distro_revision:
type: string
description: The Linux distro revision.
example: 1.0.0
os_version:
type: string
description: The operating system version.
example: 10.0.0
output:
properties:
enabled:
$ref: '#/components/schemas/output_enabled'
streamKey:
$ref: '#/components/schemas/output_streamKey'
uid:
$ref: '#/components/schemas/output_identifier'
url:
$ref: '#/components/schemas/output_url'
output_enabled:
type: boolean
description: When enabled, live video streamed to the associated live input
will be sent to the output URL. When disabled, live video will not be sent
to the output URL, even when streaming to the associated live input. Use this
to control precisely when you start and stop simulcasting to specific destinations
like YouTube and Twitch.
default: true
example: true
output_identifier:
type: string
description: A unique identifier for the output.
example: baea4d9c515887b80289d5c33cf01145
readOnly: true
maxLength: 32
output_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/output'
output_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/output'
output_streamKey:
type: string
description: The streamKey used to authenticate against an output's target.
example: uzya-f19y-g2g9-a2ee-51j2
readOnly: true
output_url:
type: string
description: The URL an output uses to restream.
example: rtmp://a.rtmp.youtube.com/live2
readOnly: true
override:
properties:
description:
$ref: '#/components/schemas/overrides_components-schemas-description'
groups:
$ref: '#/components/schemas/groups'
id:
$ref: '#/components/schemas/overrides_components-schemas-id'
paused:
$ref: '#/components/schemas/schemas-paused'
priority:
$ref: '#/components/schemas/overrides_components-schemas-priority'
rewrite_action:
$ref: '#/components/schemas/rewrite_action'
rules:
$ref: '#/components/schemas/schemas-rules'
urls:
$ref: '#/components/schemas/urls'
override_codes_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: object
properties:
disable_for_time:
$ref: '#/components/schemas/disable_for_time'
override_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- result
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/override'
- type: object
required:
- id
- paused
- urls
- priority
override_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
$ref: '#/components/schemas/override'
overrides_components-schemas-description:
type: string
description: An informative summary of the current URI-based WAF override.
example: Enable Cloudflare Magento ruleset for shop.example.com
nullable: true
maxLength: 1024
overrides_components-schemas-id:
type: string
description: The unique identifier of the WAF override.
example: de677e5818985db1285d0e80225f06e5
readOnly: true
maxLength: 32
overrides_components-schemas-priority:
type: number
description: The relative priority of the current URI-based WAF override when
multiple overrides match a single URL. A lower number indicates higher priority.
Higher priority overrides may overwrite values set by lower priority overrides.
example: 1
minimum: -1e+09
maximum: 1e+09
ownership_challenge:
type: string
description: Ownership challenge token to prove destination ownership.
example: "00000000000000000000"
maxLength: 4096
pattern: ^[a-zA-Z0-9/\+\.\-_]*$
ownership_verification:
oneOf:
- type: object
properties:
name:
type: string
description: DNS Name for record.
example: _cf-custom-hostname.app.example.com
type:
description: DNS Record type.
enum:
- txt
example: txt
value:
type: string
description: Content for the record.
example: 5cc07c04-ea62-4a5a-95f0-419334a875a4
type: object
description: This is a record which can be placed to activate a hostname.
ownership_verification_http:
oneOf:
- type: object
properties:
http_body:
type: string
description: Token to be served.
example: 5cc07c04-ea62-4a5a-95f0-419334a875a4
http_url:
type: string
description: The HTTP URL that will be checked during custom hostname
verification and where the customer should host the token.
example: http://custom.test.com/.well-known/cf-custom-hostname-challenge/0d89c70d-ad9f-4843-b99f-6cc0252067e9
type: object
description: This presents the token to be served by the given http url to activate
a hostname.
p50:
type: integer
description: The p50 quantile of requests (in period_seconds).
readOnly: true
p90:
type: integer
description: The p90 quantile of requests (in period_seconds).
readOnly: true
p99:
type: integer
description: The p99 quantile of requests (in period_seconds).
readOnly: true
package:
oneOf:
- $ref: '#/components/schemas/package_definition'
- $ref: '#/components/schemas/anomaly_package'
type: object
package_components-schemas-description:
type: string
description: A summary of the purpose/function of the WAF package.
example: "null"
readOnly: true
package_components-schemas-identifier:
type: string
description: The unique identifier of a WAF package.
example: a25a9a7e9c00afc1fb2e0245519d725b
readOnly: true
maxLength: 32
package_components-schemas-name:
type: string
description: The name of the WAF package.
example: USER
readOnly: true
package_components-schemas-status:
type: string
description: When set to `active`, indicates that the WAF package will be applied
to the zone.
enum:
- active
default: active
readOnly: true
package_definition:
title: Traditional WAF package
required:
- id
- name
- description
- detection_mode
- zone_id
properties:
description:
$ref: '#/components/schemas/package_components-schemas-description'
detection_mode:
$ref: '#/components/schemas/detection_mode'
id:
$ref: '#/components/schemas/package_components-schemas-identifier'
name:
$ref: '#/components/schemas/package_components-schemas-name'
status:
$ref: '#/components/schemas/package_components-schemas-status'
zone_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
package_response_collection:
anyOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/package'
package_response_single:
oneOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
packet_count:
type: integer
description: Number of packets with a response from this node.
packet_type:
type: string
description: Type of packet sent.
enum:
- icmp
- tcp
- udp
- gre
- gre+icmp
default: icmp
example: icmp
packets_lost:
type: integer
description: Number of packets where no response was received.
packets_per_ttl:
type: integer
description: Number of packets sent at each TTL.
default: 3
minimum: 0
maximum: 10
packets_sent:
type: integer
description: Number of packets sent with specified TTL.
packets_ttl:
type: integer
description: The time to live (TTL).
padding:
type: number
description: The whitespace between the adjacent edges (determined by position)
of the video and the image. `0.0` indicates no padding, and `1.0` indicates
a fully padded video width or length, as determined by the algorithm.
default: 0.05
example: 0.1
readOnly: true
minimum: 0
maximum: 1
page:
type: number
description: Current page within paginated list of results.
example: 1
page-rule:
type: object
required:
- id
- targets
- actions
- priority
- status
- modified_on
- created_on
properties:
actions:
$ref: '#/components/schemas/schemas-actions'
created_on:
$ref: '#/components/schemas/created_on'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/page-rule_components-schemas-modified_on'
priority:
$ref: '#/components/schemas/page-rule_components-schemas-priority'
status:
$ref: '#/components/schemas/page-rule_components-schemas-status'
targets:
$ref: '#/components/schemas/targets'
page-rule_components-schemas-modified_on:
type: string
format: date-time
description: The timestamp of when the Page Rule was last modified.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
page-rule_components-schemas-priority:
type: integer
description: 'The priority of the rule, used to define which Page Rule is processed
over another. A higher number indicates a higher priority. For example, if
you have a catch-all Page Rule (rule A: `/images/*`) but want a more specific
Page Rule to take precedence (rule B: `/images/special/*`), specify a higher
priority for rule B so it overrides rule A.'
default: 1
page-rule_components-schemas-status:
type: string
description: The status of the Page Rule.
enum:
- active
- disabled
default: disabled
example: active
pagerduty:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
name:
$ref: '#/components/schemas/pagerduty_components-schemas-name'
pagerduty_components-schemas-name:
type: string
description: The name of the pagerduty service.
example: My PagerDuty Service
pagerduty_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/pagerduty'
pagerule_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/page-rule'
pagerule_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
pagerule_settings_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
$ref: '#/components/schemas/settings'
pageviews:
type: object
description: Breakdown of totals for pageviews.
properties:
all:
type: integer
description: The total number of pageviews served within the time range.
search_engine:
type: object
description: A variable list of key/value pairs representing the search
engine and number of hits.
example:
baidubot: 1345
bingbot: 5372
googlebot: 35272
pingdom: 13435
passive-dns-by-ip:
properties:
count:
type: number
description: Total results returned based on your search parameters.
example: 1
page:
type: number
description: Current page within paginated list of results.
example: 1
per_page:
type: number
description: Number of results per page of results.
example: 20
reverse_records:
type: array
description: Reverse DNS look-ups observed during the time period.
items:
type: object
properties:
first_seen:
type: string
format: date
description: First seen date of the DNS record during the time period.
example: "2021-04-01"
hostname:
description: Hostname that the IP was observed resolving to.
last_seen:
type: string
format: date
description: Last seen date of the DNS record during the time period.
example: "2021-04-30"
passive-dns-by-ip_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/passive-dns-by-ip'
patch:
type: object
description: Update enablement of Argo Smart Routing
required:
- value
properties:
value:
$ref: '#/components/schemas/schemas-value'
patch_pools_notification_email:
type: string
description: The email address to send health status notifications to. This
field is now deprecated in favor of Cloudflare Notifications for Load Balancing,
so only resetting this field with an empty string `""` is accepted.
enum:
- '""'
example: ""
patch_rule:
required:
- action
- expression
properties:
action:
$ref: '#/components/schemas/rule_action'
description:
$ref: '#/components/schemas/rule_description'
enabled:
$ref: '#/components/schemas/rule_enabled'
expression:
$ref: '#/components/schemas/rule_expression'
position:
$ref: '#/components/schemas/rule_position'
path:
type: string
description: The endpoint path you want to conduct a health check against. This
parameter is only valid for HTTP and HTTPS monitors.
default: /
example: /health
pattern:
type: string
title: Route pattern
example: example.net/*
paused:
type: boolean
description: Indicates whether the zone is only using Cloudflare DNS services.
A true value means the zone will not receive security or performance benefits.
default: false
readOnly: true
pcaps_byte_limit:
type: number
description: The maximum number of bytes to capture. This field only applies
to `full` packet captures.
example: 500000
minimum: 1
maximum: 1e+09
pcaps_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
anyOf:
- $ref: '#/components/schemas/pcaps_response_simple'
- $ref: '#/components/schemas/pcaps_response_full'
pcaps_colo_name:
type: string
description: The name of the data center used for the packet capture. This can
be a specific colo (ord02) or a multi-colo name (ORD). This field only applies
to `full` packet captures.
example: ord02
pcaps_destination_conf:
type: string
description: The full URI for the bucket. This field only applies to `full`
packet captures.
example: s3://pcaps-bucket?region=us-east-1
pcaps_error_message:
type: string
description: An error message that describes why the packet capture failed.
This field only applies to `full` packet captures.
example: No packets matched the filter in the time limit given. Please modify
the filter or try again.
pcaps_filter_v1:
type: object
description: The packet capture filter. When this field is empty, all packets
are captured.
properties:
destination_address:
type: string
description: The destination IP address of the packet.
example: 1.2.3.4
destination_port:
type: number
description: The destination port of the packet.
example: 80
protocol:
type: number
description: The protocol number of the packet.
example: 6
source_address:
type: string
description: The source IP address of the packet.
example: 1.2.3.4
source_port:
type: number
description: The source port of the packet.
example: 123
pcaps_id:
type: string
description: The ID for the packet capture.
example: 66802ca5668e47a2b82c2e6746e45037
minLength: 32
maxLength: 32
pcaps_ownership_challenge:
type: string
description: The ownership challenge filename stored in the bucket.
example: ownership-challenge-9883874ecac311ec8475433579a6bf5f.txt
pcaps_ownership_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
nullable: true
items:
$ref: '#/components/schemas/pcaps_ownership_response'
pcaps_ownership_request:
type: object
required:
- destination_conf
properties:
destination_conf:
$ref: '#/components/schemas/pcaps_destination_conf'
pcaps_ownership_response:
type: object
required:
- id
- status
- submitted
- destination_conf
- filename
properties:
destination_conf:
$ref: '#/components/schemas/pcaps_destination_conf'
filename:
$ref: '#/components/schemas/pcaps_ownership_challenge'
id:
type: string
description: The bucket ID associated with the packet captures API.
example: 9883874ecac311ec8475433579a6bf5f
minLength: 32
maxLength: 32
status:
type: string
description: The status of the ownership challenge. Can be pending, success
or failed.
enum:
- pending
- success
- failed
example: success
submitted:
type: string
description: The RFC 3339 timestamp when the bucket was added to packet
captures API.
example: "2020-01-01T08:00:00Z"
validated:
type: string
description: The RFC 3339 timestamp when the bucket was validated.
example: "2020-01-01T08:00:00Z"
pcaps_ownership_single_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/pcaps_ownership_response'
pcaps_ownership_validate_request:
type: object
required:
- destination_conf
- ownership_challenge
properties:
destination_conf:
$ref: '#/components/schemas/pcaps_destination_conf'
ownership_challenge:
$ref: '#/components/schemas/pcaps_ownership_challenge'
pcaps_packet_limit:
type: number
description: The limit of packets contained in a packet capture.
example: 10000
minimum: 1
maximum: 10000
pcaps_request_full:
type: object
required:
- time_limit
- type
- system
- colo_name
- destination_conf
properties:
byte_limit:
$ref: '#/components/schemas/pcaps_byte_limit'
colo_name:
$ref: '#/components/schemas/pcaps_colo_name'
destination_conf:
$ref: '#/components/schemas/pcaps_destination_conf'
filter_v1:
$ref: '#/components/schemas/pcaps_filter_v1'
packet_limit:
$ref: '#/components/schemas/pcaps_packet_limit'
system:
$ref: '#/components/schemas/pcaps_system'
time_limit:
$ref: '#/components/schemas/pcaps_time_limit'
type:
$ref: '#/components/schemas/pcaps_type'
pcaps_request_pcap:
anyOf:
- $ref: '#/components/schemas/pcaps_request_simple'
- $ref: '#/components/schemas/pcaps_request_full'
pcaps_request_simple:
type: object
required:
- time_limit
- packet_limit
- type
- system
properties:
filter_v1:
$ref: '#/components/schemas/pcaps_filter_v1'
packet_limit:
$ref: '#/components/schemas/pcaps_packet_limit'
system:
$ref: '#/components/schemas/pcaps_system'
time_limit:
$ref: '#/components/schemas/pcaps_time_limit'
type:
$ref: '#/components/schemas/pcaps_type'
pcaps_response_full:
type: object
properties:
byte_limit:
$ref: '#/components/schemas/pcaps_byte_limit'
colo_name:
$ref: '#/components/schemas/pcaps_colo_name'
destination_conf:
$ref: '#/components/schemas/pcaps_destination_conf'
error_message:
$ref: '#/components/schemas/pcaps_error_message'
filter_v1:
$ref: '#/components/schemas/pcaps_filter_v1'
id:
$ref: '#/components/schemas/pcaps_id'
status:
$ref: '#/components/schemas/pcaps_status'
submitted:
$ref: '#/components/schemas/pcaps_submitted'
system:
$ref: '#/components/schemas/pcaps_system'
time_limit:
$ref: '#/components/schemas/pcaps_time_limit'
type:
$ref: '#/components/schemas/pcaps_type'
pcaps_response_simple:
type: object
properties:
filter_v1:
$ref: '#/components/schemas/pcaps_filter_v1'
id:
$ref: '#/components/schemas/pcaps_id'
status:
$ref: '#/components/schemas/pcaps_status'
submitted:
$ref: '#/components/schemas/pcaps_submitted'
system:
$ref: '#/components/schemas/pcaps_system'
time_limit:
$ref: '#/components/schemas/pcaps_time_limit'
type:
$ref: '#/components/schemas/pcaps_type'
pcaps_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
anyOf:
- $ref: '#/components/schemas/pcaps_response_simple'
- $ref: '#/components/schemas/pcaps_response_full'
pcaps_status:
type: string
description: The status of the packet capture request.
enum:
- unknown
- success
- pending
- running
- conversion_pending
- conversion_running
- complete
- failed
example: success
pcaps_submitted:
type: string
description: The RFC 3339 timestamp when the packet capture was created.
example: "2020-01-01T08:00:00Z"
pcaps_system:
type: string
description: The system used to collect packet captures.
enum:
- magic-transit
example: magic-transit
pcaps_time_limit:
type: number
description: The packet capture duration in seconds.
example: 300
minimum: 1
maximum: 300
pcaps_type:
type: string
description: The type of packet capture. `Simple` captures sampled packets,
and `full` captures entire payloads and non-sampled packets.
enum:
- simple
- full
example: simple
pctComplete:
type: string
description: Indicates the size of the entire upload in bytes. The value must
be a non-negative integer.
readOnly: true
minimum: 0
maximum: 100
peer:
type: object
required:
- id
- name
properties:
id:
$ref: '#/components/schemas/peer_components-schemas-identifier'
ip:
$ref: '#/components/schemas/ip'
ixfr_enable:
$ref: '#/components/schemas/ixfr_enable'
name:
$ref: '#/components/schemas/peer_components-schemas-name'
port:
$ref: '#/components/schemas/port'
tsig_id:
$ref: '#/components/schemas/tsig_id'
peer_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/peer_components-schemas-identifier'
peer_components-schemas-identifier:
example: 23ff594956f20c2a721606e94745a8aa
peer_components-schemas-name:
type: string
description: The name of the peer.
example: my-peer-1
peer_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/peer'
peer_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/peer'
peers:
type: array
description: A list of peer tags.
example:
- 23ff594956f20c2a721606e94745a8aa
- 00920f38ce07c2e2f4df50b1f61d4194
items: {}
pem:
type: string
description: The signing key in PEM format.
example: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFcGdJQkFBS0NBUUVBMFRqd2pPaVpXbUo0M3ZmM1RvNERvWG1YV3RKR05HeVhmaHl0dExhQmdGMStFUVdRCkRLaG9LYm9hS21xakNBc21za3V0YkxVN1BVOGRrUU5ER1p3S3VWczA4elNaNGt4aTR0RWdQUFp5dDdkWEMrbFkKUllveXJBR0Y0QVhoeTMyOWJIQ1AxSWxyQkIvQWtHZ25kTEFndW54WTByUmdjdk96aWF3NktKeEZuYzJVSzBXVQo4YjBwNEtLSEdwMUtMOWRrMFdUOGRWWXFiZVJpSmpDbFVFbWg4eXY5Q2xPVmFTNEt4aVg2eFRRNERadzZEYUpmCklWM1F0Tmd2cG1ieWxOSmFQSG5zc3JodDJHS1A5NjJlS2poUVJsaWd2SFhKTE9uSm9KZkxlSUVIWitpeFdmY1QKRE1IOTJzR3ZvdzFET2p4TGlDTjF6SEsraDdiTG9YVGlMZ2M0a3dJREFRQUJBb0lCQVFEQ0lCclNJMTlteGNkdwoycExVaUdCR0N4T3NhVDVLbGhkYUpESG9ZdzUxbEVuTWNXVGUyY01NTkdqaXdsN1NyOFlQMkxmcERaOFJtNzdMCk5rT2tGMnk3M3l5YUhFeEw5S1FyMys0Um9ubCtqTlp2YnV0QVdxSDVodEE0dER4MUd3NE85OEg4YWlTcGh1eWQKRUliTGRrQm54OGlDZUdxbFBnbHZ6Q1dLV0xVZlhGbXplMkF5UjBzaWMyYXZRLzZyclYwb3pDdGQ1T0Vod093agphaCs3N1dZV1l0bkEraDhXZVZreWcvdG44UTJJOXo5ZVJYdlZxR2sxMDZLcWRtZFdiU2tIZzA4cFRUSGhVM2paCnMvZGNjdEdOMWFFanlUQWY0QzdHT2lrcUd1MGFTaW1aeDFOM2RWQzBobngySjJtdlhNQ0VtZ0g3TjVnZUxWUFAKOWdkQjdBQkJBb0dCQU5sT2hGQVhaTHV6Y0Ftczl1K3AxM05STWRFOHpIK2ZFaFBrbk9zZ21Xb3VqUzkxQTRtZgpuK01oN3d5bTZoVU1DbDk2WUNMNGtPM0RUMmlYWlRqTXZuMHBoVEx1MXNYcGxWNDJuamRnZGd3cFBEM0FnL1Y5ClVvV2hxdVhoa1I3RFpsUGg5Nmk1aEE0M1BvbTVPQm9BektJbEcrT3ZKUkhhZEVveC9jSmZScFd2QW9HQkFQWjUKNnNmWDdESElCNEtBczRmMWRuNGZJUkMweUF2WVdCL1R3UzZHUWVoNFRFbDVuSkQwWk9ZRVdUbVVBK3pPanZTNApuM09tZ2xNQTU5SGd1ZW13QXVRcEtwWFBOcFUvTERJaThtNnpmTUpvL3E5M0NOQlFQZngzZGh4ZVh4OXE2Mzg3Cm84QWxkOE42RGs4TThjRis3SlNaeUVJODJzLzdpdGRseXA2bFdLaGRBb0dCQUtnU0VrUGYxQWxZdjA2OGVFRGwKRzc0VkRuTEdrMlFobzltKzk1N2psOFNJUEtwMzFrU2JNUTU3TUdpWXNIT1czRzc4TjE3VTRVTUR6R2NZc1RFOQpLaGVrQldGZldMMjU2OHp5Y1d4akx1bzQrbDdJaDBkWHBudTBqbms5L1AvT0lWYS9iczBRcnhKUHFBN2RNb2JxCkYxdFJXRURCTmVxWkMxaFhVZTBEdzVRQkFvR0JBSjdBQ2NNcnhKcVBycDZVakkyK1FOS2M5Q3dSZEdPRXRjWFMKR3JQL2owWE83YnZKVTFsZHYvc1N3L0U4NzRZL3lIM0F5QnF5SFhDZXZiRkZZQmt1MzczYThlM0pwK3RhNC9scQozdUVFUkEvbmxscW5mWXJHbEJZZlQzaVlKQVpWVkZiL3I4bWJtRmJVTDVFazBqV0JyWmxNcjFwU1hkRGx3QmhhCkhMWXY0em1WQW9HQkFLQmw0cFNnbkNSTEJMUU9jWjhXQmhRSjAwZDZieFNrTGNpZ0xUNFJvY3RwNTY1SHJPMDAKSVFLdElTaEg1a2s3SVRHdUYvOERXZEN2djBMYnhvZVBJc2NFaStTaXk5WDZwWENPaS8xa2FyYVU5U3BpZ3czago3YjVlUVV0UlovTkIycVJwc3EzMEdCUENqanhudEVmK2lqelhUS0xNRndyUDhBMTlQNzRONGVTMAotLS0tLUVORCBSU0EgUFJJVkFURSBLRVktLS0tLQo=
readOnly: true
per_page:
type: number
description: Number of results per page of results.
example: 20
period:
type: number
description: The time in seconds (an integer value) to count matching traffic.
If the count exceeds the configured threshold within this period, Cloudflare
will perform the configured action.
example: 900
minimum: 10
maximum: 86400
period_seconds:
type: integer
description: The period over which this threshold is suggested.
readOnly: true
permission_group:
type: object
description: A named group of permissions that map to a group of operations
against resources.
required:
- id
properties:
id:
type: string
description: Identifier of the group.
example: 6d7f2f5f5b1d4a0e9081fdc98d432fd1
readOnly: true
name:
type: string
description: Name of the group.
example: Load Balancers Write
readOnly: true
permission_groups:
type: array
description: A set of permission groups that are specified to the policy.
example:
- id: c8fed203ed3043cba015a93ad1616f1f
name: Zone Read
- id: 82e64a83756745bbbb1c9c2701bf816b
name: DNS Read
items:
$ref: '#/components/schemas/permission_group'
permissions:
type: object
example:
analytics:
read: true
write: false
zones:
read: true
write: true
properties:
analytics:
$ref: '#/components/schemas/grants'
billing:
$ref: '#/components/schemas/grants'
cache_purge:
$ref: '#/components/schemas/grants'
dns:
$ref: '#/components/schemas/grants'
dns_records:
$ref: '#/components/schemas/grants'
lb:
$ref: '#/components/schemas/grants'
logs:
$ref: '#/components/schemas/grants'
organization:
$ref: '#/components/schemas/grants'
ssl:
$ref: '#/components/schemas/grants'
waf:
$ref: '#/components/schemas/grants'
zone_settings:
$ref: '#/components/schemas/grants'
zones:
$ref: '#/components/schemas/grants'
phase:
type: string
description: The phase of the ruleset.
example: http_request_firewall_managed
pattern: ^[a-z_]+$
phishing-url-info:
properties:
categorizations:
type: array
description: List of categorizations applied to this submission.
items:
type: object
properties:
category:
type: string
description: Name of the category applied.
example: PHISHING
verification_status:
type: string
description: Result of human review for this categorization.
example: confirmed
model_results:
type: array
description: List of model results for completed scans.
items:
type: object
properties:
model_name:
type: string
description: Name of the model.
example: MACHINE_LEARNING_v2
model_score:
type: number
description: Score output by the model for this submission.
example: 0.024
rule_matches:
type: array
description: List of signatures that matched against site content found
when crawling the URL.
items:
type: object
properties:
banning:
type: boolean
description: For internal use.
blocking:
type: boolean
description: For internal use.
description:
type: string
description: Description of the signature that matched.
example: Match frequently used social followers phishing kit
name:
type: string
description: Name of the signature that matched.
example: phishkit.social_followers
scan_status:
type: object
description: Status of the most recent scan found.
properties:
last_processed:
type: string
description: Timestamp of when the submission was processed.
example: Wed, 26 Oct 2022 16:04:51 GMT
scan_complete:
type: boolean
description: For internal use.
status_code:
type: integer
description: Status code that the crawler received when loading the
submitted URL.
submission_id:
type: integer
description: ID of the most recent submission.
screenshot_download_signature:
type: string
description: For internal use.
screenshot_path:
type: string
description: For internal use.
url:
type: string
description: URL that was submitted.
example: https://www.cloudflare.com
phishing-url-info_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/phishing-url-info'
phishing-url-submit:
properties:
excluded_urls:
type: array
description: URLs that were excluded from scanning because their domain
is in our no-scan list.
items:
type: object
properties:
url:
type: string
description: URL that was excluded.
example: https://developers.cloudflare.com
skipped_urls:
type: array
description: URLs that were skipped because the same URL is currently being
scanned
items:
type: object
properties:
url:
type: string
description: URL that was skipped.
example: https://www.cloudflare.com/developer-week/
url_id:
type: integer
description: ID of the submission of that URL that is currently scanning.
example: 2
submitted_urls:
type: array
description: URLs that were successfully submitted for scanning.
items:
type: object
properties:
url:
type: string
description: URL that was submitted.
example: https://www.cloudflare.com
url_id:
type: integer
description: ID assigned to this URL submission. Used to retrieve
scanning results.
example: 1
phishing-url-submit_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/phishing-url-submit'
plan_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-rate-plan'
platform:
type: string
enum:
- windows
- mac
- linux
- android
- ios
example: windows
playback:
type: object
readOnly: true
properties:
dash:
type: string
description: DASH Media Presentation Description for the video.
example: https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.mpd
readOnly: true
hls:
type: string
description: The HLS manifest for the video.
example: https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.m3u8
readOnly: true
policies:
type: array
description: List of access policies assigned to the token.
items:
$ref: '#/components/schemas/access-policy'
policies_components-schemas-description:
type: string
description: Optional description for the Notification policy.
example: Something describing the policy.
policies_components-schemas-enabled:
type: boolean
description: Whether or not the Notification policy is enabled.
default: true
example: true
policies_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/components-schemas-uuid'
policies_components-schemas-id_response-2:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
policies_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
policies_components-schemas-name:
type: string
description: The name of the Access policy.
example: Allow devs
policies_components-schemas-name-2:
type: string
description: Name of the policy.
example: SSL Notification Event Policy
policies_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-policies'
policies_components-schemas-response_collection-2:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-policies'
policies_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-policies'
policies_components-schemas-single_response-2:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/components-schemas-policies'
policy:
type: string
description: 'Specify the policy that determines the region where your private
key will be held locally. HTTPS connections to any excluded data center will
still be fully encrypted, but will incur some latency while Keyless SSL is
used to complete the handshake with the nearest allowed data center. Any combination
of countries, specified by their two letter country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
can be chosen, such as ''country: IN'', as well as ''region: EU'' which refers
to the EU region. If there are too few data centers satisfying the policy,
it will be rejected.'
example: '(country: US) or (region: EU)'
policy_check_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
app_state:
type: object
properties:
app_uid:
$ref: '#/components/schemas/uuid'
aud:
type: string
example: 737646a56ab1df6ec9bddc7e5ca84eaf3b0768850f3ffb5d74f1534911fe389
hostname:
type: string
example: test.com
name:
type: string
example: Test App
policies:
type: array
example:
- decision: allow
exclude: []
include:
- _type: email
email: testuser@gmail.com
precedence: 0
require: []
status: Success
items: {}
status:
type: string
example: Success
user_identity:
type: object
properties:
account_id:
type: string
example: 41ecfbb341f033e52b46742756aabb8b
device_sessions:
type: object
example: {}
email:
type: string
example: testuser@gmail.com
geo:
type: object
properties:
country:
type: string
example: US
iat:
type: integer
id:
type: string
example: "1164449231815010287495"
is_gateway:
type: boolean
example: false
is_warp:
type: boolean
example: false
name:
type: string
example: Test User
user_uuid:
$ref: '#/components/schemas/uuid'
version:
type: integer
policy_with_permission_groups:
title: policy_with_permission_groups
required:
- id
- effect
- resources
- permission_groups
properties:
effect:
$ref: '#/components/schemas/effect'
id:
$ref: '#/components/schemas/Cloudflare Client API_identifier'
permission_groups:
$ref: '#/components/schemas/permission_groups'
resources:
$ref: '#/components/schemas/resources'
polish:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- polish
example: polish
value:
$ref: '#/components/schemas/polish_value'
title: Polish Image Optimization
description: 'Removes metadata and compresses your images for faster page load
times. Basic (Lossless): Reduce the size of PNG, JPEG, and GIF files - no
impact on visual quality. Basic + JPEG (Lossy): Further reduce the size of
JPEG files for faster image loading. Larger JPEGs are converted to progressive
images, loading a lower-resolution image first and ending in a higher-resolution
version. Not recommended for hi-res photography sites.'
polish_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- lossless
- lossy
default: "off"
pool:
type: object
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
disabled_at:
$ref: '#/components/schemas/schemas-disabled_at'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
id:
$ref: '#/components/schemas/pool_components-schemas-identifier'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
modified_on:
$ref: '#/components/schemas/timestamp'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
pool_components-schemas-description:
type: string
description: A human-readable description of the pool.
example: Primary data center - Provider XYZ
pool_components-schemas-enabled:
type: boolean
description: Whether to enable (the default) or disable this pool. Disabled
pools will not receive traffic and are excluded from health checks. Disabling
a pool will cause any load balancers using it to failover to the next pool
(if any).
default: true
example: false
pool_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/pool_components-schemas-identifier'
pool_components-schemas-identifier:
example: 17b5962d775c646f3f9725cbc7a53df4
pool_components-schemas-name:
type: string
description: A short name (tag) for the pool. Only alphanumeric characters,
hyphens, and underscores are allowed.
example: primary-dc-1
pool_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/pool'
pool_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/pool'
pop_pools:
type: object
description: '(Enterprise only): A mapping of Cloudflare PoP identifiers to
a list of pool IDs (ordered by their failover priority) for the PoP (datacenter).
Any PoPs not explicitly defined will fall back to using the corresponding
country_pool, then region_pool mapping if it exists else to default_pools.'
example:
LAX:
- de90f38ced07c2e2f4df50b1f61d4194
- 9290f38c5d07c2e2f4df57b1f61d4196
LHR:
- abd90f38ced07c2e2f4df50b1f61d4194
- f9138c5d07c2e2f4df57b1f61d4196
SJC:
- 00920f38ce07c2e2f4df50b1f61d4194
popularity_rank:
type: integer
description: Global Cloudflare 100k ranking for the last 30 days, if available
for the hostname. The top ranked domain is 1, the lowest ranked domain is
100,000.
port:
type: number
description: DNS port of primary or secondary nameserver, depending on what
zone this peer is linked to.
example: 53
position:
type: string
description: 'The location of the image. Valid positions are: `upperRight`,
`upperLeft`, `lowerLeft`, `lowerRight`, and `center`. Note that `center` ignores
the `padding` parameter.'
default: upperRight
example: center
readOnly: true
precedence:
type: integer
description: The order of execution for this policy. Must be unique for each
policy.
predefined_entry:
type: object
title: Predefined entry
description: A predefined entry that matches a profile
properties:
enabled:
type: boolean
description: Whether the entry is enabled or not.
example: true
id:
$ref: '#/components/schemas/entry_id'
name:
type: string
description: The name of the entry.
example: Credit card (Visa)
profile_id:
description: ID of the parent profile
predefined_profile:
type: object
title: Predefined profile
properties:
entries:
type: array
description: The entries for this profile.
items:
$ref: '#/components/schemas/predefined_entry'
id:
$ref: '#/components/schemas/profile_id'
name:
type: string
description: The name of the profile.
example: Generic CVV Card Number
type:
type: string
description: The type of the profile.
enum:
- predefined
example: predefined
predefined_profile_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
allOf:
- $ref: '#/components/schemas/predefined_profile'
prefetch_preload:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- prefetch_preload
example: prefetch_preload
value:
$ref: '#/components/schemas/prefetch_preload_value'
title: Prefetch preload
description: Cloudflare will prefetch any URLs that are included in the response
headers. This is limited to Enterprise Zones.
default: "off"
prefetch_preload_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
prefix:
type: string
description: IP Prefix in Classless Inter-Domain Routing format.
example: 192.0.2.0/24
preview:
type: string
format: uri
description: The video's preview page URI. This field is omitted until encoding
is complete.
example: https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/watch
readOnly: true
preview_id:
example: f1aba936b94213e5b8dca0c0dbf1f9cc
preview_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
pools:
type: object
example:
abwlnp5jbqn45ecgxd03erbgtxtqai0d: WNAM Datacenter
ve8h9lrcip5n5bbga9yqmdws28ay5d0l: EEU Datacenter
preview_id:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
preview_result:
type: object
description: Resulting health data from a preview operation.
example:
abwlnp5jbqn45ecgxd03erbgtxtqai0d:
healthy: true
origins:
- originone.example.com.:
$ref: '#/components/schemas/origin_health_data/example'
preview_result_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/preview_result'
preview_url:
type: string
description: URL where the custom waiting room page can temporarily be previewed.
example: http://waitingrooms.dev/preview/35af8c12-6d68-4608-babb-b53435a5ddfb
price:
type: number
description: The price of the subscription that will be billed, in US dollars.
example: 20
readOnly: true
priority:
type: number
description: Required for MX, SRV and URI records; unused by other record types.
Records with lower priorities are preferred.
example: 10
minimum: 0
maximum: 65535
privacy:
type: boolean
description: Privacy option controls redacting WHOIS information.
example: true
privacy_pass:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- privacy_pass
example: privacy_pass
value:
$ref: '#/components/schemas/privacy_pass_value'
title: Privacy Pass
description: Privacy Pass is a browser extension developed by the Privacy Pass
Team to improve the browsing experience for your visitors. Enabling Privacy
Pass will reduce the number of CAPTCHAs shown to your visitors. (https://support.cloudflare.com/hc/en-us/articles/115001992652-Privacy-Pass).
privacy_pass_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
private_key:
type: string
description: The zone's private key.
example: |
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG
dtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn
abIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid
tnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py
FxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE
ewooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb
HBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/
axiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb
+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g
+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv
KLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7
9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo
/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu
iacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9
N2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe
VAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB
vULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U
lySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR
9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7
mEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX
dFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe
PG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS
fhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W
qu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T
lv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi
-----END RSA PRIVATE KEY-----
probe_zone:
type: string
description: Assign this monitor to emulate the specified zone while probing.
This parameter is only valid for HTTP and HTTPS monitors.
example: example.com
products:
type: array
items:
type: string
description: A list of products to bypass for a request when using the `bypass`
action.
enum:
- zoneLockdown
- uaBlock
- bic
- hot
- securityLevel
- rateLimit
- waf
example: waf
profile_id:
allOf:
- $ref: '#/components/schemas/uuid'
description: The ID for this profile
example: 384e129d-25bd-403c-8019-bc19eb7a8a5f
profiles:
anyOf:
- $ref: '#/components/schemas/predefined_profile'
- $ref: '#/components/schemas/custom_profile'
profiles_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/profiles'
project-patch:
example:
deployment_configs:
production:
compatibility_date: "2022-01-01"
compatibility_flags:
- url_standard
env_vars:
BUILD_VERSION:
value: "3.3"
delete_this_env_var: null
project-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
project_name:
type: string
description: Name of the project.
example: this-is-my-project-01
pattern: ^[a-z0-9][a-z0-9-]*$
projects:
type: object
properties:
build_config:
$ref: '#/components/schemas/build_config'
canonical_deployment:
oneOf:
- nullable: true
- $ref: '#/components/schemas/deployments'
description: Most recent deployment to the repo.
readOnly: true
created_on:
type: string
format: date-time
description: When the project was created.
example: "2017-01-01T00:00:00Z"
readOnly: true
deployment_configs:
$ref: '#/components/schemas/deployment_configs'
domains:
type: array
description: A list of associated custom domains for the project.
example:
- customdomain.com
- customdomain.org
readOnly: true
items: {}
id:
type: string
description: Id of the project.
example: 7b162ea7-7367-4d67-bcde-1160995d5
readOnly: true
latest_deployment:
oneOf:
- nullable: true
- $ref: '#/components/schemas/deployments'
description: Most recent deployment to the repo.
readOnly: true
name:
type: string
description: Name of the project.
example: NextJS Blog
production_branch:
type: string
description: Production branch of the project. Used to identify production
deployments.
example: main
source:
readOnly: true
subdomain:
type: string
description: The Cloudflare subdomain associated with the project.
example: helloworld.pages.dev
readOnly: true
projects-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
- properties:
result:
type: array
items:
type: object
properties-modified_on:
type: string
format: date-time
description: last time this setting was modified.
example: "2014-01-01T05:20:00.12345Z"
nullable: true
readOnly: true
properties-name:
type: string
description: The domain name
example: example.com
readOnly: true
maxLength: 253
pattern: ^([a-zA-Z0-9][\-a-zA-Z0-9]*\.)+[\-a-zA-Z0-9]{2,20}$
protocol:
type: string
description: The port configuration at Cloudflare’s edge. May specify a single
port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`.
example: tcp/22
provider_name:
type: string
description: The name of provider. Usually cloudflare.
example: Cloudflare
proxied:
type: boolean
description: Whether the record is receiving the performance and security benefits
of Cloudflare.
example: false
proxy-endpoints:
type: object
properties:
created_at:
$ref: '#/components/schemas/timestamp'
id:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-uuid'
ips:
$ref: '#/components/schemas/components-schemas-ips'
name:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-name'
subdomain:
$ref: '#/components/schemas/schemas-subdomain'
updated_at:
$ref: '#/components/schemas/timestamp'
proxy-endpoints_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
proxy-endpoints_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
proxy-endpoints_components-schemas-name:
type: string
description: The name of the Proxy Endpoint.
example: Devops team
proxy-endpoints_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/proxy-endpoints'
proxy-endpoints_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/proxy-endpoints'
proxy-endpoints_components-schemas-uuid:
example: ed35569b41ce4d1facfe683550f54086
proxy_protocol:
type: string
description: Enables Proxy Protocol to the origin. Refer to [Enable Proxy protocol](https://developers.cloudflare.com/spectrum/getting-started/proxy-protocol/)
for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple
Proxy Protocol.
enum:
- "off"
- v1
- v2
- simple
default: "off"
example: "off"
proxy_read_timeout:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- proxy_read_timeout
example: proxy_read_timeout
value:
$ref: '#/components/schemas/proxy_read_timeout_value'
title: Proxy Read Timeout
description: Maximum time between two read operations from origin.
proxy_read_timeout_value:
type: number
description: |-
Value of the zone setting.
Notes: Value must be between 1 and 6000
default: 100
pseudo_ipv4:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Value of the Pseudo IPv4 setting.
enum:
- pseudo_ipv4
default: pseudo_ipv4
value:
$ref: '#/components/schemas/pseudo_ipv4_value'
title: Pseudo IPv4 Value
description: The value set for the Pseudo IPv4 setting.
pseudo_ipv4_value:
type: string
description: Value of the Pseudo IPv4 setting.
enum:
- "off"
- add_header
- overwrite_header
default: "off"
psk:
type: string
description: A randomly generated or provided string for use in the IPsec tunnel.
example: O3bwKSjnaoCxDoUxjcq4Rk8ZKkezQUiy
psk_generation_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
ipsec_tunnel_id:
$ref: '#/components/schemas/common_components-schemas-identifier'
psk:
$ref: '#/components/schemas/psk'
psk_metadata:
$ref: '#/components/schemas/psk_metadata'
psk_metadata:
type: object
description: The PSK metadata that includes when the PSK was generated.
properties:
last_generated_on:
$ref: '#/components/schemas/common_components-schemas-modified_on'
public_key:
type: string
description: The public key to add to your SSH server configuration.
example: ecdsa-sha2-nistp256 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/xxxxxxxxxxxxxxxxxxxxx/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx=
open-ssh-ca@cloudflareaccess.org
readOnly: true
purge_by_cache_tags_or_hosts_or_prefixes:
properties:
hosts:
type: array
description: Any assets at URLs with a host that matches one of the provided
values will be purged from the Cloudflare cache.
example:
- www.example.com
- images.example.com
maxLength: 30
items:
type: string
prefixes:
type: array
description: Any assets at URLs that match the prefix will be purged from
the Cloudflare cache. For example, a.com/b will purge a.com/b/c/d.png
but not a.com/bc.png. The prefixes a.com/b and a.com/b/c are redundant.
example:
- www.example.com/foo
- images.example.com/bar/baz
maxLength: 30
items:
type: string
tags:
type: array
description: Any assets served with a Cache-Tag header that matches one
of the provided values will be purged from the Cloudflare cache.
example:
- some-tag
- another-tag
maxLength: 30
items:
type: string
purpose_justification_prompt:
type: string
description: A custom message that will appear on the purpose justification
screen.
example: Please enter a justification for entering this protected domain.
purpose_justification_required:
type: boolean
description: Require users to enter a justification when they log in to the
application.
default: false
example: true
query:
type: object
description: For specifying result metrics.
properties:
dimensions:
type: array
description: Can be used to break down the data by given attributes.
default: '[]'
items:
type: string
description: For drilling down on metrics.
filters:
type: string
description: "Used to filter rows by one or more dimensions. Filters can
be combined using OR and AND boolean logic. AND takes precedence over
OR in all the expressions. The OR operator is defined using a comma (,)
or OR keyword surrounded by whitespace. The AND operator is defined using
a semicolon (;) or AND keyword surrounded by whitespace. Note that the
semicolon is a reserved character in URLs (rfc1738) and needs to be percent-encoded
as %3B. Comparison options are: \n\nOperator | Name |
URL Encoded\n--------------------------|---------------------------------|--------------------------\n==
\ | Equals | %3D%3D\n!=
\ | Does not equals | !%3D\n> |
Greater Than | %3E\n< | Less
Than | %3C\n>= | Greater than
or equal to | %3E%3D\n<= | Less than or
equal to | %3C%3D ."
default: '""'
limit:
type: integer
description: Limit number of returned metrics.
default: 10000
metrics:
type: array
description: One or more metrics to compute.
items:
type: string
description: A quantitative measurement of KV usage.
since:
type: string
format: date-time
description: Start of time interval to query, defaults to 6 hours before
request received.
default: <6 hours ago>
example: "2019-01-02T02:20:00Z"
sort:
type: array
description: Array of dimensions or metrics to sort by, each dimension/metric
may be prefixed by - (descending) or + (ascending).
default: '[]'
items: {}
until:
type: string
format: date-time
description: End of time interval to query, defaults to current time.
default:
example: "2019-01-02T03:20:00Z"
query_event:
type: object
required:
- name
- event_start_time
- event_end_time
properties:
custom_page_html:
$ref: '#/components/schemas/event_custom_page_html'
description:
$ref: '#/components/schemas/event_description'
disable_session_renewal:
$ref: '#/components/schemas/event_disable_session_renewal'
event_end_time:
$ref: '#/components/schemas/event_end_time'
event_start_time:
$ref: '#/components/schemas/event_start_time'
name:
$ref: '#/components/schemas/event_name'
new_users_per_minute:
$ref: '#/components/schemas/event_new_users_per_minute'
prequeue_start_time:
$ref: '#/components/schemas/event_prequeue_start_time'
queueing_method:
$ref: '#/components/schemas/event_queueing_method'
session_duration:
$ref: '#/components/schemas/event_session_duration'
shuffle_at_event_start:
$ref: '#/components/schemas/event_shuffle_at_event_start'
suspended:
$ref: '#/components/schemas/event_suspended'
total_active_users:
$ref: '#/components/schemas/event_total_active_users'
query_healthcheck:
type: object
required:
- name
- address
properties:
address:
$ref: '#/components/schemas/schemas-address'
check_regions:
$ref: '#/components/schemas/schemas-check_regions'
consecutive_fails:
$ref: '#/components/schemas/consecutive_fails'
consecutive_successes:
$ref: '#/components/schemas/consecutive_successes'
description:
$ref: '#/components/schemas/healthchecks_components-schemas-description'
http_config:
$ref: '#/components/schemas/http_config'
interval:
$ref: '#/components/schemas/components-schemas-interval'
name:
$ref: '#/components/schemas/healthchecks_components-schemas-name'
retries:
$ref: '#/components/schemas/retries'
suspended:
$ref: '#/components/schemas/suspended'
tcp_config:
$ref: '#/components/schemas/tcp_config'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/healthchecks_components-schemas-type'
query_preview:
type: object
required:
- custom_html
properties:
custom_html:
$ref: '#/components/schemas/custom_page_html'
query_response:
type: object
description: The exact parameters/timestamps the analytics service used to return
data.
readOnly: true
properties:
since:
$ref: '#/components/schemas/since'
time_delta:
type: integer
description: The amount of time (in minutes) that each data point in the
timeseries represents. The granularity of the time-series returned (e.g.
each bucket in the time series representing 1-minute vs 1-day) is calculated
by the API based on the time-range provided to the API.
until:
$ref: '#/components/schemas/until'
query_waitingroom:
type: object
required:
- name
- host
- new_users_per_minute
- total_active_users
properties:
cookie_attributes:
$ref: '#/components/schemas/cookie_attributes'
custom_page_html:
$ref: '#/components/schemas/custom_page_html'
default_template_language:
$ref: '#/components/schemas/default_template_language'
description:
$ref: '#/components/schemas/waitingroom_components-schemas-description'
disable_session_renewal:
$ref: '#/components/schemas/disable_session_renewal'
host:
$ref: '#/components/schemas/components-schemas-host'
json_response_enabled:
$ref: '#/components/schemas/json_response_enabled'
name:
$ref: '#/components/schemas/waitingroom_components-schemas-name'
new_users_per_minute:
$ref: '#/components/schemas/new_users_per_minute'
path:
$ref: '#/components/schemas/schemas-path'
queue_all:
$ref: '#/components/schemas/queue_all'
queueing_method:
$ref: '#/components/schemas/queueing_method'
session_duration:
$ref: '#/components/schemas/schemas-session_duration'
suspended:
$ref: '#/components/schemas/schemas-suspended'
total_active_users:
$ref: '#/components/schemas/total_active_users'
queue:
type: object
properties:
consumers:
readOnly: true
consumers_total_count:
readOnly: true
created_on:
readOnly: true
modified_on:
readOnly: true
producers:
readOnly: true
producers_total_count:
readOnly: true
queue_id:
readOnly: true
queue_name:
$ref: '#/components/schemas/queues_components-schemas-name'
queue_all:
type: boolean
description: If queue_all is `true`, all the traffic that is coming to a route
will be sent to the waiting room. No new traffic can get to the route once
this field is set and estimated time will become unavailable.
default: false
example: true
queue_created:
type: object
properties:
created_on:
readOnly: true
modified_on:
readOnly: true
queue_id:
readOnly: true
queue_name:
$ref: '#/components/schemas/queues_components-schemas-name'
queue_updated:
type: object
properties:
created_on:
readOnly: true
modified_on:
readOnly: true
queue_id:
readOnly: true
queue_name:
$ref: '#/components/schemas/renamed_name'
queueing_method:
type: string
description: |-
Sets the queueing method used by the waiting room. Changing this parameter from the **default** queueing method is only available for the Waiting Room Advanced subscription. Regardless of the queueing method, if `queue_all` is enabled or an event is prequeueing, users in the waiting room will not be accepted to the origin. These users will always see a waiting room page that refreshes automatically. The valid queueing methods are:
1. `fifo` **(default)**: First-In-First-Out queue where customers gain access in the order they arrived.
2. `random`: Random queue where customers gain access randomly, regardless of arrival time.
3. `passthrough`: Users will pass directly through the waiting room and into the origin website. As a result, any configured limits will not be respected while this is enabled. This method can be used as an alternative to disabling a waiting room (with `suspended`) so that analytics are still reported. This can be used if you wish to allow all traffic normally, but want to restrict traffic during a waiting room event, or vice versa.
4. `reject`: Users will be immediately rejected from the waiting room. As a result, no users will reach the origin website while this is enabled. This can be used if you wish to reject all traffic while performing maintenance, block traffic during a specified period of time (an event), or block traffic while events are not occurring. Consider a waiting room used for vaccine distribution that only allows traffic during sign-up events, and otherwise blocks all traffic. For this case, the waiting room uses `reject`, and its events override this with `fifo`, `random`, or `passthrough`. When this queueing method is enabled and neither `queueAll` is enabled nor an event is prequeueing, the waiting room page **will not refresh automatically**.
enum:
- fifo
- random
- passthrough
- reject
default: fifo
example: fifo
queues_components-schemas-name:
type: string
example: example-queue
quota:
type: object
properties:
allocated:
type: integer
description: Quantity Allocated.
used:
type: integer
description: Quantity Used.
r2-single-bucket-operation-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
railgun:
type: object
required:
- id
- name
- status
- enabled
- zones_connected
- build
- version
- revision
- activation_key
- activated_on
- created_on
- modified_on
properties:
activated_on:
$ref: '#/components/schemas/activated_on'
activation_key:
$ref: '#/components/schemas/activation_key'
build:
$ref: '#/components/schemas/build'
created_on:
$ref: '#/components/schemas/railgun_components-schemas-created_on'
enabled:
$ref: '#/components/schemas/railgun_components-schemas-enabled'
id:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/railgun_components-schemas-modified_on'
name:
$ref: '#/components/schemas/railgun_components-schemas-name'
revision:
$ref: '#/components/schemas/revision'
status:
$ref: '#/components/schemas/railgun_components-schemas-status'
upgrade_info:
$ref: '#/components/schemas/upgrade_info'
version:
$ref: '#/components/schemas/railgun_components-schemas-version'
zones_connected:
$ref: '#/components/schemas/zones_connected'
railgun_components-schemas-created_on:
type: string
format: date-time
description: When the Railgun was created.
example: "2014-01-01T05:20:00Z"
readOnly: true
railgun_components-schemas-enabled:
type: boolean
description: Flag to determine if the Railgun is accepting connections.
default: false
example: true
railgun_components-schemas-identifier:
type: string
description: Railgun identifier tag.
example: e928d310693a83094309acf9ead50448
readOnly: true
maxLength: 32
railgun_components-schemas-identifier-2:
type: string
description: Railgun connection identifier tag.
example: e928d310693a83094309acf9ead50448
readOnly: true
maxLength: 32
railgun_components-schemas-modified_on:
type: string
format: date-time
description: When the Railgun was last modified.
example: "2014-01-01T05:20:00Z"
readOnly: true
railgun_components-schemas-name:
type: string
description: Readable identifier of the Railgun.
example: My Railgun.
maxLength: 160
railgun_components-schemas-status:
type: string
description: Status of the Railgun.
enum:
- initializing
- active
example: active
readOnly: true
railgun_components-schemas-version:
type: string
description: The version of the Railgun receiver.
example: "2.1"
readOnly: true
railgun_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/railgun'
railgun_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
railgun_response_single_id:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
random_steering:
type: object
description: Configures pool weights for random steering. When steering_policy
is 'random', a random pool is selected with probability proportional to these
pool weights.
properties:
default_weight:
type: number
description: The default weight for pools in the load balancer that are
not specified in the pool_weights map.
default: 1
example: 0.2
minimum: 0
maximum: 1
multipleOf: 0.1
pool_weights:
type: object
description: A mapping of pool IDs to custom weights. The weight is relative
to other pools in the load balancer.
example:
9290f38c5d07c2e2f4df57b1f61d4196: 0.5
de90f38ced07c2e2f4df50b1f61d4194: 0.3
rate-limits:
allOf:
- $ref: '#/components/schemas/components-schemas-ratelimit'
type: object
rate-limits_components-schemas-id:
type: string
description: The unique identifier of the rate limit.
example: 372e67954025e0ba6aaa6d586b9e0b59
readOnly: true
maxLength: 32
rate-plan:
type: object
properties:
components:
$ref: '#/components/schemas/schemas-component_values'
currency:
$ref: '#/components/schemas/currency'
duration:
$ref: '#/components/schemas/duration'
frequency:
$ref: '#/components/schemas/schemas-frequency'
id:
$ref: '#/components/schemas/rate-plan_components-schemas-identifier'
name:
$ref: '#/components/schemas/rate-plan_components-schemas-name'
rate-plan_components-schemas-identifier:
type: string
description: Plan identifier tag.
example: free
readOnly: true
rate-plan_components-schemas-name:
type: string
description: The plan name.
example: Free Plan
readOnly: true
maxLength: 80
rate_plan:
type: object
description: The rate plan applied to the subscription.
properties:
currency:
type: string
description: The currency applied to the rate plan subscription.
example: USD
externally_managed:
type: boolean
description: Whether this rate plan is managed externally from Cloudflare.
example: false
id:
description: The ID of the rate plan.
example: free
is_contract:
type: boolean
description: Whether a rate plan is enterprise-based (or newly adopted term
contract).
example: false
public_name:
type: string
description: The full name of the rate plan.
example: Business Plan
scope:
type: string
description: The scope that this rate plan applies to.
example: zone
sets:
type: array
description: The list of sets this rate plan applies to.
items:
type: string
ratelimit:
type: number
description: Ratelimit in queries per second per datacenter (applies to DNS
queries sent to the origin nameservers configured on the cluster).
example: 600
nullable: true
minimum: 100
maximum: 1e+09
ratelimit_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/rate-limits'
ratelimit_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
ray_id:
type: string
description: The unique identifier for the request to Cloudflare.
example: 187d944c61940c77
maxLength: 16
ray_identifier:
type: string
description: Ray identifier.
example: 41ddf1740f67442d
readOnly: true
maxLength: 16
ready:
type: boolean
description: Beta flag. Users can create a policy with a mechanism that is not
ready, but we cannot guarantee successful delivery of notifications.
example: true
readyToStream:
type: boolean
description: Indicates whether the video is ready for viewing.
example: true
readOnly: true
ref:
type: string
description: A short reference tag. Allows you to select related firewall rules.
example: MIR-31
maxLength: 50
references_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
description: List of resources that reference a given monitor.
example:
- reference_type: referrer
resource_id: 17b5962d775c646f3f9725cbc7a53df4
resource_name: primary-dc-1
resource_type: pool
items:
type: object
properties:
reference_type:
type: string
enum:
- '*'
- referral
- referrer
resource_id:
type: string
resource_name:
type: string
resource_type:
type: string
region_code:
type: string
description: 'A list of Cloudflare regions. WNAM: Western North America, ENAM:
Eastern North America, WEU: Western Europe, EEU: Eastern Europe, NSAM: Northern
South America, SSAM: Southern South America, OC: Oceania, ME: Middle East,
NAF: North Africa, SAF: South Africa, SAS: Southern Asia, SEAS: South East
Asia, NEAS: North East Asia).'
enum:
- WNAM
- ENAM
- WEU
- EEU
- NSAM
- SSAM
- OC
- ME
- NAF
- SAF
- SAS
- SEAS
- NEAS
example: WNAM
region_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
region_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
description: A list of countries and subdivisions mapped to a region.
example:
iso_standard: Country and subdivision codes follow ISO 3166-1 alpha-2
and ISO 3166-2
regions:
- countries:
- country_code_a2: CA
country_name: Canada
country_subdivisions:
- subdivision_code_a2: AB
subdivision_name: Alberta
- subdivision_code_a2: BC
subdivision_name: British Columbia
- country_code_a2: HT
country_name: Haiti
- country_code_a2: MX
country_name: Mexico
- country_code_a2: US
country_name: United States
country_subdivisions:
- subdivision_code_a2: AZ
subdivision_name: Arizona
- subdivision_code_a2: CA
subdivision_name: California
- subdivision_code_a2: CO
subdivision_name: Colorado
- subdivision_code_a2: HI
subdivision_name: Hawaii
- subdivision_code_a2: MN
subdivision_name: Minnesota
- subdivision_code_a2: MO
subdivision_name: Missouri
- subdivision_code_a2: NV
subdivision_name: Nevada
- subdivision_code_a2: OR
subdivision_name: Oregon
- subdivision_code_a2: TX
subdivision_name: Texas
- subdivision_code_a2: UT
subdivision_name: Utah
- subdivision_code_a2: WA
subdivision_name: Washington
region_code: WNAM
region_pools:
type: object
description: A mapping of region codes to a list of pool IDs (ordered by their
failover priority) for the given region. Any regions not explicitly defined
will fall back to using default_pools.
example:
ENAM:
- 00920f38ce07c2e2f4df50b1f61d4194
WNAM:
- de90f38ced07c2e2f4df50b1f61d4194
- 9290f38c5d07c2e2f4df57b1f61d4196
registrant_contact:
allOf:
- $ref: '#/components/schemas/contacts'
description: Shows contact information for domain registrant.
registry_statuses:
type: string
description: A comma-separated list of registry status codes. A full list of
status codes can be found at [EPP Status Codes](https://www.icann.org/resources/pages/epp-status-codes-2014-06-16-en).
example: ok,serverTransferProhibited
remote_config:
type: boolean
description: If `true`, the tunnel can be configured remotely from the Zero
Trust dashboard. If `false`, the tunnel must be configured locally on the
origin machine.
example: true
renamed_name:
type: string
example: renamed-example-queue
request.ip:
type: object
description: Client IP restrictions.
example:
in:
- 123.123.123.0/24
- 2606:4700::/32
not_in:
- 123.123.123.100/24
- 2606:4700:4700::/48
properties:
in:
$ref: '#/components/schemas/cidr_list'
not_in:
$ref: '#/components/schemas/cidr_list'
request_list:
type: array
items:
$ref: '#/components/schemas/request_model'
request_model:
type: object
properties:
enabled:
$ref: '#/components/schemas/managed_headers_components-schemas-enabled'
id:
$ref: '#/components/schemas/managed_headers_components-schemas-id'
request_type:
type: string
description: Signature type desired on certificate ("origin-rsa" (rsa), "origin-ecc"
(ecdsa), or "keyless-certificate" (for Keyless SSL servers).
enum:
- origin-rsa
- origin-ecc
- keyless-certificate
example: origin-rsa
requested_validity:
type: number
description: The number of days for which the certificate should be valid.
enum:
- 7
- 30
- 90
- 365
- 730
- 1095
- 5475
default: 5475
example: 5475
requests:
type: integer
description: The estimated number of requests covered by these calculations.
readOnly: true
requests_by_colo:
type: object
description: Breakdown of totals for requests.
properties:
all:
type: integer
description: Total number of requests served.
cached:
type: integer
description: Total number of cached requests served.
country:
type: object
description: Key/value pairs where the key is a two-digit country code and
the value is the number of requests served to that country.
example:
AG: 37298
GI: 293846
US: 4.181364e+06
http_status:
type: object
description: A variable list of key/value pairs where the key is a HTTP
status code and the value is the number of requests with that code served.
example:
"200": 1.3496983e+07
"301": 283
"400": 187936
"402": 1828
"404": 1293
uncached:
type: integer
description: Total number of requests served from the origin.
require:
type: array
description: Rules evaluated with an AND logical operator. To match a policy,
a user must meet all of the Require rules.
items:
$ref: '#/components/schemas/rule_components-schemas-rule'
requireSignedURLs:
type: boolean
description: Indicates whether the video can be a accessed using the UID. When
set to `true`, a signed token must be generated with a signing key to view
the video.
default: false
example: true
readOnly: true
resolves_to_ref:
type: object
properties:
id:
$ref: '#/components/schemas/stix_identifier'
value:
type: string
description: IP address or domain name.
example: 192.0.2.0
resolves_to_refs:
type: array
description: Specifies a list of references to one or more IP addresses or domain
names that the domain name currently resolves to.
items:
$ref: '#/components/schemas/resolves_to_ref'
resource_reference:
type: object
description: A reference to a load balancer resource.
properties:
reference_type:
type: string
description: When listed as a reference, the type (direction) of the reference.
enum:
- referral
- referrer
references:
type: array
description: A list of references to (referrer) or from (referral) this
resource.
example:
- reference_type: referrer
resource_id: 699d98642c564d2e855e9661899b7252
resource_name: www.example.com
resource_type: load_balancer
- reference_type: referral
resource_id: f1aba936b94213e5b8dca0c0dbf1f9cc
resource_name: Login page monitor
resource_type: monitor
items:
type: object
description: A reference to a load balancer resource.
resource_id:
example: 17b5962d775c646f3f9725cbc7a53df4
resource_name:
type: string
description: The human-identifiable name of the resource.
example: primary-dc-1
resource_type:
type: string
description: The type of the resource.
enum:
- load_balancer
- monitor
- pool
example: pool
resources:
type: object
description: A list of resource names that the policy applies to.
example:
com.cloudflare.api.account.zone.22b1de5f1c0e4b3ea97bb1e963b06a43: '*'
com.cloudflare.api.account.zone.eb78d65290b24279ba6f44721b3ea3c4: '*'
response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/domain-history'
response_buffering:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- response_buffering
example: response_buffering
value:
$ref: '#/components/schemas/response_buffering_value'
title: Response Buffering
description: Enables or disables buffering of responses from the proxied server.
Cloudflare may buffer the whole payload to deliver it at once to the client
versus allowing it to be delivered in chunks. By default, the proxied server
streams directly and is not buffered by Cloudflare. This is limited to Enterprise
Zones.
default: "off"
response_buffering_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
type: object
response_create:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
allOf:
- type: object
- type: object
properties:
value:
$ref: '#/components/schemas/value'
response_list:
type: array
items:
$ref: '#/components/schemas/response_model'
response_model:
type: object
properties:
available:
$ref: '#/components/schemas/available'
enabled:
$ref: '#/components/schemas/managed_headers_components-schemas-enabled'
id:
$ref: '#/components/schemas/managed_headers_components-schemas-id'
response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
response_single_origin_dns:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
argo_smart_routing:
$ref: '#/components/schemas/argo_smart_routing'
created_on:
$ref: '#/components/schemas/app_components-schemas-created'
dns:
$ref: '#/components/schemas/dns'
edge_ips:
$ref: '#/components/schemas/edge_ips'
id:
$ref: '#/components/schemas/app_id'
ip_firewall:
$ref: '#/components/schemas/ip_firewall'
modified_on:
$ref: '#/components/schemas/app_components-schemas-modified'
origin_dns:
$ref: '#/components/schemas/origin_dns'
origin_port:
$ref: '#/components/schemas/origin_port'
protocol:
$ref: '#/components/schemas/protocol'
proxy_protocol:
$ref: '#/components/schemas/proxy_protocol'
tls:
$ref: '#/components/schemas/tls'
traffic_type:
$ref: '#/components/schemas/traffic_type'
response_single_segment:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
required:
- id
- status
properties:
expires_on:
$ref: '#/components/schemas/expires_on'
id:
$ref: '#/components/schemas/components-schemas-identifier'
not_before:
$ref: '#/components/schemas/not_before'
status:
$ref: '#/components/schemas/status'
response_single_value:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/value'
result:
type: object
required:
- rows
- data
- totals
properties:
data:
type: array
nullable: true
items:
type: object
required:
- dimensions
- metrics
properties:
dimensions:
type: array
description: Array of dimension values for this row.
example:
- name: NODATA
items:
$ref: '#/components/schemas/dimension_value'
metrics:
type: array
items: {}
data_lag:
type: number
description: Number of seconds between current time and last processed event,
in another words how many seconds of data could be missing.
example: 60
minimum: 0
max:
description: Maximum results for each metric.
min:
description: Minimum results for each metric.
rows:
type: number
description: Total number of rows in the result.
example: 100
minimum: 0
totals:
description: Total results for metrics across all data.
result_info:
type: object
properties:
count:
type: number
description: Total number of results for the requested service
example: 1
page:
type: number
description: Current page within paginated list of results
example: 1
per_page:
type: number
description: Number of results per page of results
example: 20
total_count:
type: number
description: Total results available without any search parameters
example: 2000
retries:
type: integer
description: The number of retries to attempt in case of a timeout before marking
the origin as unhealthy. Retries are attempted immediately.
default: 2
revision:
type: string
description: The revision of the Railgun receiver.
example: "123"
readOnly: true
revoke_devices_request:
type: array
description: A list of device ids to revoke.
maxLength: 200
items:
$ref: '#/components/schemas/uuid'
revoked_at:
type: string
format: date-time
description: When the device was revoked.
example: "2017-06-14T00:00:00Z"
rewrite_action:
type: object
description: Specifies that, when a WAF rule matches, its configured action
will be replaced by the action configured in this object.
properties:
block:
$ref: '#/components/schemas/waf_rewrite_action'
challenge:
example: block
default:
example: block
disable:
$ref: '#/components/schemas/waf_rewrite_action'
simulate:
example: disable
risk_score:
type: number
description: Hostname risk score, which is a value between 0 (lowest risk) to
1 (highest risk).
risk_types:
example: []
rocket_loader:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- rocket_loader
example: rocket_loader
value:
$ref: '#/components/schemas/rocket_loader_value'
title: Rocket Loader
description: Rocket Loader is a general-purpose asynchronous JavaScript optimisation
that prioritises rendering your content while loading your site's Javascript
asynchronously. Turning on Rocket Loader will immediately improve a web page's
rendering time sometimes measured as Time to First Paint (TTFP), and also
the `window.onload` time (assuming there is JavaScript on the page). This
can have a positive impact on your Google search ranking. When turned on,
Rocket Loader will automatically defer the loading of all Javascript referenced
in your HTML, with no configuration required. Refer to [Understanding Rocket
Loader](https://support.cloudflare.com/hc/articles/200168056) for more information.
rocket_loader_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
role:
type: object
required:
- id
- name
- description
- permissions
properties:
description:
type: string
description: Description of role's permissions.
example: Administrative access to the entire Account
readOnly: true
id:
$ref: '#/components/schemas/role_components-schemas-identifier'
name:
type: string
description: Role name.
example: Account Administrator
readOnly: true
maxLength: 120
permissions:
$ref: '#/components/schemas/permissions'
role_components-schemas-identifier:
type: string
description: Role identifier tag.
example: 3536bcfad5faccb999b47003c79917fb
readOnly: true
maxLength: 32
roles:
type: array
description: List of role names for the user at the account.
readOnly: true
items:
type: string
example: Account Administrator
maxLength: 120
route:
type: object
properties:
modified_on:
type: string
format: date-time
description: The timestamp of when the override was last modified.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
name:
description: The type of route.
enum:
- forward_url
example: forward_url
value:
properties:
type:
description: The response type for the URL redirect.
enum:
- temporary
- permanent
example: temporary
url:
type: string
description: |-
The URL to redirect the request to.
Notes: ${num} refers to the position of '*' in the constraint value.
example: http://www.example.com/somewhere/$1/astring/$2/anotherstring/$3
route-no-id:
required:
- pattern
properties:
pattern:
$ref: '#/components/schemas/pattern'
script:
$ref: '#/components/schemas/schemas-script_name'
route-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/routes'
route-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/routes'
route_add_single_request:
type: object
required:
- prefix
- nexthop
- priority
properties:
description:
$ref: '#/components/schemas/route_components-schemas-description'
nexthop:
$ref: '#/components/schemas/nexthop'
prefix:
$ref: '#/components/schemas/prefix'
priority:
$ref: '#/components/schemas/route_components-schemas-priority'
scope:
$ref: '#/components/schemas/schemas-scope'
weight:
$ref: '#/components/schemas/schemas-weight'
route_components-schemas-created_on:
type: string
format: date-time
description: When the route was created.
example: "2017-06-14T00:00:00Z"
readOnly: true
route_components-schemas-description:
type: string
description: An optional human provided description of the static route.
example: New route for new prefix 203.0.113.1
route_components-schemas-identifier:
type: string
description: Route identifier tag.
example: c4a7362d577a6c3019a474fd6f485821
readOnly: true
maxLength: 32
route_components-schemas-modified_on:
type: string
format: date-time
description: When the route was last modified.
example: "2017-06-14T05:20:00Z"
readOnly: true
route_components-schemas-priority:
type: integer
description: Priority of the static route.
route_deleted_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
deleted:
type: boolean
example: true
deleted_route:
type: object
route_modified_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_route:
type: object
route_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/teamnet'
route_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
route_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
route:
type: object
route_update_many_request:
type: object
required:
- routes
properties:
routes:
type: array
items:
$ref: '#/components/schemas/route_update_single_request'
route_update_request:
allOf:
- $ref: '#/components/schemas/route_add_single_request'
route_update_single_request:
allOf:
- required:
- id
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
- $ref: '#/components/schemas/route_add_single_request'
routes:
type: object
required:
- id
- pattern
- script
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
pattern:
$ref: '#/components/schemas/pattern'
script:
$ref: '#/components/schemas/schemas-script_name'
routes_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
routes:
type: array
items:
$ref: '#/components/schemas/schemas-route'
rule:
type: object
required:
- id
- mode
- allowed_modes
- configuration
properties:
allowed_modes:
type: array
description: The available actions that a rule can apply to a matched request.
example:
- whitelist
- block
- challenge
- js_challenge
- managed_challenge
readOnly: true
items:
$ref: '#/components/schemas/schemas-mode'
configuration:
$ref: '#/components/schemas/schemas-configuration'
created_on:
type: string
format: date-time
description: The timestamp of when the rule was created.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
id:
$ref: '#/components/schemas/rule_components-schemas-identifier'
mode:
$ref: '#/components/schemas/schemas-mode'
modified_on:
type: string
format: date-time
description: The timestamp of when the rule was last modified.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
notes:
$ref: '#/components/schemas/notes'
rule-settings:
type: object
description: Additional settings that modify the rule's action.
properties:
add_headers:
type: object
description: Add custom headers to allowed requests, in the form of key-value
pairs. Keys are header names, pointing to an array with its header value(s).
example:
My-Next-Header:
- foo
- bar
X-Custom-Header-Name:
- somecustomvalue
biso_admin_controls:
type: object
description: Configure how browser isolation behaves.
properties:
dcp:
type: boolean
description: Disable copy-paste.
example: false
dd:
type: boolean
description: Disable download.
example: false
dk:
type: boolean
description: Disable keyboard usage.
example: false
dp:
type: boolean
description: Disable printing.
example: false
du:
type: boolean
description: Disable upload.
example: false
block_page_enabled:
type: boolean
description: Enable the custom block page.
example: true
block_reason:
type: string
description: The text describing why this block occurred that will be displayed
on the custom block page (if enabled).
example: This website is a security risk
check_session:
type: object
description: Configure how session check behaves.
properties:
duration:
type: string
description: Configure how fresh the session needs to be to be considered
valid.
example: 300s
enforce:
type: boolean
description: Enable session enforcement for this fule.
example: true
insecure_disable_dnssec_validation:
type: boolean
description: INSECURE - disable DNSSEC validation (for allow actions).
example: false
ip_categories:
type: boolean
description: Include IPs in DNS resolver category blocks. By default categories
only block on domain names.
example: true
l4override:
type: object
description: Send matching traffic to the supplied destination IP address
and port.
properties:
ip:
type: string
description: IPv4 or IPv6 address.
example: 1.1.1.1
port:
type: integer
description: A port number to use for TCP/UDP overrides.
override_host:
type: string
description: Override matching DNS queries with this.
example: example.com
override_ips:
type: array
description: Override matching DNS queries with this.
example:
- 1.1.1.1
- 2.2.2.2
items:
type: string
description: IPv4 or IPv6 address.
example: 1.1.1.1
rule_action:
type: string
description: The action to take when the expression matches.
enum:
- bypass_waiting_room
example: bypass_waiting_room
rule_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/rule'
rule_components-schemas-base:
properties:
description:
$ref: '#/components/schemas/rule_components-schemas-description'
group:
type: object
description: The rule group to which the current WAF rule belongs.
readOnly: true
properties:
id:
$ref: '#/components/schemas/group_components-schemas-identifier'
name:
$ref: '#/components/schemas/group_components-schemas-name'
id:
$ref: '#/components/schemas/rule_components-schemas-identifier-2'
package_id:
$ref: '#/components/schemas/package_components-schemas-identifier'
priority:
$ref: '#/components/schemas/rule_components-schemas-priority'
rule_components-schemas-base-2:
allOf:
- $ref: '#/components/schemas/rule_components-schemas-base'
rule_components-schemas-description:
type: string
description: The public description of the WAF rule.
example: SQL injection prevention for SELECT statements
readOnly: true
rule_components-schemas-identifier:
type: string
description: The unique identifier of the IP Access rule.
example: 92f17202ed8bd63d69a66b86a49a8f6b
readOnly: true
maxLength: 32
rule_components-schemas-identifier-2:
type: string
description: The unique identifier of the WAF rule.
example: f939de3be84e66e757adcdcb87908023
readOnly: true
maxLength: 32
rule_components-schemas-priority:
type: string
description: The order in which the individual WAF rule is executed within its
rule group.
readOnly: true
rule_components-schemas-rule:
oneOf:
- $ref: '#/components/schemas/email_rule'
- $ref: '#/components/schemas/domain_rule'
- $ref: '#/components/schemas/everyone_rule'
- $ref: '#/components/schemas/ip_rule'
- $ref: '#/components/schemas/ip_list_rule'
- $ref: '#/components/schemas/certificate_rule'
- $ref: '#/components/schemas/access_group_rule'
- $ref: '#/components/schemas/azure_group_rule'
- $ref: '#/components/schemas/github_organization_rule'
- $ref: '#/components/schemas/gsuite_group_rule'
- $ref: '#/components/schemas/okta_group_rule'
- $ref: '#/components/schemas/saml_group_rule'
type: object
rule_description:
type: string
description: The description of the rule.
default: ""
example: allow all traffic from 10.20.30.40
rule_enabled:
type: boolean
description: When set to true, the rule is enabled.
default: true
example: true
rule_expression:
type: string
description: Criteria defining when there is a match for the current rule.
example: ip.src in {10.20.30.40}
rule_group_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-group'
rule_group_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
rule_id:
type: string
description: The ID of the rule.
example: 25756b2dfe6e378a06b033b670413757
rule_identifier:
type: string
description: Routing rule identifier.
example: a7e6fb77503c41d8a7f3113c6918f10c
readOnly: true
maxLength: 32
rule_position:
oneOf:
- type: object
properties:
index:
type: integer
description: ' Places the rule in the exact position specified by the
integer number . Position numbers start with 1. Existing
rules in the ruleset from the specified position number onward are shifted
one position (no rule is overwritten).'
- type: object
properties:
before:
type: string
description: ' Places the rule before rule . Use this argument
with an empty rule ID value ("") to set the rule as the first rule in
the ruleset.'
example:
- type: object
properties:
after:
type: string
description: Places the rule after rule . Use this argument with
an empty rule ID value ("") to set the rule as the last rule in the
ruleset.
example:
type: object
description: Reorder the position of a rule
rule_properties:
type: object
properties:
actions:
$ref: '#/components/schemas/actions'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled'
matchers:
$ref: '#/components/schemas/matchers'
name:
$ref: '#/components/schemas/rules_components-schemas-name'
priority:
$ref: '#/components/schemas/components-schemas-priority'
tag:
$ref: '#/components/schemas/rule_identifier'
rule_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-rule'
rule_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
rule_result:
type: object
properties:
action:
$ref: '#/components/schemas/rule_action'
description:
$ref: '#/components/schemas/rule_description'
enabled:
$ref: '#/components/schemas/rule_enabled'
expression:
$ref: '#/components/schemas/rule_expression'
id:
$ref: '#/components/schemas/rule_id'
last_updated:
$ref: '#/components/schemas/timestamp'
version:
$ref: '#/components/schemas/rule_version'
rule_single_id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/rule_components-schemas-identifier'
rule_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/rule'
rule_version:
type: string
description: The version of the rule.
example: "1"
rules:
allOf:
- $ref: '#/components/schemas/rule_properties'
type: object
rules_components-schemas-account_identifier:
example: 6f91088a406011ed95aed352566e8d4c
rules_components-schemas-action:
type: string
description: The action to perform when the rule matches.
example: execute
pattern: ^[a-z_]+$
rules_components-schemas-action-2:
type: string
description: The action to preform when the associated traffic, identity, and
device posture expressions are either absent or evaluate to 'true'.
enum:
- "on"
- "off"
- allow
- block
- scan
- noscan
- safesearch
- ytrestricted
- isolate
- noisolate
- override
- l4_override
example: allow
rules_components-schemas-description:
type: string
description: An informative description of the rule.
default: ""
example: Execute the OWASP ruleset when the IP address is not 1.1.1.1
rules_components-schemas-description-2:
type: string
description: The description of the Rule.
example: Block the bad websites based on host name
rules_components-schemas-empty_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
rules_components-schemas-enabled:
type: boolean
description: Routing rule status.
enum:
- true
- false
default: true
example: true
rules_components-schemas-enabled-2:
type: boolean
description: Whether the rule should be executed.
default: "true"
example: true
rules_components-schemas-enabled-3:
type: boolean
description: Set if the rule is enabled.
example: true
rules_components-schemas-id:
type: string
description: The unique ID of the rule.
example: 3a03d665bac047339bb530ecb439a90d
rules_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
rules_components-schemas-name:
type: string
description: Routing rule name.
example: Send to user@example.net rule.
maxLength: 256
rules_components-schemas-name-2:
type: string
description: The name of the Rule.
example: block bad websites
rules_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/rules_components-schemas-rules'
rules_components-schemas-rule:
type: object
description: A rule object.
properties:
action:
$ref: '#/components/schemas/rules_components-schemas-action'
action_parameters:
$ref: '#/components/schemas/action_parameters'
categories:
$ref: '#/components/schemas/categories'
description:
$ref: '#/components/schemas/rules_components-schemas-description'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled-2'
expression:
$ref: '#/components/schemas/schemas-expression'
id:
$ref: '#/components/schemas/rules_components-schemas-id'
last_updated:
$ref: '#/components/schemas/schemas-last_updated'
logging:
$ref: '#/components/schemas/logging'
ref:
$ref: '#/components/schemas/components-schemas-ref'
version:
$ref: '#/components/schemas/schemas-version'
rules_components-schemas-rules:
type: object
properties:
action:
$ref: '#/components/schemas/rules_components-schemas-action-2'
created_at:
$ref: '#/components/schemas/timestamp'
deleted_at:
$ref: '#/components/schemas/deleted_at'
description:
$ref: '#/components/schemas/rules_components-schemas-description-2'
device_posture:
$ref: '#/components/schemas/device_posture'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled-3'
filters:
$ref: '#/components/schemas/schemas-filters'
id:
$ref: '#/components/schemas/rules_components-schemas-uuid'
identity:
$ref: '#/components/schemas/identity'
name:
$ref: '#/components/schemas/rules_components-schemas-name-2'
precedence:
$ref: '#/components/schemas/schemas-precedence'
rule_settings:
$ref: '#/components/schemas/rule-settings'
traffic:
$ref: '#/components/schemas/traffic'
updated_at:
$ref: '#/components/schemas/timestamp'
rules_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/rules_components-schemas-rules'
rules_components-schemas-uuid:
type: string
description: API Resource UUID tag.
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
maxLength: 36
rules_count:
type: number
description: The number of rules in the current rule group.
default: 0
example: 10
readOnly: true
rules_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/rules'
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 20
total_count:
example: 1
ruleset:
type: object
description: A ruleset object.
properties:
description:
$ref: '#/components/schemas/rulesets_components-schemas-description'
id:
$ref: '#/components/schemas/rulesets_components-schemas-id'
kind:
$ref: '#/components/schemas/schemas-kind'
last_updated:
$ref: '#/components/schemas/last_updated'
name:
$ref: '#/components/schemas/rulesets_components-schemas-name'
phase:
$ref: '#/components/schemas/phase'
rules:
$ref: '#/components/schemas/components-schemas-rules'
version:
$ref: '#/components/schemas/version'
ruleset_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
$ref: '#/components/schemas/ruleset'
ruleset_without_rules:
type: object
description: A ruleset object.
properties:
description:
$ref: '#/components/schemas/rulesets_components-schemas-description'
id:
$ref: '#/components/schemas/rulesets_components-schemas-id'
kind:
$ref: '#/components/schemas/schemas-kind'
last_updated:
$ref: '#/components/schemas/last_updated'
name:
$ref: '#/components/schemas/rulesets_components-schemas-name'
phase:
$ref: '#/components/schemas/phase'
version:
$ref: '#/components/schemas/version'
rulesets_components-schemas-description:
type: string
description: An informative description of the ruleset.
default: ""
example: My ruleset to execute managed rulesets
rulesets_components-schemas-id:
type: string
description: The unique ID of the ruleset.
example: 2f2feab2026849078ba485f918791bdc
pattern: ^[0-9a-f]{32}$
rulesets_components-schemas-name:
type: string
description: The human-readable name of the ruleset.
example: My ruleset
rulesets_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: array
description: A list of rulesets. The returned information will not include
the rules in each ruleset.
items:
$ref: '#/components/schemas/ruleset_without_rules'
run_at:
type: string
format: date-time
description: Timestamp of when the tunnel connection was started.
example: "2009-11-10T23:00:00Z"
saas_app:
type: object
properties:
consumer_service_url:
type: string
description: The service provider's endpoint that is responsible for receiving
and parsing a SAML assertion.
example: https://example.com
created_at:
$ref: '#/components/schemas/timestamp'
custom_attributes:
type: object
properties:
name:
type: string
description: The name of the attribute.
example: family_name
name_format:
type: string
description: A globally unique name for an identity or service provider.
enum:
- urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified
- urn:oasis:names:tc:SAML:2.0:attrname-format:basic
- urn:oasis:names:tc:SAML:2.0:attrname-format:uri
example: urn:oasis:names:tc:SAML:2.0:attrname-format:basic
source:
type: object
properties:
name:
type: string
description: The name of the IdP attribute.
example: last_name
idp_entity_id:
type: string
description: The unique identifier for your SaaS application.
example: https://example.cloudflareaccess.com
name_id_format:
type: string
description: The format of the name identifier sent to the SaaS application.
enum:
- id
- email
example: id
public_key:
type: string
description: The Access public certificate that will be used to verify your
identity.
example: example unique name
sp_entity_id:
type: string
description: A globally unique name for an identity or service provider.
example: example unique name
sso_endpoint:
type: string
description: The endpoint where your SaaS application will send login requests.
example: https://example.cloudflareaccess.com/cdn-cgi/access/sso/saml/b3f58a2b414e0b51d45c8c2af26fccca0e27c63763c426fa52f98dcf0b3b3bfd
updated_at:
$ref: '#/components/schemas/timestamp'
saas_props:
type: object
title: SaaS Application
properties:
allowed_idps:
$ref: '#/components/schemas/allowed_idps'
app_launcher_visible:
$ref: '#/components/schemas/app_launcher_visible'
auto_redirect_to_identity:
$ref: '#/components/schemas/auto_redirect_to_identity'
logo_url:
$ref: '#/components/schemas/logo_url'
name:
$ref: '#/components/schemas/apps_components-schemas-name'
saas_app:
$ref: '#/components/schemas/saas_app'
type:
type: string
description: The application type.
example: saas
same_site_cookie_attribute:
type: string
description: Sets the SameSite cookie setting, which provides increased security
against CSRF attacks.
example: strict
saml_group_rule:
type: object
title: SAML group
description: |-
Matches a SAML group.
Requires a SAML identity provider.
required:
- saml
properties:
saml:
type: object
required:
- attribute_name
- attribute_value
properties:
attribute_name:
type: string
description: The name of the SAML attribute.
example: group
attribute_value:
type: string
description: The SAML attribute value to look for.
example: devs@cloudflare.com
scale:
type: number
description: The size of the image relative to the overall size of the video.
This parameter will adapt to horizontal and vertical videos automatically.
`0.0` indicates no scaling (use the size of the image as-is), and `1.0 `fills
the entire video.
default: 0.15
example: 0.1
readOnly: true
minimum: 0
maximum: 1
schedule:
type: string
description: 'Polling frequency for the WARP client posture check. Default:
`5m` (poll every five minutes). Minimum: `1m`.'
example: 1h
schema_response_discovery:
allOf:
- $ref: '#/components/schemas/default_response'
- properties:
result:
type: object
properties:
schemas:
type: array
items:
$ref: '#/components/schemas/openapi'
timestamp:
type: string
schema_response_with_thresholds:
allOf:
- $ref: '#/components/schemas/default_response'
- properties:
result:
type: object
properties:
schemas:
type: array
items:
$ref: '#/components/schemas/openapiwiththresholds'
timestamp:
type: string
schemas-access_seat:
type: boolean
description: True if the user has authenticated with Cloudflare Access.
example: false
schemas-account:
allOf:
- $ref: '#/components/schemas/account'
readOnly: true
schemas-account_identifier:
example: 01a7362d577a6c3019a474fd6f485823
schemas-action:
type: object
description: Actions pattern.
required:
- type
- value
properties:
type:
type: string
description: Type of supported action.
enum:
- forward
- worker
example: forward
value:
type: array
items:
type: string
description: Value for action.
example: destinationaddress@example.net
maxLength: 90
schemas-action_parameters:
oneOf:
- $ref: '#/components/schemas/action_parameters_rewrite'
type: object
description: The parameters configuring the action.
schemas-actions:
type: array
description: The set of actions to perform if the targets of this rule match
the request. Actions can redirect to another URL or override settings, but
not both.
example:
- id: browser_check
value: "on"
items:
oneOf:
- $ref: '#/components/schemas/route'
schemas-address:
type: string
description: The hostname or IP address of the origin server to run health checks
on.
example: www.example.com
schemas-advertised:
type: boolean
description: Enablement of prefix advertisement to the Internet.
example: true
schemas-alert_type:
type: string
description: Type of notification that has been dispatched.
example: universal_ssl_event_type
schemas-allowed:
type: boolean
description: The result of the authentication event.
default: false
schemas-app_id:
example: 699d98642c564d2e855e9661899b7252
schemas-app_launcher_visible:
type: boolean
description: Displays the application in the App Launcher.
example: true
schemas-application:
type: object
description: Application that the hostname belongs to.
properties:
id:
type: integer
name:
type: string
example: CLOUDFLARE
schemas-apps:
anyOf:
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/self_hosted_props'
type: object
title: Self Hosted Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/saas_props'
type: object
title: SaaS Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/ssh_props'
type: object
title: Browser SSH Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/vnc_props'
type: object
title: Browser VNC Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/app_launcher_props'
type: object
title: App Launcher Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/warp_props'
type: object
title: Device Enrollment Permissions Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/biso_props'
type: object
title: Browser Isolation Permissions Application
- allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/schemas-bookmark_props'
type: object
title: Bookmark application
type: object
schemas-asn:
type: string
description: AS number associated with the node object.
schemas-aud:
type: string
description: Audience tag.
example: 737646a56ab1df6ec9bddc7e5ca84eaf3b0768850f3ffb5d74f1534911fe3893
readOnly: true
maxLength: 64
schemas-automatic_platform_optimization:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- automatic_platform_optimization
example: automatic_platform_optimization
value:
$ref: '#/components/schemas/automatic_platform_optimization'
title: Automatic Platform Optimization for WordPress
description: '[Automatic Platform Optimization for WordPress](https://developers.cloudflare.com/automatic-platform-optimization/)
serves your WordPress site from Cloudflare''s edge network and caches third-party
fonts.'
schemas-available:
type: boolean
description: Shows if a domain is available for transferring into Cloudflare
Registrar.
example: false
schemas-base:
required:
- id
- value
properties:
editable:
type: boolean
description: Whether or not this setting can be modified for this zone (based
on your Cloudflare plan level).
enum:
- true
- false
default: true
readOnly: true
id:
type: string
description: Identifier of the zone setting.
example: development_mode
modified_on:
type: string
format: date-time
description: last time this setting was modified.
example: "2014-01-01T05:20:00.12345Z"
nullable: true
readOnly: true
value:
anyOf:
- type: string
- type: number
- type: object
- type: array
items: {}
description: Current value of the zone setting.
example: "on"
schemas-bookmark_props:
type: object
title: Bookmark Application
properties:
app_launcher_visible:
default: true
domain:
description: The URL or domain of the bookmark.
example: https://mybookmark.com
logo_url:
$ref: '#/components/schemas/logo_url'
name:
$ref: '#/components/schemas/apps_components-schemas-name'
type:
type: string
description: The application type.
example: bookmark
schemas-can_delete:
type: boolean
description: Controls whether the membership can be deleted via the API or not.
example: true
schemas-categories:
type: object
readOnly: true
properties:
beta:
$ref: '#/components/schemas/beta'
class:
$ref: '#/components/schemas/class'
description:
$ref: '#/components/schemas/categories_components-schemas-description'
id:
$ref: '#/components/schemas/categories_components-schemas-id'
name:
$ref: '#/components/schemas/categories_components-schemas-name'
subcategories:
type: array
description: All subcategories for this category.
items:
$ref: '#/components/schemas/subcategory'
schemas-certificate:
type: string
description: The zone's SSL certificate or SSL certificate and intermediate(s).
example: '-----BEGIN CERTIFICATE----- MIIDtTCCAp2gAwIBAgIJAM15n7fdxhRtMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
BAYTAlVTMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX aWRnaXRzIFB0eSBMdGQwHhcNMTQwMzExMTkyMTU5WhcNMTQwNDEwMTkyMTU5WjBF
MQswCQYDVQQGEwJVUzETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50 ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAvq3sKsHpeduJHimOK+fvQdKsI8z8A05MZyyLp2/R/GE8FjNv+hkVY1WQ LIyTNNQH7CJecE1nbTfo8Y56S7x/rhxC6/DJ8MIulapFPnorq46KU6yRxiM0MQ3N
nTJHlHA2ozZta6YBBfVfhHWl1F0IfNbXCLKvGwWWMbCx43OfW6KTkbRnE6gFWKuO fSO5h2u5TaWVuSIzBvYs7Vza6m+gtYAvKAJV2nSZ+eSEFPDo29corOy8+huEOUL8
5FAw4BFPsr1TlrlGPFitduQUHGrSL7skk1ESGza0to3bOtrodKei2s9bk5MXm7lZ qI+WZJX4Zu9+mzZhc9pCVi8r/qlXuQIDAQABo4GnMIGkMB0GA1UdDgQWBBRvavf+
sWM4IwKiH9X9w1vl6nUVRDB1BgNVHSMEbjBsgBRvavf+sWM4IwKiH9X9w1vl6nUV RKFJpEcwRTELMAkGA1UEBhMCVVMxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV
BAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAM15n7fdxhRtMAwGA1UdEwQF MAMBAf8wDQYJKoZIhvcNAQEFBQADggEBABY2ZzBaW0dMsAAT7tPJzrVWVzQx6KU4
UEBLudIlWPlkAwTnINCWR/8eNjCCmGA4heUdHmazdpPa8RzwOmc0NT1NQqzSyktt vTqb4iHD7+8f9MqJ9/FssCfTtqr/Qst/hGH4Wmdf1EJ/6FqYAAb5iRlPgshFZxU8
uXtA8hWn6fK6eISD9HBdcAFToUvKNZ1BIDPvh9f95Ine8ar6yGd56TUNrHR8eHBs ESxz5ddVR/oWRysNJ+aGAyYqHS8S/ttmC7r4XCAHqXptkHPCGRqkAhsterYhd4I8
/cBzejUobNCjjHFbtkAL/SjxZOLW+pNkZwfeYdM8iPkD54Uua1v2tdw= -----END CERTIFICATE-----'
schemas-certificate_authority:
type: string
description: The Certificate Authority that Total TLS certificates will be issued
through.
enum:
- google
- lets_encrypt
example: google
schemas-certificate_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/certificates'
schemas-certificate_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
schemas-certificateObject:
properties:
certificate:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate'
expires_on:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-expires_on'
id:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
issuer:
$ref: '#/components/schemas/issuer'
serial_number:
$ref: '#/components/schemas/serial_number'
signature:
$ref: '#/components/schemas/signature'
status:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-status'
uploaded_on:
$ref: '#/components/schemas/components-schemas-uploaded_on'
schemas-certificates:
type: object
properties:
associated_hostnames:
$ref: '#/components/schemas/associated_hostnames'
created_at:
$ref: '#/components/schemas/timestamp'
expires_on:
$ref: '#/components/schemas/timestamp'
fingerprint:
$ref: '#/components/schemas/fingerprint'
id:
description: The ID of the application that will use this certificate.
name:
$ref: '#/components/schemas/certificates_components-schemas-name'
updated_at:
$ref: '#/components/schemas/timestamp'
schemas-check_regions:
type: array
description: A list of regions from which to run health checks. Null means Cloudflare
will pick a default region.
example:
- WEU
- ENAM
nullable: true
items:
type: string
description: 'WNAM: Western North America, ENAM: Eastern North America, WEU:
Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM:
Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa,
SAF: South Africa, IN: India, SEAS: South East Asia, NEAS: North East Asia,
ALL_REGIONS: all regions (BUSINESS and ENTERPRISE customers only).'
enum:
- WNAM
- ENAM
- WEU
- EEU
- NSAM
- SSAM
- OC
- ME
- NAF
- SAF
- IN
- SEAS
- NEAS
- ALL_REGIONS
schemas-cidr_configuration:
title: An IP address range configuration.
properties:
target:
description: The configuration target. You must set the target to `ip_range`
when specifying an IP address range in the Zone Lockdown rule.
enum:
- ip_range
example: ip_range
value:
type: string
description: The IP address range to match. You can only use prefix lengths
`/16` and `/24`.
example: 198.51.100.4/16
schemas-collection_invite_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-invite'
schemas-collection_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
properties:
additional_information:
$ref: '#/components/schemas/additional_information'
application:
$ref: '#/components/schemas/schemas-application'
content_categories:
$ref: '#/components/schemas/content_categories'
domain:
$ref: '#/components/schemas/schemas-domain_name'
popularity_rank:
$ref: '#/components/schemas/popularity_rank'
risk_score:
$ref: '#/components/schemas/risk_score'
risk_types:
$ref: '#/components/schemas/risk_types'
schemas-colo_name:
type: string
description: The Cloudflare data center used for this connection.
example: DFW
schemas-comment:
type: string
description: Optional remark describing the virtual network.
example: Staging VPC for data science
schemas-component_values:
type: array
description: Array of available components values for the plan.
items:
$ref: '#/components/schemas/component-value'
schemas-config:
type: object
description: The configuration parameters for the identity provider. To view
the required parameters for a specific provider, refer to our [developer documentation](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/).
schemas-configuration:
oneOf:
- $ref: '#/components/schemas/ip_configuration'
- $ref: '#/components/schemas/ipv6_configuration'
- $ref: '#/components/schemas/cidr_configuration'
- $ref: '#/components/schemas/asn_configuration'
- $ref: '#/components/schemas/country_configuration'
type: object
description: The rule configuration.
schemas-connection:
type: object
required:
- id
- zone
- enabled
properties:
created_on:
$ref: '#/components/schemas/connection_components-schemas-created_on'
enabled:
$ref: '#/components/schemas/connection_components-schemas-enabled'
id:
$ref: '#/components/schemas/connection_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/connection_components-schemas-modified_on'
zone:
$ref: '#/components/schemas/connection_components-schemas-zone'
schemas-count:
type: number
description: Total results returned based on your search parameters.
example: 1
schemas-create:
type: object
required:
- name
- account
properties:
account:
type: object
description: Account in which the zone was created.
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
$ref: '#/components/schemas/properties-name'
type:
$ref: '#/components/schemas/components-schemas-type'
schemas-created:
type: string
format: date-time
description: The date and time the media item was created.
example: "2014-01-02T02:20:00Z"
readOnly: true
schemas-created_at:
type: string
format: date-time
description: The time when the certificate was created.
example: "2100-01-01T05:20:00Z"
readOnly: true
schemas-created_on:
type: string
format: date-time
description: The timestamp of when the rule was created.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
schemas-cursor:
type: string
description: Opaque token indicating the position from which to continue when
requesting the next set of records. A valid value for the cursor can be obtained
from the cursors object in the result_info structure.
example: AAAAANuhDN7SjacTnSVsDu3WW1Lvst6dxJGTjRY5BhxPXdf6L6uTcpd_NVtjhn11OUYRsVEykxoUwF-JQU4dn6QylZSKTOJuG0indrdn_MlHpMRtsxgXjs-RPdHYIVm3odE_uvEQ_dTQGFm8oikZMohns34DLBgrQpc
schemas-default:
type: boolean
description: Whether the policy is the default policy for an account.
example: false
schemas-deleted:
type: boolean
description: True if the device was deleted.
example: true
schemas-deleted_at:
type: string
format: date-time
description: Timestamp of when the tunnel was deleted. If `null`, the tunnel
has not been deleted.
example: "2009-11-10T23:00:00Z"
nullable: true
schemas-deleted_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
example: {}
schemas-description:
type: string
description: The billing item description.
example: The billing item description
readOnly: true
maxLength: 255
schemas-direct_upload_request:
type: object
properties:
expiry:
type: string
format: date-time
description: 'The date after which the upload will not be accepted. Minimum:
Now + 2 minutes. Maximum: Now + 6 hours.'
default: Now + 30 minutes
example: "2021-01-02T02:20:00Z"
schemas-direct_upload_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/images_components-schemas-identifier'
uploadURL:
type: string
description: The URL the unauthenticated upload can be performed to
using a single HTTP POST (multipart/form-data) request.
example: https://upload.imagedelivery.net/e22e9e6b-c02b-42fd-c405-6c32af5fe623
schemas-disabled_at:
type: string
format: date-time
description: This field shows up only if the pool is disabled. This field is
set with the time the pool was disabled at.
readOnly: true
schemas-dns-firewall:
allOf:
- $ref: '#/components/schemas/dns-firewall'
type: object
schemas-dns-record:
type: object
description: List of records needed to enable an Email Routing zone.
properties:
content:
type: string
description: DNS record content.
example: 127.0.0.1
name:
type: string
description: DNS record name (or @ for the zone apex).
example: example.com
maxLength: 255
priority:
type: number
description: Required for MX, SRV and URI records. Unused by other record
types. Records with lower priorities are preferred.
example: 10
minimum: 0
maximum: 65535
ttl:
anyOf:
- type: number
example: 3600
minimum: 60
maximum: 86400
- type: number
enum:
- 1
type: number
description: Time to live, in seconds, of the DNS record. Must be between
60 and 86400, or 1 for 'automatic'.
example: 3600
type:
type: string
description: DNS record type.
enum:
- A
- AAAA
- CNAME
- HTTPS
- TXT
- SRV
- LOC
- MX
- NS
- CERT
- DNSKEY
- DS
- NAPTR
- SMIMEA
- SSHFP
- SVCB
- TLSA
- URI
example: A
readOnly: true
schemas-domain:
type: string
description: The domain and path that Access will secure.
example: test.example.com/admin
schemas-domain_identifier:
type: string
description: Domain identifier.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
schemas-domain_name:
type: string
example: cloudflare.com
schemas-duration:
type: integer
description: The duration of the video in seconds. A value of `-1` means the
duration is unknown. The duration becomes available after the upload and before
the video is ready.
readOnly: true
schemas-email:
type: string
format: email
description: The email address of the authenticating user.
example: user@example.com
schemas-empty_response:
allOf:
- properties:
result:
type: boolean
enum:
- true
- false
example: true
success:
type: boolean
enum:
- true
- false
example: true
schemas-enabled:
type: boolean
description: Whether or not the Keyless SSL is on or off.
example: false
readOnly: true
schemas-exclude:
type: array
description: Rules evaluated with a NOT logical operator. To match the policy,
a user cannot meet any of the Exclude rules.
items:
$ref: '#/components/schemas/rule_components-schemas-rule'
schemas-expected_codes:
type: string
description: The expected HTTP response codes or code ranges of the health check,
comma-separated. This parameter is only valid for HTTP and HTTPS monitors.
default: "200"
example: 2xx
schemas-expiration:
type: string
description: Sets the expiration time for a posture check result. If empty,
the result remains valid until it is overwritten by new data from the WARP
client.
example: 1h
schemas-expires_on:
type: string
format: date-time
description: When the invite is no longer active.
example: "2014-01-01T05:20:00Z"
readOnly: true
schemas-expression:
type: string
description: The expression defining which traffic will match the rule.
example: ip.src ne 1.1.1.1
schemas-features:
type: array
description: Features enabled for the Cloudflare Tunnel.
items:
type: string
example: ha-origin
schemas-filter-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
allOf:
- $ref: '#/components/schemas/filter'
- type: object
required:
- id
- expression
- paused
schemas-filter-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
oneOf:
- allOf:
- $ref: '#/components/schemas/filter'
- type: object
required:
- id
- expression
- paused
- nullable: true
schemas-filter_options:
type: array
description: 'Format of additional configuration options (filters) for the alert
type. Data type of filters during policy creation: Array of strings.'
example:
- ComparisonOperator: ==
Key: zones
Optional: false
- ComparisonOperator: '>='
Key: slo
Optional: true
items: {}
schemas-filters:
type: array
description: The protocol or layer to evaluate the traffic, identity, and device
posture expressions.
example:
- http
items:
type: string
description: The protocol or layer to use.
enum:
- http
- dns
- l4
example: http
schemas-force_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/schemas-force_result'
schemas-force_result:
type: string
description: When force_notify query parameter is set to true, the response
is a simple string
example: OK
schemas-frequency:
type: string
description: The frequency at which you will be billed for this plan.
enum:
- weekly
- monthly
- quarterly
- yearly
example: monthly
readOnly: true
schemas-gateway_seat:
type: boolean
description: True if the user has logged into the WARP client.
example: false
schemas-group:
allOf:
- $ref: '#/components/schemas/group'
- properties:
allowed_modes:
$ref: '#/components/schemas/allowed_modes'
mode:
$ref: '#/components/schemas/components-schemas-mode'
type: object
required:
- id
- name
- description
- mode
- rules_count
schemas-groups:
type: object
properties:
created_at:
$ref: '#/components/schemas/timestamp'
exclude:
$ref: '#/components/schemas/exclude'
id:
$ref: '#/components/schemas/schemas-uuid'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/groups_components-schemas-name'
require:
$ref: '#/components/schemas/require'
updated_at:
$ref: '#/components/schemas/timestamp'
schemas-header:
type: object
description: The request header is used to pass additional information with
an HTTP request. Currently supported header is 'Host'.
properties:
Host:
$ref: '#/components/schemas/Host'
schemas-health_check:
type: object
properties:
enabled:
type: boolean
description: Determines whether to run healthchecks for a tunnel.
default: true
example: true
target:
type: string
description: The address used to run healthchecks for a tunnel.
example: 203.0.113.1
type:
type: string
description: The type of healthcheck to run, reply or request. The default
value is `reply`.
enum:
- reply
- request
default: reply
example: request
schemas-height:
type: number
description: Maximum height in image pixels.
example: 768
minimum: 1
schemas-host:
type: string
format: hostname
description: The keyless SSL name.
example: example.com
maxLength: 253
schemas-hostname:
type: string
description: The hostname on the origin for which the client certificate uploaded
will be used.
example: app.example.com
maxLength: 255
schemas-hosts:
type: array
description: Comma separated list of valid host names for the certificate packs.
Must contain the zone apex, may not contain more than 50 hosts, and may not
be empty.
example:
- example.com
- '*.example.com'
- www.example.com
items:
type: string
schemas-id:
type: string
description: Identifier of a recommedation result.
example: ssl_recommendation
schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
schemas-identifier: {}
schemas-include:
type: array
items:
$ref: '#/components/schemas/split_tunnel_include'
schemas-input:
type: object
description: The value to be checked against.
properties:
id:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
schemas-interval:
type: string
description: The interval between each posture check with the third party API.
Use "m" for minutes (e.g. "5m") and "h" for hours (e.g. "12h").
example: 10m
schemas-invite:
allOf:
- $ref: '#/components/schemas/user_invite'
type: object
schemas-ip:
type: string
description: An IPv4 or IPv6 address.
example: 192.0.2.1
schemas-ip_configuration:
title: An IP address configuration.
properties:
target:
description: The configuration target. You must set the target to `ip` when
specifying an IP address in the Zone Lockdown rule.
enum:
- ip
example: ip
value:
type: string
description: The IP address to match. This address will be compared to the
IP address of incoming requests.
example: 198.51.100.4
schemas-ips:
type: array
description: The set of IPs on the Address Map.
items:
$ref: '#/components/schemas/address-maps-ip'
schemas-ipv6:
type: string
format: ipv6
example: '2001:0DB8::'
schemas-items:
type: array
description: The items in the List.
items:
type: object
properties:
created_at:
$ref: '#/components/schemas/timestamp'
value:
$ref: '#/components/schemas/lists_components-schemas-value'
schemas-key:
type: string
description: The device's public key.
example: yek0SUYoOQ10vMGsIYAevozXUQpQtNFJFfFGqER/BGc=
schemas-key_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/keys_response'
schemas-keys:
type: object
properties:
name:
$ref: '#/components/schemas/keys_components-schemas-name'
value:
$ref: '#/components/schemas/keys_components-schemas-value'
schemas-kind:
type: string
description: The kind of the ruleset.
enum:
- custom
- root
- zone
example: root
schemas-last_updated:
type: string
description: The timestamp of when the rule was last modified.
example: "2000-01-01T00:00:00.000000Z"
schemas-match:
type: array
description: The conditions that the client must match to run the rule.
items:
$ref: '#/components/schemas/match_item'
schemas-maxDurationSeconds:
type: integer
description: Calculates the amount of time a video occupies before the video
is uploaded. Direct uploads occupy minutes of videos on your Stream account
until they are expired. After upload, the upload duration is used instead.
If a video longer than the value is uploaded, the video results in an error.
minimum: 1
maximum: 21600
schemas-media_metadata:
type: object
description: A user modifiable key-value store used to reference other systems
of record for managing videos.
example:
name: example_filename.mp4
schemas-member:
allOf:
- $ref: '#/components/schemas/member'
schemas-metadata:
type: string
description: What EXIF data should be preserved in the output image.
enum:
- keep
- copyright
- none
example: none
schemas-method:
type: string
description: The method to use for the health check. This defaults to 'GET'
for HTTP/HTTPS based checks and 'connection_established' for TCP based health
checks.
default: GET
example: GET
schemas-mode:
type: string
description: The action to apply to a matched request.
enum:
- block
- challenge
- whitelist
- js_challenge
- managed_challenge
example: challenge
schemas-modified:
type: string
format: date-time
description: The date and time the media item was last modified.
example: "2014-01-02T02:20:00Z"
readOnly: true
schemas-modified_on:
type: string
format: date-time
description: Last modification of DNS Firewall cluster.
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
schemas-modified_tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_ipsec_tunnels:
type: array
items:
$ref: '#/components/schemas/ipsec-tunnel'
schemas-monitor:
description: The ID of the Monitor to use for checking the health of origins
within this pool.
schemas-mtu:
type: integer
description: The Maximum Transmission Unit (MTU) in bytes for the interconnect.
The minimum value is 576.
default: 1476
schemas-name:
type: string
description: Organization name.
example: Cloudflare, Inc.
maxLength: 100
schemas-namespace:
type: object
properties:
class:
readOnly: true
id:
readOnly: true
name:
readOnly: true
script:
readOnly: true
schemas-negative_cache_ttl:
type: number
description: Negative DNS Cache TTL.
default: 900
example: 900
nullable: true
minimum: 30
maximum: 36000
schemas-operation:
type: object
required:
- id
- status
properties:
completed:
type: string
description: The RFC 3339 timestamp of when the operation was completed.
example: "2020-01-01T08:00:00Z"
readOnly: true
error:
type: string
description: A message describing the error when the status is `failed`.
example: This list is at the maximum number of items
readOnly: true
id:
$ref: '#/components/schemas/schemas-operation_id'
status:
type: string
description: The current status of the asynchronous operation.
enum:
- pending
- running
- completed
- failed
example: failed
readOnly: true
schemas-operation_id:
type: string
description: The unique operation ID of the asynchronous action.
example: 4da8780eeb215e6cb7f48dd981c4ea02
readOnly: true
schemas-options:
example:
max_ttl: 15
packet_type: icmp
properties:
max_ttl:
$ref: '#/components/schemas/max_ttl'
packet_type:
$ref: '#/components/schemas/packet_type'
packets_per_ttl:
$ref: '#/components/schemas/packets_per_ttl'
port:
$ref: '#/components/schemas/traceroute_components-schemas-port'
wait_time:
$ref: '#/components/schemas/wait_time'
schemas-organization:
type: string
description: Name of organization.
example: Cloudflare, Inc.
schemas-origin:
type: object
properties:
address:
$ref: '#/components/schemas/address'
disabled_at:
$ref: '#/components/schemas/disabled_at'
enabled:
$ref: '#/components/schemas/origin_components-schemas-enabled'
header:
$ref: '#/components/schemas/schemas-header'
name:
$ref: '#/components/schemas/origin_components-schemas-name'
weight:
$ref: '#/components/schemas/weight'
schemas-output:
properties:
allowedOrigins:
$ref: '#/components/schemas/allowedOrigins'
clippedFromVideoUID:
$ref: '#/components/schemas/clipped_from_video_uid'
created:
$ref: '#/components/schemas/clipping_components-schemas-created'
creator:
$ref: '#/components/schemas/creator'
endTimeSeconds:
$ref: '#/components/schemas/end_time_seconds'
maxDurationSeconds:
$ref: '#/components/schemas/schemas-maxDurationSeconds'
meta:
$ref: '#/components/schemas/schemas-media_metadata'
modified:
$ref: '#/components/schemas/components-schemas-modified'
playback:
$ref: '#/components/schemas/playback'
preview:
$ref: '#/components/schemas/preview'
requireSignedURLs:
$ref: '#/components/schemas/requireSignedURLs'
startTimeSeconds:
$ref: '#/components/schemas/start_time_seconds'
status:
$ref: '#/components/schemas/media_state'
thumbnailTimestampPct:
$ref: '#/components/schemas/thumbnailTimestampPct'
watermark:
$ref: '#/components/schemas/watermarkAtUpload'
schemas-patch:
type: object
example:
paused: true
properties:
paused:
$ref: '#/components/schemas/paused'
plan:
type: object
description: |-
(Deprecated) Please use the /zones/:identifier/subscription API to update a zone's plan.
The desired plan for the zone. Changing this value will create/cancel associated subscriptions. To view available plans for this zone, see Zone Plans.
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
type:
type: string
description: A full zone implies that DNS is hosted with Cloudflare. A partial
zone is typically a partner-hosted zone or a CNAME setup. This parameter
is only available to Enterprise customers or if it has been explicitly
enabled on a zone.
enum:
- full
- partial
example: full
vanity_name_servers:
$ref: '#/components/schemas/vanity_name_servers'
schemas-path:
type: string
description: Sets the path within the host to enable the waiting room on. The
waiting room will be enabled for all subpaths as well. If there are two waiting
rooms on the same subpath, the waiting room for the most specific path will
be chosen. Wildcards and query parameters are not supported.
default: /
example: /shop/checkout
schemas-pattern:
type: string
title: Filter pattern
example: example.net/*
schemas-paused:
type: boolean
description: When true, indicates that the WAF package is currently paused.
schemas-permissions:
type: array
description: Access permissions for this User.
readOnly: true
items:
type: string
example: '#zones:read'
maxLength: 160
schemas-phase:
type: string
description: The phase where the ruleset is executed.
enum:
- http_request_transform
- http_request_late_transform
- http_response_headers_transform
schemas-policies:
type: object
properties:
approval_groups:
$ref: '#/components/schemas/approval_groups'
approval_required:
$ref: '#/components/schemas/approval_required'
created_at:
$ref: '#/components/schemas/timestamp'
decision:
$ref: '#/components/schemas/decision'
exclude:
$ref: '#/components/schemas/schemas-exclude'
id:
$ref: '#/components/schemas/components-schemas-uuid'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/policies_components-schemas-name'
precedence:
$ref: '#/components/schemas/precedence'
purpose_justification_prompt:
$ref: '#/components/schemas/purpose_justification_prompt'
purpose_justification_required:
$ref: '#/components/schemas/purpose_justification_required'
require:
$ref: '#/components/schemas/schemas-require'
updated_at:
$ref: '#/components/schemas/timestamp'
schemas-port:
type: number
description: The keyless SSL port used to commmunicate between Cloudflare and
the client's Keyless SSL server.
default: 24008
example: 24008
maxLength: 65535
schemas-precedence:
type: integer
description: Precedence sets the ordering of the rules. Lower values indicate
higher precedence. At each processing phase, applicable rules are evaluated
in ascending order of this value.
schemas-preview_id:
example: p1aba936b94213e5b8dca0c0dbf1f9cc
schemas-preview_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
preview_url:
$ref: '#/components/schemas/preview_url'
schemas-price:
type: number
description: The amount you will be billed for this plan.
example: 0
schemas-priority:
type: number
description: The order/priority in which the certificate will be used in a request.
The higher priority will break ties across overlapping 'legacy_custom' certificates,
but 'legacy_custom' certificates will always supercede 'sni_custom' certificates.
default: 20
example: 1
schemas-private_key:
type: string
description: The hostname certificate's private key.
example: |
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG
dtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn
abIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid
tnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py
FxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE
ewooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb
HBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/
axiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb
+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g
+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv
KLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7
9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo
/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu
iacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9
N2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe
VAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB
vULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U
lySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR
9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7
mEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX
dFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe
PG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS
fhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W
qu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T
lv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi
-----END RSA PRIVATE KEY-----
schemas-proxied:
type: boolean
description: Whether the hostname should be gray clouded (false) or orange clouded
(true).
default: false
example: true
schemas-query:
allOf:
- $ref: '#/components/schemas/query'
- properties:
dimensions:
example:
- accountId
- responseCode
items:
enum:
- accountId
- responseCode
- requestType
filters:
example: requestType==read AND responseCode!=200
metrics:
default: '["requests"]'
example:
- requests
- readKiB
items:
enum:
- requests
- writeKiB
- readKiB
sort:
example:
- +requests
- -responseCode
schemas-railgun:
type: object
required:
- id
- name
- status
- enabled
- zones_connected
- activation
properties:
activation:
$ref: '#/components/schemas/activation'
created_on:
$ref: '#/components/schemas/railgun_components-schemas-created_on'
enabled:
$ref: '#/components/schemas/railgun_components-schemas-enabled'
id:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/railgun_components-schemas-modified_on'
name:
$ref: '#/components/schemas/railgun_components-schemas-name'
status:
$ref: '#/components/schemas/railgun_components-schemas-status'
upgrade_info:
$ref: '#/components/schemas/upgrade_info'
zones_connected:
$ref: '#/components/schemas/zones_connected'
schemas-railgun_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
type: object
schemas-rate-plan:
allOf:
- $ref: '#/components/schemas/rate-plan'
type: object
schemas-ratelimit:
type: number
description: |-
Ratelimit in queries per second per datacenter (applies to DNS queries sent to the origin nameservers configured on the cluster).
Notes: A ratelimit of 0 turns off the ratelimit. Otherwise the minimum is 100.
example: 600
maximum: 1e+08
schemas-ref:
type: string
description: A short reference tag. Allows you to select related filters.
example: FIL-100
maxLength: 50
schemas-references_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
description: List of resources that reference a given pool.
example:
- reference_type: referrer
resource_id: 699d98642c564d2e855e9661899b7252
resource_name: www.example.com
resource_type: load_balancer
- reference_type: referral
resource_id: f1aba936b94213e5b8dca0c0dbf1f9cc
resource_name: Login page monitor
resource_type: monitor
items:
type: object
properties:
reference_type:
type: string
enum:
- '*'
- referral
- referrer
resource_id:
type: string
resource_name:
type: string
resource_type:
type: string
schemas-request_model:
type: object
properties:
scope:
$ref: '#/components/schemas/scope'
type:
$ref: '#/components/schemas/url_normalization_components-schemas-type'
schemas-requests:
type: object
description: Breakdown of totals for requests.
properties:
all:
type: integer
description: Total number of requests served.
cached:
type: integer
description: Total number of cached requests served.
content_type:
type: object
description: A variable list of key/value pairs where the key represents
the type of content served, and the value is the number of requests.
example:
css: 15343
gif: 23178
html: 1.234213e+06
javascript: 318236
jpeg: 1.982048e+06
country:
type: object
description: A variable list of key/value pairs where the key is a two-digit
country code and the value is the number of requests served to that country.
example:
AG: 37298
GI: 293846
US: 4.181364e+06
http_status:
type: object
description: Key/value pairs where the key is a HTTP status code and the
value is the number of requests served with that code.
example:
"200": 1.3496983e+07
"301": 283
"400": 187936
"402": 1828
"404": 1293
ssl:
type: object
description: A break down of requests served over HTTPS.
properties:
encrypted:
type: integer
description: The number of requests served over HTTPS.
unencrypted:
type: integer
description: The number of requests served over HTTP.
ssl_protocols:
type: object
description: A breakdown of requests by their SSL protocol.
properties:
TLSv1:
type: integer
description: The number of requests served over TLS v1.0.
TLSv1.1:
type: integer
description: The number of requests served over TLS v1.1.
TLSv1.2:
type: integer
description: The number of requests served over TLS v1.2.
TLSv1.3:
type: integer
description: The number of requests served over TLS v1.3.
none:
type: integer
description: The number of requests served over HTTP.
uncached:
type: integer
description: Total number of requests served from the origin.
schemas-require:
type: array
description: Rules evaluated with an AND logical operator. To match the policy,
a user must meet all of the Require rules.
items:
$ref: '#/components/schemas/rule_components-schemas-rule'
schemas-requireSignedURLs:
type: boolean
description: Indicates whether the image can be a accessed only using it's UID.
If set to true, a signed token needs to be generated with a signing key to
view the image.
default: false
example: true
schemas-response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/ip_components-schemas-ip'
schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
example:
- id: 7cf72faf220841aabcfdfab81c43c4f6
name: Billing Read
scopes:
- com.cloudflare.api.account
- id: 9d24387c6e8544e2bc4024a03991339f
name: 'Load Balancing: Monitors and Pools Read'
scopes:
- com.cloudflare.api.account
- id: d2a1802cc9a34e30852f8b33869b2f3c
name: 'Load Balancing: Monitors and Pools Write'
scopes:
- com.cloudflare.api.account
- id: 8b47d2786a534c08a1f94ee8f9f599ef
name: Workers KV Storage Read
scopes:
- com.cloudflare.api.account
- id: f7f0eda5697f475c90846e879bab8666
name: Workers KV Storage Write
scopes:
- com.cloudflare.api.account
- id: 1a71c399035b4950a1bd1466bbe4f420
name: Workers Scripts Read
scopes:
- com.cloudflare.api.account
- id: e086da7e2179491d91ee5f35b3ca210a
name: Workers Scripts Write
scopes:
- com.cloudflare.api.account
items:
type: object
schemas-response_model:
type: object
properties:
scope:
$ref: '#/components/schemas/scope'
type:
$ref: '#/components/schemas/url_normalization_components-schemas-type'
schemas-response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
schemas-result:
type: object
description: Metrics on Workers KV requests.
required:
- rows
- data
- data_lag
- min
- max
- totals
- query
properties:
data:
type: array
nullable: true
items:
type: object
required:
- metrics
properties:
metrics:
type: array
description: List of metrics returned by the query.
items: {}
data_lag:
type: number
description: Number of seconds between current time and last processed event,
i.e. how many seconds of data could be missing.
example: 0
minimum: 0
max:
description: Maximum results for each metric.
min:
description: Minimum results for each metric.
query:
$ref: '#/components/schemas/query'
rows:
type: number
description: Total number of rows in the result.
example: 2
minimum: 0
totals:
description: Total results for metrics across all data.
schemas-role:
type: object
required:
- id
- name
- description
- permissions
properties:
description:
$ref: '#/components/schemas/description'
id:
$ref: '#/components/schemas/role_components-schemas-identifier'
name:
$ref: '#/components/schemas/components-schemas-name'
permissions:
$ref: '#/components/schemas/schemas-permissions'
schemas-route:
type: object
required:
- prefix
- nexthop
- priority
properties:
created_on:
$ref: '#/components/schemas/route_components-schemas-created_on'
description:
$ref: '#/components/schemas/route_components-schemas-description'
id:
$ref: '#/components/schemas/route_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/route_components-schemas-modified_on'
nexthop:
$ref: '#/components/schemas/nexthop'
prefix:
$ref: '#/components/schemas/prefix'
priority:
$ref: '#/components/schemas/route_components-schemas-priority'
scope:
$ref: '#/components/schemas/schemas-scope'
weight:
$ref: '#/components/schemas/schemas-weight'
schemas-rule:
allOf:
- $ref: '#/components/schemas/rule'
- properties:
scope:
type: object
description: All zones owned by the user will have the rule applied.
readOnly: true
properties:
email:
$ref: '#/components/schemas/email'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
type:
description: The scope of the rule.
enum:
- user
- organization
example: user
readOnly: true
type: object
required:
- id
- mode
- allowed_modes
- configuration
- scope
schemas-rule_identifier:
example: 2890e6fa406311ed9b5a23f70f6fb8cf
schemas-rules:
type: object
description: An object that allows you to override the action of specific WAF
rules. Each key of this object must be the ID of a WAF rule, and each value
must be a valid WAF action. Unless you are disabling a rule, ensure that you
also enable the rule group that this WAF rule belongs to. When creating a
new URI-based WAF override, you must provide a `groups` object or a `rules`
object.
example:
"100015": disable
schemas-rules_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/rule_result'
schemas-ruleset:
properties:
description:
example: ""
id:
example: 2f2feab2026849078ba485f918791bdc
kind:
example: zone
name:
example: default
phase:
example: http_request_transform
rules:
type: array
description: The rules in the ruleset.
items:
$ref: '#/components/schemas/transform-rules_components-schemas-rule'
schemas-scope:
type: object
description: Used only for ECMP routes.
properties:
colo_names:
$ref: '#/components/schemas/colo_names'
colo_regions:
$ref: '#/components/schemas/colo_regions'
schemas-script_name:
type: string
description: Name of the script to apply when the route is matched. The route
is skipped when this is blank/missing.
example: this-is_my_script-01
pattern: ^[a-z0-9_][a-z0-9-_]*$
schemas-secret:
type: string
description: Optional secret that will be passed in the `cf-webhook-auth` header
when dispatching a webhook notification. Secrets are not returned in any API
response body.
schemas-serial_number:
type: string
description: The device serial number.
example: EXAMPLEHMD6R
schemas-session_duration:
type: integer
description: Lifetime of a cookie (in minutes) set by Cloudflare for users who
get access to the route. If a user is not seen by Cloudflare again in that
time period, they will be treated as a new user that visits the route.
default: 5
minimum: 1
maximum: 30
schemas-signature:
type: string
description: Certificate's signature algorithm.
enum:
- ECDSAWithSHA256
- SHA1WithRSA
- SHA256WithRSA
schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
errors:
type: array
items: {}
messages:
type: array
items: {}
result:
$ref: '#/components/schemas/api-shield'
schemas-size:
type: number
description: The size of the image in bytes.
example: 29472
readOnly: true
schemas-ssl:
oneOf:
- type: object
properties:
bundle_method:
type: string
description: A ubiquitous bundle has the highest probability of being
verified everywhere, even by clients using outdated or unusual trust
stores. An optimal bundle uses the shortest chain and newest intermediates.
And the force bundle verifies the chain, but does not otherwise modify
it.
enum:
- ubiquitous
- optimal
- force
default: ubiquitous
example: ubiquitous
certificate_authority:
type: string
description: The Certificate Authority that has issued this certificate.
enum:
- digicert
- google
- lets_encrypt
example: digicert
custom_certificate:
type: string
description: If a custom uploaded certificate is used.
example: '-----BEGIN CERTIFICATE-----\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\n-----END
CERTIFICATE-----\n'
custom_csr_id:
type: string
description: The identifier for the Custom CSR that was used.
example: 7b163417-1d2b-4c84-a38a-2fb7a0cd7752
custom_key:
type: string
description: The key for a custom uploaded certificate.
example: |
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG
dtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn
abIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid
tnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py
FxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE
ewooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb
HBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/
axiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb
+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g
+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv
KLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7
9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo
/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu
iacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9
N2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe
VAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB
vULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U
lySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR
9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7
mEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX
dFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe
PG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS
fhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W
qu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T
lv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi
-----END RSA PRIVATE KEY-----
expires_on:
type: string
format: date-time
description: The time the custom certificate expires on.
example: "2021-02-06T18:11:23.531995Z"
hosts:
type: array
description: A list of Hostnames on a custom uploaded certificate.
example:
- app.example.com
- '*.app.example.com'
items: {}
id:
type: string
description: Custom hostname SSL identifier tag.
example: 0d89c70d-ad9f-4843-b99f-6cc0252067e9
minLength: 36
maxLength: 36
issuer:
type: string
description: The issuer on a custom uploaded certificate.
example: DigiCertInc
method:
description: Domain control validation (DCV) method used for this hostname.
enum:
- http
- txt
- email
example: txt
serial_number:
type: string
description: The serial number on a custom uploaded certificate.
example: "6743787633689793699141714808227354901"
settings:
$ref: '#/components/schemas/sslsettings'
signature:
type: string
description: The signature on a custom uploaded certificate.
example: SHA256WithRSA
status:
description: Status of the hostname's SSL certificates.
enum:
- initializing
- pending_validation
- deleted
- pending_issuance
- pending_deployment
- pending_deletion
- pending_expiration
- expired
- active
- initializing_timed_out
- validation_timed_out
- issuance_timed_out
- deployment_timed_out
- deletion_timed_out
- pending_cleanup
- staging_deployment
- staging_active
- deactivating
- inactive
- backup_issued
- holding_deployment
example: pending_validation
readOnly: true
type:
description: Level of validation to be used for this hostname. Domain
validation (dv) must be used.
enum:
- dv
example: dv
readOnly: true
uploaded_on:
type: string
format: date-time
description: The time the custom certificate was uploaded.
example: "2020-02-06T18:11:23.531995Z"
validation_errors:
type: array
description: Domain validation errors that have been received by the certificate
authority (CA).
items:
type: object
properties:
message:
type: string
description: A domain validation error.
example: SERVFAIL looking up CAA for app.example.com
validation_records:
type: array
items:
$ref: '#/components/schemas/validation_record'
wildcard:
type: boolean
description: Indicates whether the certificate covers a wildcard.
example: false
type: object
description: SSL properties for the custom hostname.
schemas-state:
type: string
description: The custom page state.
enum:
- default
- customized
example: default
schemas-status:
type: string
description: Status of this membership.
enum:
- accepted
- pending
- rejected
example: accepted
schemas-subdomain:
type: string
description: The subdomain to be used as the destination in the proxy client.
example: oli3n9zkz5.proxy.cloudflare-gateway.com
schemas-suspended:
type: boolean
description: Suspends or allows traffic going to the waiting room. If set to
`true`, the traffic will not go to the waiting room.
default: false
schemas-target:
type: string
description: The target hostname, IPv6, or IPv6 address.
example: 1.1.1.1
schemas-targets:
type: array
example:
- 203.0.113.1
- cloudflare.com
maxLength: 10
items:
type: string
description: Hosts as a hostname or IPv4/IPv6 address represented by strings.
example: 203.0.113.1
schemas-thumbnail_url:
type: string
format: uri
description: URI to thumbnail variant for an image.
example: https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/thumbnail
readOnly: true
schemas-timeout:
type: integer
description: The timeout (in seconds) before marking the health check as failed.
default: 5
schemas-token:
allOf:
- $ref: '#/components/schemas/token'
schemas-ttl:
type: number
description: Time to live (TTL) of the DNS entry for the IP address returned
by this load balancer. This only applies to gray-clouded (unproxied) load
balancers.
example: 30
schemas-tunnel_add_single_request:
type: object
required:
- name
- cloudflare_endpoint
- interface_address
properties:
cloudflare_endpoint:
$ref: '#/components/schemas/cloudflare_ipsec_endpoint'
customer_endpoint:
$ref: '#/components/schemas/customer_ipsec_endpoint'
description:
$ref: '#/components/schemas/ipsec-tunnel_components-schemas-description'
interface_address:
$ref: '#/components/schemas/interface_address'
name:
$ref: '#/components/schemas/ipsec-tunnel_components-schemas-name'
psk:
$ref: '#/components/schemas/psk'
schemas-tunnel_deleted_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
deleted:
type: boolean
example: true
deleted_ipsec_tunnel:
type: object
schemas-tunnel_id:
description: UUID of the Cloudflare Tunnel serving the route.
schemas-tunnel_modified_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_ipsec_tunnel:
type: object
schemas-tunnel_name:
description: The user-friendly name of the Cloudflare Tunnel serving the route.
schemas-tunnel_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/tunnel'
schemas-tunnel_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/tunnel'
schemas-tunnel_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
ipsec_tunnel:
type: object
schemas-tunnel_update_request:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_add_single_request'
schemas-tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
ipsec_tunnels:
type: array
items:
$ref: '#/components/schemas/ipsec-tunnel'
schemas-type:
type: string
description: The type of characteristic.
enum:
- header
- cookie
example: header
schemas-updated_at:
type: string
description: The timestamp of when Page Shield was last updated.
example: "2022-10-12T17:56:52.083582+01:00"
schemas-uploaded:
type: string
format: date-time
description: When the media item was uploaded.
example: "2014-01-02T02:20:00Z"
readOnly: true
schemas-uploaded_on:
type: string
format: date-time
description: This is the time the certificate was uploaded.
example: "2019-10-28T18:11:23.37411Z"
schemas-url:
type: string
description: The URL pattern to match, composed of a host and a path such as
`example.org/path*`. Normalization is applied before the pattern is matched.
`*` wildcards are expanded to match applicable traffic. Query strings are
not matched. Set the value to `*` to match all traffic to your zone.
example: '*.example.org/path*'
maxLength: 1024
schemas-urls:
type: array
description: The URLs to include in the rule definition. You can use wildcards.
Each entered URL will be escaped before use, which means you can only use
simple wildcard patterns.
items:
type: string
example: api.mysite.com/some/endpoint*
schemas-uuid:
description: The unique identifier for the Access group.
schemas-validate_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
valid:
type: boolean
example: true
schemas-validation_method:
type: string
description: Validation method in use for a certificate pack order.
enum:
- http
- cname
- txt
example: txt
schemas-validity_days:
type: integer
description: The validity period in days for the certificates ordered via Total
TLS.
enum:
- 90
schemas-value:
type: string
description: Enables Argo Smart Routing.
enum:
- "on"
- "off"
example: "on"
schemas-variants:
type: array
description: Object specifying available variants for an image.
example:
- https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/thumbnail
- https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/hero
- https://imagedelivery.net/MTt4OTd0b0w5aj/107b9558-dd06-4bbd-5fef-9c2c16bb7900/original
readOnly: true
items:
anyOf:
- $ref: '#/components/schemas/schemas-thumbnail_url'
- $ref: '#/components/schemas/hero_url'
- $ref: '#/components/schemas/original_url'
schemas-version:
type: string
description: The version of the rule.
example: "1"
pattern: ^[0-9]+$
schemas-video_identifier:
type: string
description: A unique identifier for the media file.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
schemas-virtual-dns:
allOf:
- $ref: '#/components/schemas/virtual-dns'
type: object
schemas-weight:
type: integer
description: Optional weight of the ECMP scope - if provided.
schemas-width:
type: number
description: Maximum width in image pixels.
example: 1366
minimum: 1
schemas-zone:
type: object
properties:
name:
readOnly: true
schemes:
type: array
description: The HTTP schemes to match. You can specify one scheme (`['HTTPS']`),
both schemes (`['HTTP','HTTPS']`), or all schemes (`['_ALL_']`). This field
is optional.
example:
- HTTP
- HTTPS
items:
type: string
description: An HTTP scheme or `_ALL_` to indicate all schemes.
example: HTTPS
scope:
type: string
description: The scope of the URL normalization.
example: incoming
script:
properties:
added_at:
example: "2021-08-18T10:51:10.09615Z"
domain_reported_malicious:
example: false
fetched_at:
example: "2021-09-02T10:17:54Z"
first_page_url:
example: blog.cloudflare.com/page
first_seen_at:
example: "2021-08-18T10:51:08Z"
hash:
example: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
host:
example: blog.cloudflare.com
id:
example: c9ef84a6bf5e47138c75d95e2f933e8f
js_integrity_score:
example: 10
last_seen_at:
example: "2021-09-02T09:57:54Z"
page_urls:
example:
- blog.cloudflare.com/page1
- blog.cloudflare.com/page2
url:
example: https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.6.0/js/bootstrap.min.js
url_contains_cdn_cgi_path:
example: false
script-monitor_components-schemas-enabled:
type: boolean
description: When true, indicates that Page Shield is enabled.
example: true
script-monitor_components-schemas-id:
type: string
description: The ID of the resource.
example: c9ef84a6bf5e47138c75d95e2f933e8f
minLength: 32
maxLength: 32
script-response-collection:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
properties:
created_on:
readOnly: true
etag:
readOnly: true
id:
readOnly: true
modified_on:
readOnly: true
usage_model:
readOnly: true
script-response-single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
script_identifier:
type: string
example: 8ee82b3a2c0f42928b8f14dae4a97121
readOnly: true
maxLength: 32
script_name:
type: string
description: Name of the script, used in URLs and route configuration.
example: this-is_my_script-01
pattern: ^[a-z0-9_][a-z0-9-_]*$
search:
type: object
properties:
resources:
type: array
description: A list of resources matching the search query.
items:
$ref: '#/components/schemas/resource_reference'
search_result:
type: object
properties:
result:
$ref: '#/components/schemas/search'
seat:
type: object
required:
- seat_uid
- gateway_seat
- access_seat
properties:
access_seat:
$ref: '#/components/schemas/access_seat'
gateway_seat:
$ref: '#/components/schemas/gateway_seat'
seat_uid:
$ref: '#/components/schemas/seat_uid'
seat_uid:
description: The unique API identifier for the Zero Trust seat.
seats:
type: object
properties:
access_seat:
$ref: '#/components/schemas/access_seat'
created_at:
$ref: '#/components/schemas/timestamp'
gateway_seat:
$ref: '#/components/schemas/gateway_seat'
seat_uid:
$ref: '#/components/schemas/seat_uid'
updated_at:
$ref: '#/components/schemas/timestamp'
seats_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
seats_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/seats'
seats_definition:
type: array
items:
$ref: '#/components/schemas/seat'
required:
- seat_uid
- gateway_seat
- access_seat
secret:
type: string
description: TSIG secret.
example: caf79a7804b04337c9c66ccd7bef9190a1e1679b5dd03d8aa10f7ad45e1a9dab92b417896c15d4d007c7c14194538d2a5d0feffdecc5a7f0e1c570cfa700837c
security_header:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone's security header.
enum:
- security_header
example: security_header
value:
$ref: '#/components/schemas/security_header_value'
title: Security Header
description: Cloudflare security header for a zone.
security_header_value:
type: object
properties:
strict_transport_security:
type: object
description: Strict Transport Security.
properties:
enabled:
type: boolean
description: Whether or not strict transport security is enabled.
example: true
include_subdomains:
type: boolean
description: Include all subdomains for strict transport security.
example: true
max_age:
type: number
description: Max age in seconds of the strict transport security.
example: 86400
nosniff:
type: boolean
description: 'Whether or not to include ''X-Content-Type-Options: nosniff''
header.'
example: true
security_level:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- security_level
example: security_level
value:
$ref: '#/components/schemas/security_level_value'
title: Security Level
description: Choose the appropriate security profile for your website, which
will automatically adjust each of the security settings. If you choose to
customize an individual security setting, the profile will become Custom.
(https://support.cloudflare.com/hc/en-us/articles/200170056).
security_level_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- essentially_off
- low
- medium
- high
- under_attack
default: medium
self_hosted_props:
type: object
title: Self Hosted Application
properties:
allowed_idps:
$ref: '#/components/schemas/allowed_idps'
app_launcher_visible:
$ref: '#/components/schemas/app_launcher_visible'
auto_redirect_to_identity:
$ref: '#/components/schemas/auto_redirect_to_identity'
cors_headers:
$ref: '#/components/schemas/cors_headers'
custom_deny_message:
$ref: '#/components/schemas/custom_deny_message'
custom_deny_url:
$ref: '#/components/schemas/custom_deny_url'
domain:
$ref: '#/components/schemas/schemas-domain'
enable_binding_cookie:
$ref: '#/components/schemas/enable_binding_cookie'
http_only_cookie_attribute:
$ref: '#/components/schemas/http_only_cookie_attribute'
logo_url:
$ref: '#/components/schemas/logo_url'
name:
$ref: '#/components/schemas/apps_components-schemas-name'
same_site_cookie_attribute:
$ref: '#/components/schemas/same_site_cookie_attribute'
service_auth_401_redirect:
$ref: '#/components/schemas/service_auth_401_redirect'
session_duration:
$ref: '#/components/schemas/session_duration'
skip_interstitial:
$ref: '#/components/schemas/skip_interstitial'
type:
type: string
description: The application type.
example: self_hosted
sensitivity:
type: string
description: The sensitivity of the WAF package.
enum:
- high
- medium
- low
- "off"
default: high
sent:
type: string
format: date-time
description: Timestamp of when the notification was dispatched in ISO 8601 format.
example: "2021-10-08T17:52:17.571336Z"
serial_number:
type: string
description: The serial number on the uploaded certificate.
example: "6743787633689793699141714808227354901"
server_side_exclude:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- server_side_exclude
example: server_side_exclude
value:
$ref: '#/components/schemas/server_side_exclude_value'
title: Server Side Exclude
description: 'If there is sensitive content on your website that you want visible
to real visitors, but that you want to hide from suspicious visitors, all
you have to do is wrap the content with Cloudflare SSE tags. Wrap any content
that you want to be excluded from suspicious visitors in the following SSE
tags: . For example: Bad visitors won''t
see my phone number, 555-555-5555 . Note: SSE only will work with
HTML. If you have HTML minification enabled, you won''t see the SSE tags in
your HTML source when it''s served through Cloudflare. SSE will still function
in this case, as Cloudflare''s HTML minification and SSE functionality occur
on-the-fly as the resource moves through our network to the visitor''s computer.
(https://support.cloudflare.com/hc/en-us/articles/200170036).'
server_side_exclude_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "on"
service:
type: string
description: Worker service associated with the zone and hostname.
example: foo
service-tokens:
type: object
properties:
client_id:
$ref: '#/components/schemas/client_id'
created_at:
$ref: '#/components/schemas/timestamp'
id:
description: The ID of the service token.
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
updated_at:
$ref: '#/components/schemas/timestamp'
service-tokens_components-schemas-name:
type: string
description: The name of the service token.
example: CI/CD token
service-tokens_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/service-tokens'
service-tokens_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/service-tokens'
service_auth_401_redirect:
type: boolean
description: Returns a 401 status code when the request is blocked by a Service
Auth policy.
example: true
service_mode_v2:
type: object
properties:
mode:
type: string
description: The mode to run the WARP client under.
example: proxy
port:
type: number
description: The port number when used with proxy mode.
example: 3000
session_affinity:
type: string
description: The session_affinity specifies the type of session affinity the
load balancer should use unless specified as "none" or ""(default). The supported
types are "cookie" and "ip_cookie". "cookie" - On the first request to a proxied
load balancer, a cookie is generated, encoding information of which origin
the request will be forwarded to. Subsequent requests, by the same client
to the same load balancer, will be sent to the origin server the cookie encodes,
for the duration of the cookie and as long as the origin server remains healthy.
If the cookie has expired or the origin server is unhealthy then a new origin
server is calculated and used. "ip_cookie" behaves the same as "cookie" except
the initial origin selection is stable and based on the client’s ip address.
enum:
- none
- cookie
- ip_cookie
- '""'
default: '""'
example: cookie
session_affinity_attributes:
type: object
description: Configures cookie attributes for session affinity cookie.
properties:
drain_duration:
type: number
description: Configures the drain duration in seconds. This field is only
used when session affinity is enabled on the load balancer.
example: 100
samesite:
type: string
description: 'Configures the SameSite attribute on session affinity cookie.
Value "Auto" will be translated to "Lax" or "None" depending if Always
Use HTTPS is enabled. Note: when using value "None", the secure attribute
can not be set to "Never".'
enum:
- Auto
- Lax
- None
- Strict
default: Auto
example: Auto
secure:
type: string
description: Configures the Secure attribute on session affinity cookie.
Value "Always" indicates the Secure attribute will be set in the Set-Cookie
header, "Never" indicates the Secure attribute will not be set, and "Auto"
will set the Secure attribute depending if Always Use HTTPS is enabled.
enum:
- Auto
- Always
- Never
default: Auto
example: Auto
zero_downtime_failover:
type: string
description: Configures the zero-downtime failover between origins within
a pool when session affinity is enabled. Value "none" means no failover
takes place for sessions pinned to the origin (default). Value "temporary"
means traffic will be sent to another other healthy origin until the originally
pinned origin is available; note that this can potentially result in heavy
origin flapping. Value "sticky" means the session affinity cookie is updated
and subsequent requests are sent to the new origin. This feature is currently
incompatible with Argo, Tiered Cache, and Bandwidth Alliance.
enum:
- none
- temporary
- sticky
default: none
example: sticky
session_affinity_ttl:
type: number
description: Time, in seconds, until this load balancer's session affinity cookie
expires after being created. This parameter is ignored unless a supported
session affinity policy is set. The current default of 23 hours will be used
unless session_affinity_ttl is explicitly set. The accepted range of values
is between [1800, 604800]. Once the expiry time has been reached, subsequent
requests may get sent to a different origin server.
example: 5000
session_duration:
type: string
description: 'The amount of time that tokens issued for this application will
be valid. Must be in the format `300ms` or `2h45m`. Valid time units are:
ns, us (or µs), ms, s, m, h.'
default: 24h
example: 24h
setting:
oneOf:
- $ref: '#/components/schemas/always_online'
- $ref: '#/components/schemas/advanced_ddos'
- $ref: '#/components/schemas/brotli'
- $ref: '#/components/schemas/browser_cache_ttl'
- $ref: '#/components/schemas/browser_check'
- $ref: '#/components/schemas/cname_flattening'
- $ref: '#/components/schemas/cache_level'
- $ref: '#/components/schemas/challenge_ttl'
- $ref: '#/components/schemas/development_mode'
- $ref: '#/components/schemas/early_hints'
- $ref: '#/components/schemas/edge_cache_ttl'
- $ref: '#/components/schemas/origin_error_page_pass_thru'
- $ref: '#/components/schemas/sort_query_string_for_cache'
- $ref: '#/components/schemas/email_obfuscation'
- $ref: '#/components/schemas/hotlink_protection'
- $ref: '#/components/schemas/ip_geolocation'
- $ref: '#/components/schemas/ipv6'
- $ref: '#/components/schemas/websockets'
- $ref: '#/components/schemas/sha1_support'
- $ref: '#/components/schemas/tls_1_2_only'
- $ref: '#/components/schemas/minify'
- $ref: '#/components/schemas/max_upload'
- $ref: '#/components/schemas/mobile_redirect'
- $ref: '#/components/schemas/mirage'
- $ref: '#/components/schemas/nel'
- $ref: '#/components/schemas/polish'
- $ref: '#/components/schemas/webp'
- $ref: '#/components/schemas/prefetch_preload'
- $ref: '#/components/schemas/privacy_pass'
- $ref: '#/components/schemas/response_buffering'
- $ref: '#/components/schemas/rocket_loader'
- $ref: '#/components/schemas/security_header'
- $ref: '#/components/schemas/security_level'
- $ref: '#/components/schemas/server_side_exclude'
- $ref: '#/components/schemas/ssl'
- $ref: '#/components/schemas/ssl_recommender'
- $ref: '#/components/schemas/tls_client_auth'
- $ref: '#/components/schemas/true_client_ip_header'
- $ref: '#/components/schemas/proxy_read_timeout'
- $ref: '#/components/schemas/waf'
- $ref: '#/components/schemas/min_tls_version'
- $ref: '#/components/schemas/ciphers'
- $ref: '#/components/schemas/tls_1_3'
- $ref: '#/components/schemas/opportunistic_encryption'
- $ref: '#/components/schemas/automatic_https_rewrites'
- $ref: '#/components/schemas/http2'
- $ref: '#/components/schemas/http3'
- $ref: '#/components/schemas/origin_max_http_version'
- $ref: '#/components/schemas/0rtt'
- $ref: '#/components/schemas/pseudo_ipv4'
- $ref: '#/components/schemas/always_use_https'
- $ref: '#/components/schemas/opportunistic_onion'
- $ref: '#/components/schemas/orange_to_orange'
- $ref: '#/components/schemas/image_resizing'
- $ref: '#/components/schemas/h2_prioritization'
- $ref: '#/components/schemas/schemas-automatic_platform_optimization'
type: object
settings:
type: array
description: Settings available for the zone.
example:
- id: browser_check
properties:
- name: value
type: toggle
- id: browser_cache_ttl
properties:
- max: 3.1536e+07
min: 1800
name: value
suggested_values:
- 1800
- 3600
- 7200
- 10800
- 14400
- 18000
- 28800
- 43200
- 57600
- 72000
- 86400
- 172800
- 259200
- 345600
- 432000
- 691200
- 1.3824e+06
- 2.0736e+06
- 2.6784e+06
- 5.3568e+06
- 1.60704e+07
- 3.1536e+07
type: range
- id: browser_check
properties:
- name: value
type: toggle
- id: cache_key_fields
properties:
- name: value
properties:
- allowEmpty: true
choices:
- include
- exclude
multiple: false
name: query_string
type: select
- allowEmpty: true
choices:
- include
- exclude
- check_presence
multiple: true
name: header
type: select
- allowEmpty: false
choices:
- resolved
multiple: true
name: host
type: select
- allowEmpty: true
choices:
- include
- check_presence
multiple: true
name: cookie
type: select
- allowEmpty: false
choices:
- device_type
- geo
- lang
multiple: true
name: user
type: select
type: object
- id: cache_deception_armor
properties:
- name: value
type: toggle
- id: cache_level
properties:
- choices:
- bypass
- basic
- simplified
- aggressive
- cache_everything
multiple: false
name: value
type: select
- id: cache_ttl_by_status
properties:
- allowEmpty: false
name: value
type: object
- id: disable_apps
properties: []
- id: disable_performance
properties: []
- id: disable_security
properties: []
- id: edge_cache_ttl
properties:
- max: 2.4192e+06
min: 7200
name: value
suggested_values:
- 7200
- 10800
- 14400
- 18000
- 28800
- 43200
- 57600
- 72000
- 86400
- 172800
- 259200
- 345600
- 432000
- 518400
- 604800
- 1.2096e+06
- 2.4192e+06
type: range
- id: email_obfuscation
properties:
- name: value
type: toggle
- id: forwarding_url
properties:
- choices:
- 301
- 302
multiple: false
name: status_code
type: choice
- name: url
type: forwardingUrl
- id: ip_geolocation
properties:
- name: value
type: toggle
- id: minify
properties:
- allowEmpty: true
choices:
- html
- css
- js
multiple: true
name: value
type: select
- id: explicit_cache_control
properties:
- name: value
type: toggle
- id: rocket_loader
properties:
- name: value
type: toggle
- id: security_level
properties:
- choices:
- essentially_off
- low
- medium
- high
- under_attack
multiple: false
name: value
type: select
- id: server_side_exclude
properties:
- name: value
type: toggle
- id: ssl
properties:
- choices:
- "off"
- flexible
- full
- strict
multiple: false
name: value
type: choice
items:
type: object
sha1_support:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Zone setting identifier.
enum:
- sha1_support
example: sha1_support
value:
$ref: '#/components/schemas/sha1_support_value'
title: Toggle SHA1 support
description: Allow SHA1 support.
sha1_support_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
signature:
type: string
description: The type of hash used for the certificate.
example: SHA256WithRSA
readOnly: true
signed_token_request:
type: object
readOnly: true
properties:
accessRules:
type: array
description: The optional list of access rule constraints on the token.
Access can be blocked or allowed based on an IP, IP range, or by country.
Access rules are evaluated from first to last. If a rule matches, the
associated action is applied and no further rules are evaluated.
example:
- action: block
country:
- US
- MX
type: ip.geoip.country
- action: allow
ip:
- 93.184.216.0/24
- 2400:cb00::/32
type: ip.src
- action: block
type: any
readOnly: true
items:
$ref: '#/components/schemas/accessRules'
downloadable:
type: boolean
description: The optional boolean value that enables using signed tokens
to access MP4 download links for a video.
default: false
readOnly: true
exp:
type: integer
description: The optional unix epoch timestamp that specficies the time
after a token is not accepted. The maximum time specification is 24 hours
from issuing time. If this field is not set, the default is one hour after
issuing.
readOnly: true
id:
type: string
description: The optional ID of a Stream signing key. If present, the `pem`
field is also required.
example: ab0d4ef71g4425f8dcba9041231813000
readOnly: true
nbf:
type: integer
description: The optional unix epoch timestamp that specifies the time before
a the token is not accepted. If this field is not set, the default is
one hour before issuing.
readOnly: true
pem:
type: string
description: The optional base64 encoded private key in PEM format associated
with a Stream signing key. If present, the `id` field is also required.
example: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFcEFJQkFBS0NBUUVBc284dnBvOFpEWXRkOUgzbWlPaW1qYXAzVXlVM0oyZ3kwTUYvN1R4blJuRnkwRHpDCkxqUk9naFZsQ0hPQmxsd3NVaE9GU0lyYnN4K05tUTdBeS90TFpXSGxuVGF3UWJ5WGZGOStJeDhVSnNlSHBGV1oKNVF5Z1JYd2liSjh1MVVsZ2xlcmZHMkpueldjVXpZTzEySktZN3doSkw1ajROMWgxZFJNUXQ5Q1pkZFlCQWRzOQpCdk02cjRFMDcxQkhQekhWeDMrUTI1VWtubGdUNXIwS3FiM1E1Y0dlTlBXY1JreW1ybkJEWWR0OXR4eFFMb1dPCllzNXdsMnVYWFVYL0VGcDMwajU0Nmp6czllWExLYlNDbjJjTDZFVE96Y2x3aG9DRGx2a2VQT05rUE9LMDVKNUMKTm1TdFdhMG9hV1VGRzM0MFl3cVVrWGt4OU9tNndXd1JldU1uU1FJREFRQUJBb0lCQUFJOHo1ck5kOEdtOGJBMgo1S3pxQjI1R2lOVENwbUNJeW53NXRJWHZTQmNHcEdydUcvdlN2WG9kVlFVSVY0TWdHQkVXUEFrVzdsNWVBcHI4CnA1ZFd5SkRXYTNkdklFSE9vSEpYU3dBYksxZzZEMTNVa2NkZ1EyRGpoNVhuWDhHZCtBY2c2SmRTQWgxOWtYSHEKMk54RUtBVDB6Ri83a1g2MkRkREFBcWxmQkpGSXJodVIvZUdEVWh4L2piTTRhQ2JCcFdiM0pnRE9OYm5tS1ZoMwpxS2ZwZmRZZENZU1lzWUxrNTlxRDF2VFNwUVFUQ0VadW9VKzNzRVNhdkJzaUs1bU0vTzY5ZkRMRXNURG1MeTVQCmhEK3BMQXI0SlhNNjFwRGVBS0l3cUVqWWJybXlDRHRXTUdJNnZzZ0E1eXQzUUJaME9vV2w5QUkwdWxoZ3p4dXQKZ2ZFNTRRRUNnWUVBN0F3a0lhVEEzYmQ4Nk9jSVZnNFlrWGk1cm5aNDdsM1k4V24zcjIzUmVISXhLdkllRUtSbgp5bUlFNDFtRVBBSmlGWFpLK1VPTXdkeS9EcnFJUithT1JiT2NiV01jWUg2QzgvbG1wdVJFaXE3SW1Ub3VWcnA4CnlnUkprMWprVDA4cTIvNmg4eTBEdjJqMitsaHFXNzRNOUt0cmwxcTRlWmZRUFREL01tR1NnTWtDZ1lFQXdhY04KaSttN1p6dnJtL3NuekF2VlZ5SEtwZHVUUjNERk1naC9maC9tZ0ZHZ1RwZWtUOVV5b3FleGNYQXdwMVlhL01iQQoyNTVJVDZRbXZZTm5yNXp6Wmxic2tMV0hsYllvbWhmWnVXTHhXR3hRaEFORWdaMFVVdUVTRGMvbWx2UXZHbEtSCkZoaGhBUWlVSmdDamhPaHk1SlBiNGFldGRKd0UxK09lVWRFaE1vRUNnWUVBNG8yZ25CM1o4ck5xa3NzemlBek4KYmNuMlJVbDJOaW9pejBwS3JMaDFaT29NNE5BekpQdjJsaHRQMzdtS0htS1hLMHczRjFqTEgwSTBxZmxFVmVZbQpSU1huakdHazJjUnpBYUVzOGgrQzNheDE0Z01pZUtGU3BqNUpNOEFNbVVZOXQ1cUVhN2FYc3o0V1ZoOUlMYmVTCkRiNzlhKzVwd21LQVBrcnBsTHhyZFdrQ2dZQlNNSHVBWVdBbmJYZ1BDS2FZWklGVWJNUWNacmY0ZnpWQ2lmYksKYWZHampvRlNPZXdEOGdGK3BWdWJRTGwxbkFieU44ek1xVDRaaHhybUhpcFlqMjJDaHV2NmN3RXJtbGRiSnpwQwpBMnRaVXdkTk1ESFlMUG5lUHlZeGRJWnlsUXFVeW14SGkydElUQUxNcWtLOGV3ZWdXZHpkeGhQSlJScU5JazhrCmZIVHhnUUtCZ1FEUFc2UXIxY3F3QjNUdnVWdWR4WGRqUTdIcDFodXhrNEVWaEFJZllKNFhSTW1NUE5YS28wdHUKdUt6LzE0QW14R0dvSWJxYVc1bDMzeFNteUxhem84clNUN0tSTjVKME9JSHcrZkR5SFgxdHpVSjZCTldDcEFTcwpjbWdNK0htSzVON0w2bkNaZFJQY2IwU1hGaVRQUGhCUG1PVWFDUnpER0ZMK2JYM1VwajJKbWc9PQotLS0tLUVORCBSU0EgUFJJVkFURSBLRVktLS0tLQo=
readOnly: true
signed_token_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
token:
type: string
description: The signed token used with the signed URLs feature.
example: eyJhbGciOiJSUzI1NiIsImtpZCI6ImU5ZGI5OTBhODI2NjZkZDU3MWM3N2Y5NDRhNWM1YzhkIn0.eyJzdWIiOiJlYTk1MTMyYzE1NzMyNDEyZDIyYzE0NzZmYTgzZjI3YSIsImtpZCI6ImU5ZGI5OTBhODI2NjZkZDU3MWM3N2Y5NDRhNWM1YzhkIiwiZXhwIjoiMTUzNzQ2MDM2NSIsIm5iZiI6IjE1Mzc0NTMxNjUifQ.OZhqOARADn1iubK6GKcn25hN3nU-hCFF5q9w2C4yup0C4diG7aMIowiRpP-eDod8dbAJubsiFuTKrqPcmyCKWYsiv0TQueukqbQlF7HCO1TV-oF6El5-7ldJ46eD-ZQ0XgcIYEKrQOYFF8iDQbqPm3REWd6BnjKZdeVrLzuRaiSnZ9qqFpGu5dfxIY9-nZKDubJHqCr3Imtb211VIG_b9MdtO92JjvkDS-rxT_pkEfTZSafl1OU-98A7KBGtPSJHz2dHORIrUiTA6on4eIXTj9aFhGiir4rSn-rn0OjPRTtJMWIDMoQyE_fwrSYzB7MPuzL2t82BWaEbHZTfixBm5A
since:
anyOf:
- type: string
- type: integer
description: |-
The (inclusive) beginning of the requested time frame. This value can be a negative integer representing the number of minutes in the past relative to time the request is made, or can be an absolute timestamp that conforms to RFC 3339. At this point in time, it cannot exceed a time in the past greater than one year.
Ranges that the Cloudflare web application provides will provide the following period length for each point:
- Last 60 minutes (from -59 to -1): 1 minute resolution
- Last 7 hours (from -419 to -60): 15 minutes resolution
- Last 15 hours (from -899 to -420): 30 minutes resolution
- Last 72 hours (from -4320 to -900): 1 hour resolution
- Older than 3 days (-525600 to -4320): 1 day resolution.
default: -10080
example: "2015-01-01T12:23:00Z"
single_invite_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
single_member_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
single_membership_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
single_organization_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
single_request_outgoing:
required:
- id
- name
- peers
properties:
id:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
name:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-name'
peers:
$ref: '#/components/schemas/peers'
single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
errors:
type: array
items: {}
messages:
type: array
items: {}
result:
$ref: '#/components/schemas/configuration'
single_response_incoming:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
auto_refresh_seconds:
$ref: '#/components/schemas/auto_refresh_seconds'
checked_time:
$ref: '#/components/schemas/time'
created_time:
$ref: '#/components/schemas/time'
id:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
modified_time:
$ref: '#/components/schemas/time'
name:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-name'
peers:
$ref: '#/components/schemas/peers'
soa_serial:
$ref: '#/components/schemas/soa_serial'
single_response_outgoing:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
checked_time:
$ref: '#/components/schemas/time'
created_time:
$ref: '#/components/schemas/time'
id:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
last_transferred_time:
$ref: '#/components/schemas/time'
name:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-name'
peers:
$ref: '#/components/schemas/peers'
soa_serial:
$ref: '#/components/schemas/soa_serial'
single_response_with_list_items:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
created_at:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/lists_components-schemas-description-2'
id:
$ref: '#/components/schemas/lists_components-schemas-uuid'
items:
$ref: '#/components/schemas/schemas-items'
name:
$ref: '#/components/schemas/lists_components-schemas-name-2'
type:
$ref: '#/components/schemas/lists_components-schemas-type'
updated_at:
$ref: '#/components/schemas/timestamp'
single_role_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
single_user_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
size:
type: number
description: The size of the media item in bytes.
example: 4.190963e+06
readOnly: true
skip_interstitial:
type: boolean
description: Enables automatic authentication through cloudflared.
example: true
soa_serial:
type: number
description: The serial number of the SOA for the given zone.
example: 2.0191024e+09
sort_query_string_for_cache:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- sort_query_string_for_cache
example: sort_query_string_for_cache
value:
$ref: '#/components/schemas/sort_query_string_for_cache_value'
title: Get String Sort
description: Cloudflare will treat files with the same query strings as the
same file in cache, regardless of the order of the query strings. This is
limited to Enterprise Zones.
default: "off"
sort_query_string_for_cache_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
split_tunnel:
type: object
required:
- address
- description
properties:
address:
type: string
description: The address in CIDR format to exclude from the tunnel. If address
is present, host must not be present.
example: 192.0.2.0/24
description:
type: string
description: A description of the split tunnel item, displayed in the client
UI.
example: Exclude testing domains from the tunnel
maxLength: 100
host:
type: string
description: The domain name to exclude from the tunnel. If host is present,
address must not be present.
example: '*.example.com'
split_tunnel_include:
type: object
required:
- address
- description
properties:
address:
type: string
description: The address in CIDR format to include in the tunnel. If address
is present, host must not be present.
example: 192.0.2.0/24
description:
type: string
description: A description of the split tunnel item, displayed in the client
UI.
example: Include testing domains from the tunnel
maxLength: 100
host:
type: string
description: The domain name to include in the tunnel. If host is present,
address must not be present.
example: '*.example.com'
split_tunnel_include_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/split_tunnel_include'
split_tunnel_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/split_tunnel'
ssh_props:
allOf:
- $ref: '#/components/schemas/self_hosted_props'
- properties:
type:
type: string
description: The application type.
example: ssh
ssl:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- ssl
example: ssl
value:
$ref: '#/components/schemas/ssl_value'
title: SSL
description: 'SSL encrypts your visitor''s connection and safeguards credit
card numbers and other personal data to and from your website. SSL can take
up to 5 minutes to fully activate. Requires Cloudflare active on your root
domain or www domain. Off: no SSL between the visitor and Cloudflare, and
no SSL between Cloudflare and your web server (all HTTP traffic). Flexible:
SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site,
but no SSL between Cloudflare and your web server. You don''t need to have
an SSL cert on your web server, but your vistors will still see the site as
being HTTPS enabled. Full: SSL between the visitor and Cloudflare -- visitor
sees HTTPS on your site, and SSL between Cloudflare and your web server. You''ll
need to have your own SSL cert or self-signed cert at the very least. Full
(Strict): SSL between the visitor and Cloudflare -- visitor sees HTTPS on
your site, and SSL between Cloudflare and your web server. You''ll need to
have a valid SSL certificate installed on your web server. This certificate
must be signed by a certificate authority, have an expiration date in the
future, and respond for the request domain name (hostname). (https://support.cloudflare.com/hc/en-us/articles/200170416).'
ssl_recommender:
allOf:
- properties:
enabled:
$ref: '#/components/schemas/ssl_recommender_enabled'
id:
description: Enrollment value for SSL/TLS Recommender.
enum:
- ssl_recommender
example: ssl_recommender
- properties:
editable:
$ref: '#/components/schemas/editable'
modified_on:
$ref: '#/components/schemas/properties-modified_on'
title: SSL/TLS Recommender
description: Enrollment in the SSL/TLS Recommender service which tries to detect
and recommend (by sending periodic emails) the most secure SSL/TLS setting
your origin servers support.
ssl_recommender_enabled:
type: boolean
description: ssl-recommender enrollment setting.
default: false
ssl_universal_settings_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/universal'
ssl_validation_method_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
status:
$ref: '#/components/schemas/validation_method_components-schemas-status'
validation_method:
$ref: '#/components/schemas/validation_method_definition'
ssl_value:
type: string
description: |-
Value of the zone setting.
Notes: Depends on the zone's plan level
enum:
- "off"
- flexible
- full
- strict
default: "off"
ssl_verification_response_collection:
allOf:
- properties:
result:
type: array
items:
$ref: '#/components/schemas/verification'
sslpost:
oneOf:
- type: object
properties:
bundle_method:
type: string
description: A ubiquitous bundle has the highest probability of being
verified everywhere, even by clients using outdated or unusual trust
stores. An optimal bundle uses the shortest chain and newest intermediates.
And the force bundle verifies the chain, but does not otherwise modify
it.
enum:
- ubiquitous
- optimal
- force
default: ubiquitous
example: ubiquitous
custom_certificate:
type: string
description: If a custom uploaded certificate is used.
example: '-----BEGIN CERTIFICATE-----\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\n-----END
CERTIFICATE-----\n'
custom_key:
type: string
description: The key for a custom uploaded certificate.
example: |
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG
dtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn
abIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid
tnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py
FxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE
ewooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb
HBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/
axiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb
+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g
+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv
KLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7
9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo
/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu
iacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9
N2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe
VAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB
vULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U
lySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR
9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7
mEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX
dFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe
PG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS
fhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W
qu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T
lv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi
-----END RSA PRIVATE KEY-----
method:
description: Domain control validation (DCV) method used for this hostname.
enum:
- http
- txt
- email
example: http
settings:
$ref: '#/components/schemas/sslsettings'
type:
description: Level of validation to be used for this hostname. Domain
validation (dv) must be used.
enum:
- dv
example: dv
readOnly: true
wildcard:
type: boolean
description: Indicates whether the certificate covers a wildcard.
example: false
type: object
description: SSL properties used when creating the custom hostname.
sslsettings:
type: object
description: SSL specific settings.
properties:
ciphers:
type: array
description: An allowlist of ciphers for TLS termination. These ciphers
must be in the BoringSSL format.
example:
- ECDHE-RSA-AES128-GCM-SHA256
- AES128-SHA
uniqueItems: true
items:
type: string
early_hints:
description: Whether or not Early Hints is enabled.
enum:
- "on"
- "off"
example: "on"
http2:
description: Whether or not HTTP2 is enabled.
enum:
- "on"
- "off"
example: "on"
min_tls_version:
description: The minimum TLS version supported.
enum:
- "1.0"
- "1.1"
- "1.2"
- "1.3"
example: "1.2"
tls_1_3:
description: Whether or not TLS 1.3 is enabled.
enum:
- "on"
- "off"
example: "on"
stage:
type: object
description: The status of the deployment.
readOnly: true
properties:
ended_on:
type: string
format: date-time
description: When the stage ended.
example: 2021-03-09T00:58:59.045655
nullable: true
readOnly: true
name:
type: string
description: The current build stage.
example: deploy
pattern: queued|initialize|clone_repo|build|deploy
started_on:
type: string
format: date-time
description: When the stage started.
example: "2021-03-09T00:55:03.923456Z"
nullable: true
readOnly: true
status:
type: string
description: State of the current stage.
example: success
readOnly: true
pattern: success|idle|active|failure|canceled
start_time_seconds:
type: integer
description: Specifies the start time for the video clip in seconds.
readOnly: true
state:
type: string
description: The state that the subscription is in.
enum:
- Trial
- Provisioned
- Paid
- AwaitingPayment
- Cancelled
- Failed
- Expired
example: Paid
readOnly: true
status:
type: string
description: Status of the token.
enum:
- active
- disabled
- expired
example: active
status_event_id:
type: string
example: 25756b2dfe6e378a06b033b670413757
status_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
estimated_queued_users:
$ref: '#/components/schemas/estimated_queued_users'
estimated_total_active_users:
$ref: '#/components/schemas/estimated_total_active_users'
event_id:
$ref: '#/components/schemas/status_event_id'
max_estimated_time_minutes:
$ref: '#/components/schemas/max_estimated_time_minutes'
status:
$ref: '#/components/schemas/waitingroom_components-schemas-status'
std_dev_rtt_ms:
type: number
description: Standard deviation of the RTTs in ms.
steering_policy:
type: string
description: |-
Steering Policy for this load balancer.
- `"off"`: Use `default_pools`.
- `"geo"`: Use `region_pools`/`country_pools`/`pop_pools`. For non-proxied requests, the country for `country_pools` is determined by `location_strategy`.
- `"random"`: Select a pool randomly.
- `"dynamic_latency"`: Use round trip time to select the closest pool in default_pools (requires pool health checks).
- `"proximity"`: Use the pools' latitude and longitude to select the closest pool using the Cloudflare PoP location for proxied requests or the location determined by `location_strategy` for non-proxied requests.
- `""`: Will map to `"geo"` if you use `region_pools`/`country_pools`/`pop_pools` otherwise `"off"`.
enum:
- "off"
- geo
- random
- dynamic_latency
- proximity
- '""'
default: '""'
example: dynamic_latency
stix_identifier:
type: string
description: 'STIX 2.1 identifier: https://docs.oasis-open.org/cti/stix/v2.1/cs02/stix-v2.1-cs02.html#_64yvzeku5a5c'
example: ipv4-addr--baa568ec-6efe-5902-be55-0663833db537
stored_components-schemas-result:
allOf:
- $ref: '#/components/schemas/schemas-result'
- properties:
data:
example:
- metrics:
- - 2
- 4
- - 16
- 32
max:
example:
storedBytes: 32
storedKeys: 4
min:
example:
storedBytes: 16
storedKeys: 2
query:
$ref: '#/components/schemas/components-schemas-query'
totals:
example:
storedBytes: 48
storedKeys: 6
string_constraint:
type: object
description: String constraint.
required:
- operator
- value
properties:
operator:
description: The matches operator can use asterisks and pipes as wildcard
and 'or' operators.
enum:
- matches
- contains
- equals
- not_equal
- not_contain
default: contains
value:
type: string
description: The value to apply the operator to.
subcategory:
type: object
properties:
beta:
$ref: '#/components/schemas/beta'
class:
$ref: '#/components/schemas/class'
description:
$ref: '#/components/schemas/categories_components-schemas-description'
id:
$ref: '#/components/schemas/categories_components-schemas-id'
name:
$ref: '#/components/schemas/categories_components-schemas-name'
subdomain:
type: string
description: The DNS Over HTTPS domain to send DNS requests to. (auto-generated).
example: oli3n9zkz5
subdomain-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
properties:
name:
readOnly: true
subscription:
allOf:
- $ref: '#/components/schemas/subscription-v2'
type: object
subscription-v2:
type: object
properties:
app:
properties:
install_id:
$ref: '#/components/schemas/install_id'
component_values:
$ref: '#/components/schemas/component_values'
currency:
$ref: '#/components/schemas/currency'
current_period_end:
$ref: '#/components/schemas/current_period_end'
current_period_start:
$ref: '#/components/schemas/current_period_start'
frequency:
$ref: '#/components/schemas/frequency'
id:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
price:
$ref: '#/components/schemas/price'
rate_plan:
$ref: '#/components/schemas/rate_plan'
state:
$ref: '#/components/schemas/state'
zone:
$ref: '#/components/schemas/zone'
subscription-v2_components-schemas-identifier:
type: string
description: Subscription identifier tag.
example: 506e3185e9c882d175a2d0cb0093d9f2
readOnly: true
maxLength: 32
suggested_threshold:
type: integer
description: The suggested threshold in requests done by the same auth_id or
period_seconds.
readOnly: true
support_url:
type: string
description: The URL to launch when the Send Feedback button is clicked.
example: https://1.1.1.1/help
supported_tld:
type: boolean
description: Whether a particular TLD is currently supported by Cloudflare Registrar.
Refer to [TLD Policies](https://www.cloudflare.com/tld-policies/) for a list
of supported TLDs.
example: true
suspended:
type: boolean
description: If suspended, no health checks are sent to the origin.
default: false
switch_locked:
type: boolean
description: Whether to allow the user to turn off the WARP switch and disconnect
the client.
example: true
tail-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
properties:
expires_at:
readOnly: true
id:
readOnly: true
url:
readOnly: true
target:
oneOf:
- $ref: '#/components/schemas/url_target'
description: A request condition target.
required:
- target
- constraint
target_result:
type: object
properties:
colos:
type: array
items:
$ref: '#/components/schemas/colo_result'
target:
$ref: '#/components/schemas/schemas-target'
target_summary:
type: object
description: Aggregated statistics from all hops about the target.
example:
asn: ""
ip: 1.1.1.1
max_latency_ms: 0.034
mean_latency_ms: 0.021
min_latency_ms: 0.014
name: 1.1.1.1
packet_count: 3
std_dev_latency_ms: 0.011269427669584647
targets:
type: array
description: The rule targets to evaluate on each request.
example:
- constraint:
operator: matches
value: '*example.com/images/*'
target: url
items:
$ref: '#/components/schemas/target'
tcp_config:
type: object
description: Parameters specific to TCP health check.
nullable: true
properties:
method:
type: string
description: The TCP connection method to use for the health check.
enum:
- connection_established
default: connection_established
port:
type: integer
description: Port number to connect to for the health check. Defaults to
80.
default: 80
teamnet:
type: object
required:
- network
- tunnel_id
- comment
- created_at
properties:
comment:
$ref: '#/components/schemas/comment'
created_at:
description: Timestamp of when the route was created.
deleted_at:
type: string
format: date-time
description: Timestamp of when the route was deleted. If `null`, the route
has not been deleted.
example: "2021-01-25T18:22:34.317854Z"
nullable: true
readOnly: true
network:
$ref: '#/components/schemas/ip_network'
tunnel_id:
$ref: '#/components/schemas/schemas-tunnel_id'
tunnel_name:
$ref: '#/components/schemas/schemas-tunnel_name'
virtual_network_id:
$ref: '#/components/schemas/virtual_network_id'
teamnet_components-schemas-ip:
type: string
example: 10.1.0.137
telephone:
type: string
description: User's telephone number
example: +1 123-123-1234
nullable: true
maxLength: 20
test_connection_properties:
type: object
properties:
body_hash:
type: string
description: Hash version of body.
example: be27f2429421e12f200cab1da43ba301bdc70e1d
body_size:
type: string
description: Size of the body in bytes.
example: 63910 bytes
cf-cache-status:
type: string
description: Lists any `cf-cache-status` present.
cf-ray:
type: string
description: Lists any `cf-ray` present.
example: 1ddd7570575207d9-LAX
cf-wan-error:
type: string
description: Lists any `cf-wan-error` present.
cloudflare:
type: string
description: Whether Cloudflare is enabled on the host.
example: "on"
connection_close:
type: boolean
description: Connection closed or open.
default: true
example: false
elapsed_time:
type: string
description: Amount of seconds that the test lasted.
example: 0.239013s
host_name:
type: string
description: The hostname queried.
example: www.example.com
http_status:
type: number
description: The HTTP status response code.
example: 200
method:
description: HTTP Method used to test the connection.
enum:
- GET
- POST
example: GET
missing_headers:
type: string
description: What headers are missing.
example: No Content-Length or Transfer-Encoding.
protocol:
type: string
description: Protocol used to test the connection.
example: HTTP/1.1
railgun:
type: string
description: Indicates if Railgun is enabled on the queried hostname.
example: "on"
response_status:
type: string
description: HTTP Status code.
example: 200 OK
url:
type: string
description: Url of the domain you can compare the connection to.
example: https://www.cloudflare.com
test_connection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/test_connection_properties'
threats:
type: object
description: Breakdown of totals for threats.
properties:
all:
type: integer
description: The total number of identifiable threats received over the
time frame.
country:
type: object
description: A list of key/value pairs where the key is a two-digit country
code and the value is the number of malicious requests received from that
country.
example:
AU: 91
CN: 523423
US: 123
type:
type: object
description: The list of key/value pairs where the key is a threat category
and the value is the number of requests.
example:
hot.ban.unknown: 5324
macro.chl.captchaErr: 1341
macro.chl.jschlErr: 5323
user.ban.ip: 123
threshold:
type: number
description: The threshold that will trigger the configured mitigation action.
Configure this value along with the `period` property to establish a threshold
per period.
example: 60
minimum: 1
thresholds:
type: object
readOnly: true
required:
- period_seconds
- suggested_threshold
- p50
- p90
- p99
- requests
- auth_id_tokens
- data_points
- last_updated
properties:
thresholds:
type: object
properties:
auth_id_tokens:
$ref: '#/components/schemas/auth_id_tokens'
data_points:
$ref: '#/components/schemas/data_points'
last_updated:
$ref: '#/components/schemas/timestamp'
p50:
$ref: '#/components/schemas/p50'
p90:
$ref: '#/components/schemas/p90'
p99:
$ref: '#/components/schemas/p99'
period_seconds:
$ref: '#/components/schemas/period_seconds'
requests:
$ref: '#/components/schemas/requests'
suggested_threshold:
$ref: '#/components/schemas/suggested_threshold'
thumbnail_url:
type: string
format: uri
description: The media item's thumbnail URI. This field is omitted until encoding
is complete.
example: https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/thumbnails/thumbnail.jpg
readOnly: true
thumbnailTimestampPct:
type: number
description: The timestamp for a thumbnail image calculated as a percentage
value of the video's duration. To convert from a second-wise timestamp to
a percentage, divide the desired timestamp by the total duration of the video. If
this value is not set, the default thumbnail image is taken from 0s of the
video.
default: 0
example: 0.529241
minimum: 0
maximum: 1
time:
type: string
description: The time for a specific event.
example: "2019-10-24T17:09:42.883908+01:00"
timeout:
type: number
description: |-
The time in seconds during which Cloudflare will perform the mitigation action. Must be an integer value greater than or equal to the period.
Notes: If "mode" is "challenge", "managed_challenge", or "js_challenge", Cloudflare will use the zone's Challenge Passage time and you should not provide this value.
example: 86400
minimum: 1
maximum: 86400
timeseries:
type: array
description: Time deltas containing metadata about each bucket of time. The
number of buckets (resolution) is determined by the amount of time between
the since and until parameters.
items:
type: object
properties:
bandwidth:
$ref: '#/components/schemas/bandwidth'
pageviews:
$ref: '#/components/schemas/pageviews'
requests:
$ref: '#/components/schemas/schemas-requests'
since:
$ref: '#/components/schemas/since'
threats:
$ref: '#/components/schemas/threats'
uniques:
$ref: '#/components/schemas/uniques'
until:
$ref: '#/components/schemas/until'
timeseries_by_colo:
type: array
description: Time deltas containing metadata about each bucket of time. The
number of buckets (resolution) is determined by the amount of time between
the since and until parameters.
items:
type: object
properties:
bandwidth:
$ref: '#/components/schemas/bandwidth_by_colo'
requests:
$ref: '#/components/schemas/requests_by_colo'
since:
$ref: '#/components/schemas/since'
threats:
$ref: '#/components/schemas/threats'
until:
$ref: '#/components/schemas/until'
timestamp:
type: string
format: date-time
example: "2014-01-01T05:20:00.12345Z"
readOnly: true
tls:
type: string
description: The type of TLS termination associated with the application.
enum:
- "off"
- flexible
- full
- strict
example: full
tls-settings:
type: object
description: TLS interception settings.
properties:
enabled:
type: boolean
description: Enable inspecting encrypted HTTP traffic.
example: true
tls_1_2_only:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: Zone setting identifier.
enum:
- tls_1_2_only
example: tls_1_2_only
value:
$ref: '#/components/schemas/tls_1_2_only_value'
title: TLS1.2 only
description: Only allows TLS1.2.
tls_1_2_only_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
tls_1_3:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- tls_1_3
example: tls_1_3
value:
$ref: '#/components/schemas/tls_1_3_value'
title: Enable TLS 1.3 value for a zone
description: Enables Crypto TLS 1.3 feature for a zone.
default: "off"
tls_1_3_value:
type: string
description: |-
Value of the zone setting.
Notes: Default value depends on the zone's plan level.
enum:
- "on"
- "off"
- zrt
default: "off"
tls_client_auth:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- tls_client_auth
example: tls_client_auth
value:
$ref: '#/components/schemas/tls_client_auth_value'
title: TLS Client Authentication
description: TLS Client Auth requires Cloudflare to connect to your origin server
using a client certificate (Enterprise Only).
tls_client_auth_value:
type: string
description: value of the zone setting.
enum:
- "on"
- "off"
default: "on"
token:
type: object
required:
- id
- name
- status
- policies
properties:
condition:
$ref: '#/components/schemas/condition'
expires_on:
$ref: '#/components/schemas/expires_on'
id:
$ref: '#/components/schemas/components-schemas-identifier'
issued_on:
$ref: '#/components/schemas/issued_on'
modified_on:
$ref: '#/components/schemas/modified_on'
name:
$ref: '#/components/schemas/name'
not_before:
$ref: '#/components/schemas/not_before'
policies:
$ref: '#/components/schemas/policies'
status:
$ref: '#/components/schemas/status'
total-tls_components-schemas-enabled:
type: boolean
description: If enabled, Total TLS will order a hostname specific TLS certificate
for any proxied A, AAAA, or CNAME record in your zone.
example: true
total_active_users:
type: integer
description: Sets the total number of active user sessions on the route at a
point in time. A route is a combination of host and path on which a waiting
room is available. This value is used as a baseline for the total number of
active user sessions on the route. It is possible to have a situation where
there are more or less active users sessions on the route based on the traffic
patterns at that time around the world.
minimum: 200
maximum: 2.147483647e+09
total_tls_settings_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
certificate_authority:
$ref: '#/components/schemas/schemas-certificate_authority'
enabled:
$ref: '#/components/schemas/total-tls_components-schemas-enabled'
validity_days:
$ref: '#/components/schemas/schemas-validity_days'
totals:
type: object
description: Breakdown of totals by data type.
properties:
bandwidth:
$ref: '#/components/schemas/bandwidth'
pageviews:
$ref: '#/components/schemas/pageviews'
requests:
$ref: '#/components/schemas/schemas-requests'
since:
$ref: '#/components/schemas/since'
threats:
$ref: '#/components/schemas/threats'
uniques:
$ref: '#/components/schemas/uniques'
until:
$ref: '#/components/schemas/until'
totals_by_colo:
type: object
description: Breakdown of totals by data type.
properties:
bandwidth:
$ref: '#/components/schemas/bandwidth_by_colo'
requests:
$ref: '#/components/schemas/requests_by_colo'
since:
$ref: '#/components/schemas/since'
threats:
$ref: '#/components/schemas/threats'
until:
$ref: '#/components/schemas/until'
traceroute_components-schemas-ip:
type: string
description: IP address of the node.
traceroute_components-schemas-name:
type: string
description: Host name of the address, this may be the same as the IP address.
traceroute_components-schemas-port:
type: integer
description: For UDP and TCP, specifies the destination port. For ICMP, specifies
the initial ICMP sequence value. Default value 0 will choose the best value
to use for each protocol.
default: 0
minimum: 0
maximum: 65535
traceroute_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/target_result'
traceroute_time_ms:
type: integer
description: Total time of traceroute in ms.
traditional_allow_rule:
allOf:
- $ref: '#/components/schemas/rule_components-schemas-base-2'
- properties:
allowed_modes:
$ref: '#/components/schemas/allowed_modes_allow_traditional'
mode:
$ref: '#/components/schemas/mode_allow_traditional'
title: Traditional (allow) WAF rule
description: When triggered, traditional WAF rules cause the firewall to immediately
act on the request based on the rule configuration. An 'allow' rule will immediately
allow the request and no other rules will be processed.
required:
- id
- description
- priority
- allowed_modes
- default_mode
- mode
- group
- package_id
traditional_deny_rule:
allOf:
- $ref: '#/components/schemas/rule_components-schemas-base-2'
- properties:
allowed_modes:
$ref: '#/components/schemas/allowed_modes_deny_traditional'
default_mode:
$ref: '#/components/schemas/default_mode'
mode:
$ref: '#/components/schemas/mode_deny_traditional'
title: Traditional (deny) WAF rule
description: When triggered, traditional WAF rules cause the firewall to immediately
act upon the request based on the configuration of the rule. A 'deny' rule
will immediately respond to the request based on the configured rule action/mode
(for example, 'block') and no other rules will be processed.
required:
- id
- description
- priority
- allowed_modes
- default_mode
- mode
- group
- package_id
traffic:
type: string
description: The wirefilter expression to be used for traffic matching.
example: http.request.uri matches ".*a/partial/uri.*" and http.request.host
in $01302951-49f9-47c9-a400-0297e60b6a10
traffic_type:
type: string
description: Determines how data travels from the edge to your origin. When
set to "direct", Spectrum will send traffic directly to your origin, and the
application's type is derived from the `protocol`. When set to "http" or "https",
Spectrum will apply Cloudflare's HTTP/HTTPS features as it sends traffic to
your origin, and the application type matches this property exactly.
enum:
- direct
- http
- https
default: direct
example: direct
transfer_in:
description: Statuses for domain transfers into Cloudflare Registrar.
properties:
accept_foa:
description: Form of authorization has been accepted by the registrant.
example: needed
approve_transfer:
description: Shows transfer status with the registry.
example: unknown
can_cancel_transfer:
type: boolean
description: Indicates if cancellation is still possible.
example: true
disable_privacy:
description: Privacy guards are disabled at the foreign registrar.
enter_auth_code:
description: Auth code has been entered and verified.
example: needed
unlock_domain:
description: Domain is unlocked at the foreign registrar.
transform-rules_components-schemas-rule:
properties:
action:
example: rewrite
action_parameters:
$ref: '#/components/schemas/schemas-action_parameters'
description:
example: change request based on ip location
expression:
example: ip.geoip.country eq "AL"
id:
example: 3a03d665bac047339bb530ecb439a90d
version:
example: "1"
true_client_ip_header:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- true_client_ip_header
example: true_client_ip_header
value:
$ref: '#/components/schemas/true_client_ip_header_value'
title: True Client IP Header
description: Allows customer to continue to use True Client IP (Akamai feature)
in the headers we send to the origin. This is limited to Enterprise Zones.
default: "off"
true_client_ip_header_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
tsig:
type: object
required:
- id
- name
- secret
- algo
properties:
algo:
$ref: '#/components/schemas/algo'
id:
$ref: '#/components/schemas/tsig_components-schemas-identifier'
name:
$ref: '#/components/schemas/tsig_components-schemas-name'
secret:
$ref: '#/components/schemas/secret'
tsig_components-schemas-identifier:
example: 69cd1e104af3e6ed3cb344f263fd0d5a
tsig_components-schemas-name:
type: string
description: TSIG key name.
example: tsig.customer.cf.
tsig_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/tsig'
tsig_id:
type: string
description: TSIG authentication will be used for zone transfer if configured.
example: 69cd1e104af3e6ed3cb344f263fd0d5a
ttl:
anyOf:
- type: number
example: 3600
minimum: 60
maximum: 86400
- type: number
enum:
- 1
type: number
description: Time to live, in seconds, of the DNS record. Must be between 60
and 86400, or 1 for 'automatic'.
example: 3600
tunnel:
type: object
description: A Cloudflare Tunnel that connects your origin to Cloudflare's edge.
properties:
account_tag:
$ref: '#/components/schemas/cf_account_id'
connections:
$ref: '#/components/schemas/connections'
conns_active_at:
$ref: '#/components/schemas/conns_active_at'
conns_inactive_at:
$ref: '#/components/schemas/conns_inactive_at'
created_at:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-created_at'
deleted_at:
$ref: '#/components/schemas/schemas-deleted_at'
id:
$ref: '#/components/schemas/tunnel_id'
metadata:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-metadata'
name:
$ref: '#/components/schemas/tunnel_name'
remote_config:
$ref: '#/components/schemas/remote_config'
status:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-status'
tun_type:
$ref: '#/components/schemas/tunnel_type'
tunnel_add_single_request:
type: object
required:
- name
- customer_gre_endpoint
- cloudflare_gre_endpoint
- interface_address
properties:
cloudflare_gre_endpoint:
$ref: '#/components/schemas/cloudflare_gre_endpoint'
customer_gre_endpoint:
$ref: '#/components/schemas/customer_gre_endpoint'
description:
$ref: '#/components/schemas/gre-tunnel_components-schemas-description'
health_check:
$ref: '#/components/schemas/health_check'
interface_address:
$ref: '#/components/schemas/interface_address'
mtu:
$ref: '#/components/schemas/mtu'
name:
$ref: '#/components/schemas/gre-tunnel_components-schemas-name'
ttl:
$ref: '#/components/schemas/components-schemas-ttl'
tunnel_connection:
type: object
description: A connection between cloudflared and a Cloudflare data center.
properties:
arch:
$ref: '#/components/schemas/arch'
config_version:
$ref: '#/components/schemas/config_version'
conns:
$ref: '#/components/schemas/connections'
features:
$ref: '#/components/schemas/schemas-features'
id:
$ref: '#/components/schemas/connection_id'
run_at:
$ref: '#/components/schemas/run_at'
version:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-version'
tunnel_connections_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/tunnel_connection'
tunnel_deleted_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
deleted:
type: boolean
example: true
deleted_gre_tunnel:
type: object
tunnel_health_check:
type: object
properties:
enabled:
type: boolean
description: Determines whether to run healthchecks for a tunnel.
default: true
example: true
target:
type: string
description: The address used to run healthchecks for a tunnel. This field
defaults to `customer_gre_endpoint address`.
example: 203.0.113.1
type:
type: string
description: The type of healthcheck to run, reply or request. The default
value is `reply`.
enum:
- reply
- request
default: reply
example: request
tunnel_id:
type: string
description: UUID of the tunnel.
example: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
readOnly: true
maxLength: 36
tunnel_modified_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
modified:
type: boolean
example: true
modified_gre_tunnel:
type: object
tunnel_name:
type: string
description: A user-friendly name for the tunnel.
example: blog
tunnel_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/argo-tunnel'
tunnel_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
tunnel_response_token:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: string
tunnel_secret:
type: string
description: Sets the password required to run a locally-managed tunnel. Must
be at least 32 bytes and encoded as a base64 string.
example: AQIDBAUGBwgBAgMEBQYHCAECAwQFBgcIAQIDBAUGBwg=
tunnel_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
gre_tunnel:
type: object
tunnel_type:
type: string
description: The type of tunnel.
enum:
- cfd_tunnel
example: cfd_tunnel
tunnel_update_request:
allOf:
- $ref: '#/components/schemas/tunnel_add_single_request'
tunnels_collection_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
gre_tunnels:
type: array
items:
$ref: '#/components/schemas/gre-tunnel'
tus_resumable:
type: string
description: |-
Specifies the TUS protocol version. This value must be included in every upload request.
Notes: The only supported version of TUS protocol is 1.0.0.
enum:
- 1.0.0
example: 1.0.0
two_factor_authentication_enabled:
type: boolean
description: Indicates whether two-factor authentication is enabled for the
user account. Does not apply to API authentication.
default: false
readOnly: true
type:
type: string
description: The billing item type.
example: charge
readOnly: true
maxLength: 30
ua-rules:
allOf:
- $ref: '#/components/schemas/firewalluablock'
type: object
ua-rules_components-schemas-description:
type: string
description: An informative summary of the rule.
example: Prevent access from abusive clients identified by this User Agent to
mitigate a DDoS attack
maxLength: 1024
ua-rules_components-schemas-id:
type: string
description: The unique identifier of the User Agent Blocking rule.
example: 372e67954025e0ba6aaa6d586b9e0b59
readOnly: true
maxLength: 32
ua-rules_components-schemas-mode:
description: The action to apply to a matched request.
enum:
- block
- challenge
- js_challenge
- managed_challenge
example: js_challenge
maxLength: 12
uid:
description: The unique API identifier for the user.
uniques:
type: object
properties:
all:
type: integer
description: Total number of unique IP addresses within the time range.
unit_price:
type: number
description: The unit price of the addon.
example: 1
readOnly: true
universal:
type: object
properties:
enabled:
$ref: '#/components/schemas/components-schemas-enabled'
unrevoke_devices_request:
type: array
description: A list of device ids to unrevoke.
maxLength: 200
items:
$ref: '#/components/schemas/uuid'
until:
anyOf:
- type: string
- type: integer
description: The (exclusive) end of the requested time frame. This value can
be a negative integer representing the number of minutes in the past relative
to time the request is made, or can be an absolute timestamp that conforms
to RFC 3339. If omitted, the time of the request is used.
default: 0
example: "2015-01-02T12:23:00Z"
update-zone-settings-response:
properties:
enabled:
$ref: '#/components/schemas/script-monitor_components-schemas-enabled'
updated_at:
$ref: '#/components/schemas/schemas-updated_at'
use_cloudflare_reporting_endpoint:
$ref: '#/components/schemas/use_cloudflare_reporting_endpoint'
use_connection_url_path:
$ref: '#/components/schemas/use_connection_url_path'
update_catch_all_rule_properties:
type: object
required:
- actions
- matchers
properties:
actions:
$ref: '#/components/schemas/catchall-actions'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled'
matchers:
$ref: '#/components/schemas/catchall-matchers'
name:
$ref: '#/components/schemas/rules_components-schemas-name'
update_custom_profile:
type: object
title: Update custom profile
properties:
description:
type: string
description: The description of the profile.
example: A standard CVV card number
entries:
type: array
description: The entries for this profile. Array elements with IDs are modifying
the existing entry with that ID. Elements without ID will create new entries.
Any entry not in the list will be deleted.
items:
$ref: '#/components/schemas/custom_entry'
name:
type: string
description: The name of the profile.
example: Generic CVV Card Number
update_input_request:
properties:
defaultCreator:
$ref: '#/components/schemas/live_input_default_creator'
meta:
$ref: '#/components/schemas/live_input_metadata'
recording:
$ref: '#/components/schemas/live_input_recording_settings'
update_output_request:
required:
- enabled
properties:
enabled:
$ref: '#/components/schemas/output_enabled'
update_predefined_profile:
type: object
title: Update predefined profile
properties:
entries:
type: array
description: The entries for this profile.
items:
properties:
enabled:
type: boolean
description: Wheter the entry is enabled or not.
example: true
id:
$ref: '#/components/schemas/entry_id'
update_rule_properties:
type: object
required:
- actions
- matchers
properties:
actions:
$ref: '#/components/schemas/actions'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled'
matchers:
$ref: '#/components/schemas/matchers'
name:
$ref: '#/components/schemas/rules_components-schemas-name'
priority:
$ref: '#/components/schemas/components-schemas-priority'
update_rules:
type: array
items:
$ref: '#/components/schemas/create_rule'
update_ruleset:
type: object
description: A ruleset object.
required:
- rules
properties:
description:
$ref: '#/components/schemas/rulesets_components-schemas-description'
rules:
$ref: '#/components/schemas/create_update_rules'
updated:
type: string
format: date-time
description: When the device was updated.
example: "2017-06-14T00:00:00Z"
updated_at:
type: string
format: date-time
description: The time when the certificate was updated.
example: "2100-01-01T05:20:00Z"
readOnly: true
upgrade_info:
type: object
description: Defined when the Railgun version is out of date from the latest
release from Cloudflare.
properties:
download_link:
type: string
description: An HTTP link to download the latest Railgun binary.
example: https://www.cloudflare.com/downloads/railgun
latest_version:
type: string
description: Latest version of the Railgun receiver available to install.
example: 1.0.0
upload_length:
type: integer
description: Indicates the size of the entire upload in bytes. The value must
be a non-negative integer.
minimum: 0
uploaded:
type: string
format: date-time
description: The date and time the media item was uploaded.
example: "2014-01-02T02:20:00Z"
readOnly: true
uploaded_on:
type: string
format: date-time
description: When the certificate was uploaded to Cloudflare.
example: "2014-01-01T05:20:00Z"
readOnly: true
uptycs_config_request:
type: object
required:
- client_key
- customer_id
- client_secret
properties:
client_key:
type: string
description: The Uptycs client secret.
example: example client key
client_secret:
type: string
description: The Uptycs client secret.
example: example client secret
customer_id:
type: string
description: The Uptycs customer ID.
example: example customer id
url:
type: string
format: uri
description: The URL associated with the custom page.
default: ""
example: http://www.example.com
url_normalization_components-schemas-type:
type: string
description: The type of URL normalization performed by Cloudflare.
example: cloudflare
url_param:
type: object
properties:
url:
$ref: '#/components/schemas/components-schemas-url'
url_target:
type: object
description: URL target.
properties:
constraint:
allOf:
- $ref: '#/components/schemas/string_constraint'
- properties:
value:
type: string
description: The URL pattern to match against the current request.
The pattern may contain up to four asterisks ('*') as placeholders.
example: '*example.com/images/*'
pattern: ^(https?://)?(([-a-zA-Z0-9*]*\.)+[-a-zA-Z0-9]{2,20})(:(8080|8443|443|80))?(/[\S]+)?$
type: object
description: The constraint of a target.
target:
description: A target based on the URL of the request.
enum:
- url
example: url
urls:
type: array
description: The URLs to include in the current WAF override. You can use wildcards.
Each entered URL will be escaped before use, which means you can only use
simple wildcard patterns.
items:
type: string
example: shop.example.com/*
usage-model-response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
properties:
usage_model:
readOnly: true
use_cloudflare_reporting_endpoint:
type: boolean
description: When true, CSP reports will be sent to https://csp-reporting.cloudflare.com/cdn-cgi/script_monitor/report
example: true
use_connection_url_path:
type: boolean
description: When true, the paths associated with connections URLs will also
be analyzed.
example: true
user:
type: object
properties:
email:
$ref: '#/components/schemas/email'
id:
$ref: '#/components/schemas/uuid'
name:
type: string
description: The enrolled device user's name.
example: John Appleseed
user_invite:
allOf:
- $ref: '#/components/schemas/base'
- properties:
status:
description: Current status of the invitation.
enum:
- pending
- accepted
- rejected
- expired
example: accepted
user_subscription_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/subscription'
user_subscription_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
users:
type: object
properties:
access_seat:
$ref: '#/components/schemas/schemas-access_seat'
active_device_count:
$ref: '#/components/schemas/active_device_count'
created_at:
$ref: '#/components/schemas/timestamp'
email:
$ref: '#/components/schemas/components-schemas-email'
gateway_seat:
$ref: '#/components/schemas/schemas-gateway_seat'
id:
$ref: '#/components/schemas/users_components-schemas-id'
last_successful_login:
$ref: '#/components/schemas/last_successful_login'
name:
$ref: '#/components/schemas/users_components-schemas-name'
seat_uid:
$ref: '#/components/schemas/seat_uid'
uid:
$ref: '#/components/schemas/uid'
updated_at:
$ref: '#/components/schemas/timestamp'
users_components-schemas-id:
description: The ID of the user.
example: f3b12456-80dd-4e89-9f5f-ba3dfff12365
users_components-schemas-identifier:
example: 699d98642c564d2e855e9661899b7252
users_components-schemas-name:
type: string
description: The name of the user.
example: Jane Doe
users_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
- properties:
result:
type: array
items:
$ref: '#/components/schemas/users'
uuid:
type: string
description: UUID
example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415
readOnly: true
maxLength: 36
validate_ownership_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
nullable: true
properties:
valid:
type: boolean
example: true
validate_pattern:
type: object
title: Pattern
description: A request to validate a pattern
required:
- regex
properties:
regex:
type: string
description: The regex pattern.
example: ^4[0-9]{6,}$
validate_response:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
nullable: true
properties:
message:
type: string
example: ""
valid:
type: boolean
example: true
validation_method:
type: string
description: Validation Method selected for the order.
enum:
- txt
- http
- email
example: txt
validation_method_components-schemas-status:
type: string
description: Result status.
example: pending_validation
validation_method_definition:
type: string
description: Desired validation method.
enum:
- http
- cname
- txt
- email
example: txt
validation_record:
type: object
description: Certificate's required validation record.
properties:
emails:
type: array
description: The set of email addresses that the certificate authority (CA)
will use to complete domain validation.
example:
- administrator@example.com
- webmaster@example.com
items: {}
http_body:
type: string
description: The content that the certificate authority (CA) will expect
to find at the http_url during the domain validation.
example: ca3-574923932a82475cb8592200f1a2a23d
http_url:
type: string
description: The url that will be checked during domain validation.
example: http://app.example.com/.well-known/pki-validation/ca3-da12a1c25e7b48cf80408c6c1763b8a2.txt
txt_name:
type: string
description: The hostname that the certificate authority (CA) will check
for a TXT record during domain validation .
example: _acme-challenge.app.example.com
txt_value:
type: string
description: The TXT record that the certificate authority (CA) will check
during domain validation.
example: 810b7d5f01154524b961ba0cd578acc2
validity_days:
type: integer
description: Validity Days selected for the order.
enum:
- 14
- 30
- 90
- 365
value:
type: string
description: The token value.
example: 8M7wS6hCpXVc-DoRnPPY_UCWPgy8aea4Wy6kCe5T
readOnly: true
minLength: 40
maxLength: 80
vanity_name_servers:
type: array
description: |-
An array of domains used for custom name servers. This is only
available for Business and Enterprise plans.
example:
- ns1.example.com
- ns2.example.com
items:
type: string
format: hostname
maxLength: 253
variant_generation_request:
type: object
required:
- id
- options
properties:
id:
$ref: '#/components/schemas/variants_components-schemas-identifier'
neverRequireSignedURLs:
$ref: '#/components/schemas/neverRequireSignedURLs'
options:
$ref: '#/components/schemas/options'
variant_list_response:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
$ref: '#/components/schemas/variants_response'
variant_patch_request:
type: object
required:
- options
properties:
neverRequireSignedURLs:
$ref: '#/components/schemas/neverRequireSignedURLs'
options:
$ref: '#/components/schemas/options'
variant_public_request:
type: object
properties:
hero:
type: object
variant_response:
type: object
properties:
variant:
type: object
variant_simple_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/variant_response'
variants:
allOf:
- $ref: '#/components/schemas/components-schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- variants
example: variants
title: Variants Caching
description: 'Variant support enables caching variants of images with certain
file extensions in addition to the original. This only applies when the origin
server sends the ''Vary: Accept'' response header. If the origin server sends
''Vary: Accept'' but does not serve the variant requested, the response will
not be cached. This will be indicated with BYPASS cache status in the response
headers.'
variants_components-schemas-identifier:
example: hero
maxLength: 99
pattern: ^[a-zA-Z0-9]$
variants_response:
type: object
properties:
variants:
$ref: '#/components/schemas/variant_public_request'
variants_response_value:
properties:
result:
allOf:
- $ref: '#/components/schemas/variants'
- required:
- value
properties:
value:
$ref: '#/components/schemas/variants_value'
variants_value:
type: object
description: Value of the zone setting.
properties:
avif:
type: array
description: List of strings with the MIME types of all the variants that
should be served for avif.
example:
- image/webp
- image/jpeg
uniqueItems: true
items: {}
bmp:
type: array
description: List of strings with the MIME types of all the variants that
should be served for bmp.
example:
- image/webp
- image/jpeg
uniqueItems: true
items: {}
gif:
type: array
description: List of strings with the MIME types of all the variants that
should be served for gif.
example:
- image/webp
- image/jpeg
uniqueItems: true
items: {}
jp2:
type: array
description: List of strings with the MIME types of all the variants that
should be served for jp2.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
jpeg:
type: array
description: List of strings with the MIME types of all the variants that
should be served for jpeg.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
jpg:
type: array
description: List of strings with the MIME types of all the variants that
should be served for jpg.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
jpg2:
type: array
description: List of strings with the MIME types of all the variants that
should be served for jpg2.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
png:
type: array
description: List of strings with the MIME types of all the variants that
should be served for png.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
tif:
type: array
description: List of strings with the MIME types of all the variants that
should be served for tif.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
tiff:
type: array
description: List of strings with the MIME types of all the variants that
should be served for tiff.
example:
- image/webp
- image/avif
uniqueItems: true
items: {}
webp:
type: array
description: List of strings with the MIME types of all the variants that
should be served for webp.
example:
- image/jpeg
- image/avif
uniqueItems: true
items: {}
verification:
type: object
required:
- certificate_status
properties:
brand_check:
$ref: '#/components/schemas/brand_check'
cert_pack_uuid:
$ref: '#/components/schemas/cert_pack_uuid'
certificate_status:
$ref: '#/components/schemas/certificate_status'
signature:
$ref: '#/components/schemas/schemas-signature'
validation_method:
$ref: '#/components/schemas/schemas-validation_method'
verification_info:
$ref: '#/components/schemas/verification_info'
verification_status:
$ref: '#/components/schemas/verification_status'
verification_type:
$ref: '#/components/schemas/verification_type'
verification_errors:
type: array
description: These are errors that were encountered while trying to activate
a hostname.
example:
- None of the A or AAAA records are owned by this account and the pre-generated
ownership verification token was not found.
items: {}
verification_info:
type: object
description: Certificate's required verification information.
enum:
- record_name
- record_value
- http_url
- http_body
- cname
- cname_target
- txt_name
- txt_value
properties:
record_name:
type: string
format: hostname
description: Name of CNAME record.
example: b3b90cfedd89a3e487d3e383c56c4267.example.com
record_target:
type: string
format: hostname
description: Target of CNAME record.
example: 6979be7e4cfc9e5c603e31df7efac9cc60fee82d.comodoca.com
verification_status:
type: boolean
description: Status of the required verification information, omitted if verification
status is unknown.
example: true
verification_type:
type: string
description: Method of verification.
enum:
- cname
- meta tag
example: cname
verified:
type: string
format: date-time
description: The date and time the destination address has been verified. Null
means not verified yet.
example: "2014-01-02T02:20:00Z"
readOnly: true
version:
type: string
description: The version of the ruleset.
example: "1"
pattern: ^[0-9]+$
video_copy_request:
required:
- url
properties:
allowedOrigins:
$ref: '#/components/schemas/allowedOrigins'
creator:
$ref: '#/components/schemas/creator'
requireSignedURLs:
$ref: '#/components/schemas/requireSignedURLs'
thumbnailTimestampPct:
$ref: '#/components/schemas/thumbnailTimestampPct'
url:
type: string
format: uri
description: A video's URL. The server must be publicly routable and support
`HTTP HEAD` requests and `HTTP GET` range requests. The server should
respond to `HTTP HEAD` requests with a `content-range` header that includes
the size of the file.
example: https://example.com/myvideo.mp4
watermark:
$ref: '#/components/schemas/watermark_at_upload'
video_identifier:
type: string
description: A unique identifier for the MP4 file.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
video_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/videos'
- properties:
range:
type: integer
description: The total number of remaining videos based on cursor position.
example: 1000
readOnly: true
total:
type: integer
description: The total number of videos that match the provided filters.
example: 35586
readOnly: true
video_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
videoClipStandard:
type: object
required:
- clippedFromVideoUID
- startTimeSeconds
- endTimeSeconds
properties:
allowedOrigins:
$ref: '#/components/schemas/allowedOrigins'
clippedFromVideoUID:
$ref: '#/components/schemas/clipped_from_video_uid'
creator:
$ref: '#/components/schemas/creator'
endTimeSeconds:
$ref: '#/components/schemas/end_time_seconds'
maxDurationSeconds:
$ref: '#/components/schemas/schemas-maxDurationSeconds'
requireSignedURLs:
$ref: '#/components/schemas/requireSignedURLs'
startTimeSeconds:
$ref: '#/components/schemas/start_time_seconds'
thumbnailTimestampPct:
$ref: '#/components/schemas/thumbnailTimestampPct'
watermark:
$ref: '#/components/schemas/watermarkAtUpload'
videos:
type: object
properties:
allowedOrigins:
$ref: '#/components/schemas/allowedOrigins'
created:
$ref: '#/components/schemas/schemas-created'
creator:
$ref: '#/components/schemas/creator'
duration:
$ref: '#/components/schemas/schemas-duration'
input:
$ref: '#/components/schemas/input'
liveInput:
$ref: '#/components/schemas/liveInput'
maxDurationSeconds:
$ref: '#/components/schemas/maxDurationSeconds'
meta:
$ref: '#/components/schemas/media_metadata'
modified:
$ref: '#/components/schemas/schemas-modified'
nft:
$ref: '#/components/schemas/nft'
playback:
$ref: '#/components/schemas/playback'
preview:
$ref: '#/components/schemas/preview'
readyToStream:
$ref: '#/components/schemas/readyToStream'
requireSignedURLs:
$ref: '#/components/schemas/requireSignedURLs'
size:
$ref: '#/components/schemas/size'
status:
$ref: '#/components/schemas/media_status'
thumbnail:
$ref: '#/components/schemas/thumbnail_url'
thumbnailTimestampPct:
$ref: '#/components/schemas/thumbnailTimestampPct'
uid:
$ref: '#/components/schemas/videos_components-schemas-identifier'
uploadExpiry:
$ref: '#/components/schemas/oneTimeUploadExpiry'
uploaded:
$ref: '#/components/schemas/uploaded'
watermark:
$ref: '#/components/schemas/watermarks'
videos_components-schemas-identifier:
type: string
description: A Cloudflare-generated unique identifier for a media item.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
virtual-dns:
type: object
required:
- id
- name
- origin_ips
- virtual_dns_ips
- minimum_cache_ttl
- maximum_cache_ttl
- deprecate_any_requests
- ecs_fallback
- modified_on
properties:
deprecate_any_requests:
$ref: '#/components/schemas/deprecate_any_requests'
ecs_fallback:
$ref: '#/components/schemas/ecs_fallback'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
maximum_cache_ttl:
$ref: '#/components/schemas/maximum_cache_ttl'
minimum_cache_ttl:
$ref: '#/components/schemas/minimum_cache_ttl'
modified_on:
$ref: '#/components/schemas/schemas-modified_on'
name:
$ref: '#/components/schemas/virtual-dns_components-schemas-name'
negative_cache_ttl:
$ref: '#/components/schemas/schemas-negative_cache_ttl'
origin_ips:
$ref: '#/components/schemas/origin_ips'
ratelimit:
$ref: '#/components/schemas/schemas-ratelimit'
virtual_dns_ips:
$ref: '#/components/schemas/virtual_dns_ips'
virtual-dns_components-schemas-name:
type: string
description: DNS Firewall Cluster Name.
example: My Awesome DNS Firewall cluster
maxLength: 160
virtual-network:
type: object
required:
- id
- name
- is_default_network
- comment
- created_at
properties:
comment:
$ref: '#/components/schemas/schemas-comment'
created_at:
description: Timestamp of when the virtual network was created.
deleted_at:
description: Timestamp of when the virtual network was deleted. If `null`,
the virtual network has not been deleted.
id:
$ref: '#/components/schemas/vnet_id'
is_default_network:
$ref: '#/components/schemas/is_default_network'
name:
$ref: '#/components/schemas/vnet_name'
virtual_dns_ips:
type: array
example:
- 203.0.113.1
- 203.0.113.254
- 2001:DB8:AB::CF
- 2001:DB8:CD::CF
items:
anyOf:
- type: string
format: ipv4
description: Origin DNS Server IPv4 Address.
example: 203.0.113.1
- type: string
format: ipv6
description: Origin DNS Server IPv6 Address.
example: 2001:DB8:ab::CF
virtual_dns_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/virtual-dns'
virtual_dns_single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/virtual-dns'
virtual_network_id:
description: UUID of the Tunnel Virtual Network this route belongs to. If no
virtual networks are configured, the route is assigned to the default virtual
network of the account.
vnc_props:
allOf:
- $ref: '#/components/schemas/self_hosted_props'
- properties:
type:
type: string
description: The application type.
example: vnc
vnet_id:
type: string
description: UUID of the virtual network.
example: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
readOnly: true
maxLength: 36
vnet_name:
type: string
description: A user-friendly name for the virtual network.
example: us-east-1-vpc
vnet_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/virtual-network'
vnet_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
waf:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- waf
example: waf
value:
$ref: '#/components/schemas/waf_value'
title: Web Application Firewall
description: The WAF examines HTTP requests to your website. It inspects both
GET and POST requests and applies rules to help filter out illegitimate traffic
from legitimate website visitors. The Cloudflare WAF inspects website addresses
or URLs to detect anything out of the ordinary. If the Cloudflare WAF determines
suspicious user behavior, then the WAF will 'challenge' the web visitor with
a page that asks them to submit a CAPTCHA successfully to continue their
action. If the challenge is failed, the action will be stopped. What this
means is that Cloudflare's WAF will block any traffic identified as illegitimate
before it reaches your origin web server. (https://support.cloudflare.com/hc/en-us/articles/200172016).
waf_action:
description: The WAF rule action to apply.
enum:
- challenge
- block
- simulate
- disable
- default
waf_rewrite_action:
description: The WAF rule action to apply.
enum:
- challenge
- block
- simulate
- disable
- default
waf_value:
type: string
description: Value of the zone setting.
enum:
- "on"
- "off"
default: "off"
wait_time:
type: integer
description: Set the time (in seconds) to wait for a response to a probe.
default: 1
minimum: 1
maximum: 5
waiting_room_id:
example: 699d98642c564d2e855e9661899b7252
waiting_room_id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/waiting_room_id'
waitingroom:
type: object
properties:
cookie_attributes:
$ref: '#/components/schemas/cookie_attributes'
created_on:
$ref: '#/components/schemas/timestamp'
custom_page_html:
$ref: '#/components/schemas/custom_page_html'
default_template_language:
$ref: '#/components/schemas/default_template_language'
description:
$ref: '#/components/schemas/waitingroom_components-schemas-description'
disable_session_renewal:
$ref: '#/components/schemas/disable_session_renewal'
host:
$ref: '#/components/schemas/components-schemas-host'
id:
$ref: '#/components/schemas/waiting_room_id'
json_response_enabled:
$ref: '#/components/schemas/json_response_enabled'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/waitingroom_components-schemas-name'
new_users_per_minute:
$ref: '#/components/schemas/new_users_per_minute'
next_event_prequeue_start_time:
$ref: '#/components/schemas/next_event_prequeue_start_time'
next_event_start_time:
$ref: '#/components/schemas/next_event_start_time'
path:
$ref: '#/components/schemas/schemas-path'
queue_all:
$ref: '#/components/schemas/queue_all'
queueing_method:
$ref: '#/components/schemas/queueing_method'
session_duration:
$ref: '#/components/schemas/schemas-session_duration'
suspended:
$ref: '#/components/schemas/schemas-suspended'
total_active_users:
$ref: '#/components/schemas/total_active_users'
waitingroom_components-schemas-description:
type: string
description: A note that you can use to add more details about the waiting room.
default: ""
example: Production - DO NOT MODIFY
waitingroom_components-schemas-name:
type: string
description: A unique name to identify the waiting room. Only alphanumeric characters,
hyphens and underscores are allowed.
example: production_webinar
waitingroom_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/waitingroom'
waitingroom_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/waitingroom'
waitingroom_components-schemas-status:
type: string
enum:
- event_prequeueing
- not_queueing
- queueing
example: queueing
warp_props:
allOf:
- $ref: '#/components/schemas/feature_app_props'
- properties:
domain:
example: authdomain.cloudflareaccess.com/warp
readOnly: true
name:
default: Warp Login App
example: Warp Login App
readOnly: true
type:
type: string
description: The application type.
example: warp
wasm_module_binding:
type: object
required:
- name
- type
properties:
name:
$ref: '#/components/schemas/binding_name'
type:
type: string
description: The class of resource that the binding provides.
enum:
- wasm_module
example: wasm_module
watermark_at_upload:
type: object
properties:
uid:
type: string
description: The unique identifier for the watermark profile.
example: ea95132c15732412d22c1476fa83f27a
maxLength: 32
watermark_basic_upload:
type: object
required:
- file
properties:
file:
type: string
description: The image file to upload.
example: '@/Users/rchen/Downloads/watermark.png'
name:
$ref: '#/components/schemas/watermarks_components-schemas-name'
opacity:
$ref: '#/components/schemas/opacity'
padding:
$ref: '#/components/schemas/padding'
position:
$ref: '#/components/schemas/position'
scale:
$ref: '#/components/schemas/scale'
watermark_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/watermarks'
watermark_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
watermarkAtUpload:
type: object
properties:
uid:
type: string
description: The unique identifier for the watermark profile.
example: ea95132c15732412d22c1476fa83f27a
maxLength: 32
watermarks:
type: object
properties:
created:
$ref: '#/components/schemas/components-schemas-created'
downloadedFrom:
$ref: '#/components/schemas/downloadedFrom'
height:
$ref: '#/components/schemas/height'
name:
$ref: '#/components/schemas/watermarks_components-schemas-name'
opacity:
$ref: '#/components/schemas/opacity'
padding:
$ref: '#/components/schemas/padding'
position:
$ref: '#/components/schemas/position'
scale:
$ref: '#/components/schemas/scale'
size:
$ref: '#/components/schemas/schemas-size'
uid:
$ref: '#/components/schemas/watermarks_components-schemas-identifier'
width:
$ref: '#/components/schemas/width'
watermarks_components-schemas-identifier:
type: string
description: The unique identifier for a watermark profile.
example: ea95132c15732412d22c1476fa83f27a
readOnly: true
maxLength: 32
watermarks_components-schemas-name:
type: string
description: A short description of the watermark profile.
default: ""
example: Marketing Videos
readOnly: true
web3-hostname:
type: object
properties:
created_on:
$ref: '#/components/schemas/timestamp'
description:
$ref: '#/components/schemas/web3-hostname_components-schemas-description'
dnslink:
$ref: '#/components/schemas/dnslink'
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
modified_on:
$ref: '#/components/schemas/timestamp'
name:
$ref: '#/components/schemas/web3-hostname_components-schemas-name'
status:
$ref: '#/components/schemas/web3-hostname_components-schemas-status'
target:
$ref: '#/components/schemas/components-schemas-target'
web3-hostname_components-schemas-description:
type: string
description: An optional description of the hostname.
example: This is my IPFS gateway.
maxLength: 500
web3-hostname_components-schemas-name:
type: string
description: The hostname that will point to the target gateway via CNAME.
example: gateway.example.com
readOnly: true
maxLength: 255
web3-hostname_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/web3-hostname'
web3-hostname_components-schemas-status:
type: string
description: Status of the hostname's activation.
enum:
- active
- pending
- deleting
- error
example: active
readOnly: true
webhook_components-schemas-account_identifier:
type: string
description: Account identifier tag.
example: 023e105f4ecef8ad9ca31a8372d0c353
readOnly: true
maxLength: 32
webhook_request:
required:
- notificationUrl
properties:
notificationUrl:
$ref: '#/components/schemas/notificationUrl'
webhook_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
webhooks:
type: object
properties:
created_at:
$ref: '#/components/schemas/webhooks_components-schemas-created_at'
id:
$ref: '#/components/schemas/uuid'
last_failure:
$ref: '#/components/schemas/last_failure'
last_success:
$ref: '#/components/schemas/last_success'
name:
$ref: '#/components/schemas/webhooks_components-schemas-name'
secret:
$ref: '#/components/schemas/schemas-secret'
type:
$ref: '#/components/schemas/webhooks_components-schemas-type'
url:
$ref: '#/components/schemas/webhooks_components-schemas-url'
webhooks_components-schemas-created_at:
type: string
format: date-time
description: Timestamp of when the webhook destination was created.
example: "2020-10-26T18:25:04.532316Z"
readOnly: true
webhooks_components-schemas-id_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/uuid'
webhooks_components-schemas-name:
type: string
description: The name of the webhook destination. This will be included in the
request body when you receive a webhook notification.
example: Slack Webhook
webhooks_components-schemas-response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/webhooks'
webhooks_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/webhooks'
webhooks_components-schemas-type:
type: string
description: Type of webhook endpoint.
enum:
- slack
- generic
- gchat
example: slack
webhooks_components-schemas-url:
type: string
description: The POST endpoint to call when dispatching a notification.
example: https://hooks.slack.com/services/Ds3fdBFbV/456464Gdd
webp:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- webp
example: webp
value:
$ref: '#/components/schemas/webp_value'
title: Polish WebP Conversion
description: When the client requesting the image supports the WebP image codec,
and WebP offers a performance advantage over the original image format, Cloudflare
will serve a WebP version of the original image.
webp_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
websockets:
allOf:
- $ref: '#/components/schemas/schemas-base'
- properties:
id:
description: ID of the zone setting.
enum:
- websockets
example: websockets
value:
$ref: '#/components/schemas/websockets_value'
title: WebSockets
description: WebSockets are open connections sustained between the client and
the origin server. Inside a WebSockets connection, the client and the origin
can pass data back and forth without having to reestablish sessions. This
makes exchanging data within a WebSockets connection fast. WebSockets are
often used for real-time applications such as live chat and gaming. For more
information refer to [Can I use Cloudflare with Websockets](https://support.cloudflare.com/hc/en-us/articles/200169466-Can-I-use-Cloudflare-with-WebSockets-).
websockets_value:
type: string
description: Value of the zone setting.
enum:
- "off"
- "on"
default: "off"
weight:
type: number
description: The weight of this origin relative to other origins in the pool.
Based on the configured weight the total traffic is distributed among origins
within the pool.
default: 1
example: 0.6
minimum: 0
maximum: 1
multipleOf: 0.01
whois:
properties:
created_date:
type: string
format: date
example: "2009-02-17"
domain:
$ref: '#/components/schemas/schemas-domain_name'
nameservers:
type: array
example:
- ns3.cloudflare.com
- ns4.cloudflare.com
- ns5.cloudflare.com
- ns6.cloudflare.com
- ns7.cloudflare.com
items:
type: string
registrant:
type: string
example: DATA REDACTED
registrant_country:
type: string
example: United States
registrant_email:
type: string
example: https://domaincontact.cloudflareregistrar.com/cloudflare.com
registrant_org:
type: string
example: DATA REDACTED
registrar:
type: string
example: Cloudflare, Inc.
updated_date:
type: string
format: date
example: "2017-05-24"
whois_components-schemas-single_response:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/whois'
width:
type: integer
description: The width of the image in pixels.
readOnly: true
workspace_one_config_request:
type: object
required:
- api_url
- auth_url
- client_id
- client_secret
properties:
api_url:
type: string
description: The Workspace One API URL provided in the Workspace One Admin
Dashboard.
example: https://as123.awmdm.com/API
auth_url:
type: string
description: The Workspace One Authorization URL depending on your region.
example: https://na.uemauth.vmwservices.com/connect/token
client_id:
type: string
description: The Workspace One client ID provided in the Workspace One Admin
Dashboard.
example: example client id
client_secret:
type: string
description: The Workspace One client secret provided in the Workspace One
Admin Dashboard.
example: example client secret
workspace_one_config_response:
type: object
description: The Workspace One Config Response.
required:
- api_url
- auth_url
- client_id
properties:
api_url:
type: string
description: The Workspace One API URL provided in the Workspace One Admin
Dashboard.
example: https://as123.awmdm.com/API
auth_url:
type: string
description: The Workspace One Authorization URL depending on your region.
example: https://na.uemauth.vmwservices.com/connect/token
client_id:
type: string
description: The Workspace One client ID provided in the Workspace One Admin
Dashboard.
example: example client id
zipcode:
type: string
description: The zipcode or postal code where the user lives.
example: "12345"
nullable: true
maxLength: 20
zone:
type: object
description: A simple zone object. May have null properties if not a zone subscription.
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
name:
$ref: '#/components/schemas/properties-name'
zone-authenticated-origin-pull:
allOf:
- $ref: '#/components/schemas/certificateObject'
type: object
properties:
certificate:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-certificate'
enabled:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-enabled'
id:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-identifier'
private_key:
$ref: '#/components/schemas/private_key'
zone-authenticated-origin-pull_components-schemas-certificate:
type: string
description: The zone's leaf certificate.
example: |
-----BEGIN CERTIFICATE-----
MIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
BAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX
aWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF
MQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50
ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1
CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB
KwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5
0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI
dZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2
izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4
9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI
GKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV
BAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF
MAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2
2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP
Mlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG
SvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq
2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw
YbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=
-----END CERTIFICATE-----
zone-authenticated-origin-pull_components-schemas-enabled:
type: boolean
description: Indicates whether zone-level authenticated origin pulls is enabled.
example: true
zone-authenticated-origin-pull_components-schemas-expires_on:
type: string
format: date-time
description: When the certificate from the authority expires.
example: "2100-01-01T05:20:00Z"
readOnly: true
zone-authenticated-origin-pull_components-schemas-identifier:
type: string
description: Certificate identifier tag.
example: 2458ce5a-0c35-4c7f-82c7-8e9487d3ff60
readOnly: true
maxLength: 36
zone-authenticated-origin-pull_components-schemas-status:
description: Status of the certificate activation.
enum:
- initializing
- pending_deployment
- pending_deletion
- active
- deleted
- deployment_timed_out
- deletion_timed_out
example: active
zone_cache_settings_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
zone_components-schemas-zone:
allOf:
- $ref: '#/components/schemas/components-schemas-zone'
type: object
zone_identifier:
description: Identifier of the zone.
example: 593c9c94de529bbbfaac7c53ced0447d
zone_metadata:
type: object
properties:
enabled:
type: boolean
description: Whether zone uses account-level custom nameservers.
example: true
zone_name:
type: string
description: Name of the zone.
example: example.com
zone_settings_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
anyOf:
- type: array
items: {}
- type: object
items:
$ref: '#/components/schemas/setting'
zone_settings_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
zone_subscription_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
zonelockdown:
required:
- id
- created_on
- modified_on
- paused
- description
- urls
- configurations
properties:
configurations:
$ref: '#/components/schemas/configurations'
created_on:
$ref: '#/components/schemas/schemas-created_on'
description:
$ref: '#/components/schemas/lockdowns_components-schemas-description'
id:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
modified_on:
$ref: '#/components/schemas/lockdowns_components-schemas-modified_on'
paused:
$ref: '#/components/schemas/components-schemas-paused'
urls:
$ref: '#/components/schemas/schemas-urls'
zonelockdown_response_collection:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- result
properties:
result:
type: array
items:
$ref: '#/components/schemas/zonelockdown'
zonelockdown_response_single:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
required:
- result
properties:
result:
$ref: '#/components/schemas/zonelockdown'
zones_connected:
type: number
description: The number of zones using this Railgun.
example: 2
readOnly: true
securitySchemes:
api_email:
type: apiKey
name: X-Auth-Email
in: header
api_key:
type: apiKey
name: X-Auth-Key
in: header
api_token:
type: http
scheme: bearer
user_service_key:
type: apiKey
name: X-Auth-User-Service-Key
in: header
info:
title: Cloudflare API
description: |-
Interact with Cloudflare's products and services via the Cloudflare API.
For more information on how to create and troubleshoot API tokens, refer to
our [API fundamentals](https://developers.cloudflare.com/fundamentals/api/).
Totally new to Cloudflare? [Start here](https://developers.cloudflare.com/fundamentals/get-started/).
license:
name: BSD-3-Clause
url: https://opensource.org/licenses/BSD-3-Clause
version: 4.0.0
paths:
/accounts:
get:
tags:
- Accounts
summary: List Accounts
description: List all accounts you have ownership or verified access to.
operationId: accounts-list-accounts
responses:
4xx:
description: List Accounts response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Accounts response
content:
application/json:
schema:
$ref: '#/components/schemas/response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/gateway/categories:
get:
tags:
- Zero Trust Gateway Categories
summary: List Categories
description: List all Categories.
operationId: zero-trust-gateway-categories-list-categories
parameters:
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Categories response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/categories_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Categories response
content:
application/json:
schema:
$ref: '#/components/schemas/categories_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets:
get:
tags:
- Account Rulesets
summary: List account rulesets
description: Fetches all rulesets at the account level.
operationId: account-rulesets-list-account-rulesets
parameters:
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List account rulesets response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List account rulesets response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Rulesets
summary: Create an account ruleset
description: Creates a ruleset at the account level.
operationId: account-rulesets-create-an-account-ruleset
parameters:
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_ruleset'
responses:
4xx:
description: Create an account ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an account ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}:
delete:
tags:
- Account Rulesets
summary: Delete an account ruleset
description: Deletes all versions of an existing account ruleset.
operationId: account-rulesets-delete-an-account-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an account ruleset response failure
content:
application/json: {}
"200":
description: Delete an account ruleset response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Rulesets
summary: Get an account ruleset
description: Fetches the latest version of an account ruleset.
operationId: account-rulesets-get-an-account-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an account ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an account ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Rulesets
summary: Update an account ruleset
description: Updates an account ruleset, creating a new version.
operationId: account-rulesets-update-an-account-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update an account ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an account ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}/rules:
post:
tags:
- Account Rulesets
summary: Create an account ruleset rule
description: Adds a new rule to an account ruleset. The rule will be added to
the end of the existing list of rules in the ruleset.
operationId: account-rulesets-create-an-account-ruleset-rule
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_update_rule'
responses:
4xx:
description: Create an account ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an account ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}/rules/{rule_id}:
delete:
tags:
- Account Rulesets
summary: Delete an account ruleset rule
description: Deletes an existing rule from an account ruleset.
operationId: account-rulesets-delete-an-account-ruleset-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-id'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an account ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an account ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Account Rulesets
summary: Update an account ruleset rule
description: Updates an existing rule in an account ruleset.
operationId: account-rulesets-update-an-account-ruleset-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-id'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_update_rule'
responses:
4xx:
description: Update an account ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an account ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}/versions:
get:
tags:
- Account Rulesets
summary: List an account ruleset's versions
description: Fetches the versions of an account ruleset.
operationId: account-rulesets-list-an-account-ruleset'-s-versions
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List an account ruleset's versions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List an account ruleset's versions response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}/versions/{ruleset_version}:
delete:
tags:
- Account Rulesets
summary: Delete an account ruleset version
description: Deletes an existing version of an account ruleset.
operationId: account-rulesets-delete-an-account-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an account ruleset version response failure
content:
application/json: {}
"200":
description: Delete an account ruleset version response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Rulesets
summary: Get an account ruleset version
description: Fetches a specific version of an account ruleset.
operationId: account-rulesets-get-an-account-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an account ruleset version response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an account ruleset version response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/{ruleset_id}/versions/{ruleset_version}/by_tag/{rule_tag}:
get:
tags:
- Account Rulesets
summary: List an account ruleset version's rules by tag
description: Fetches the rules of a managed account ruleset version for a given
tag.
operationId: account-rulesets-list-an-account-ruleset-version'-s-rules-by-tag
parameters:
- name: rule_tag
in: path
required: true
schema:
$ref: '#/components/schemas/category'
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List an account ruleset version's rules by tag response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List an account ruleset version's rules by tag response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/phases/{ruleset_phase}/entrypoint:
get:
tags:
- Account Rulesets
summary: Get an account entry point ruleset
description: Fetches the latest version of the account entry point ruleset for
a given phase.
operationId: account-rulesets-get-an-account-entry-point-ruleset
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an account entry point ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an account entry point ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Rulesets
summary: Update an account entry point ruleset
description: Updates an account entry point ruleset, creating a new version.
operationId: account-rulesets-update-an-account-entry-point-ruleset
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update an account entry point ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an account entry point ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/phases/{ruleset_phase}/entrypoint/versions:
get:
tags:
- Account Rulesets
summary: List an account entry point ruleset's versions
description: Fetches the versions of an account entry point ruleset.
operationId: account-rulesets-list-an-account-entry-point-ruleset'-s-versions
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List an account entry point ruleset's versions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List an account entry point ruleset's versions response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_id}/rulesets/phases/{ruleset_phase}/entrypoint/versions/{ruleset_version}:
get:
tags:
- Account Rulesets
summary: Get an account entry point ruleset version
description: Fetches a specific version of an account entry point ruleset.
operationId: account-rulesets-get-an-account-entry-point-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: account_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an account entry point ruleset version response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an account entry point ruleset version response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/address_maps:
get:
tags:
- IP Address Management Address Maps
summary: List Address Maps
description: List all address maps owned by the account.
operationId: ip-address-management-address-maps-list-address-maps
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Address Maps response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/address-maps_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Address Maps response
content:
application/json:
schema:
$ref: '#/components/schemas/address-maps_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Address Management Address Maps
summary: Create Address Map
description: Create a new address map under the account.
operationId: ip-address-management-address-maps-create-address-map
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
description:
$ref: '#/components/schemas/address-maps_components-schemas-description'
responses:
4xx:
description: Create Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/full_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/full_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/address_maps/{address_map_identifier}:
delete:
tags:
- IP Address Management Address Maps
summary: Delete Address Map
description: Delete a particular address map owned by the account.
operationId: ip-address-management-address-maps-delete-address-map
parameters:
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- IP Address Management Address Maps
summary: Address Map Details
description: Show a particular address map owned by the account.
operationId: ip-address-management-address-maps-address-map-details
parameters:
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Address Map Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/full_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Address Map Details response
content:
application/json:
schema:
$ref: '#/components/schemas/full_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Address Management Address Maps
summary: Update Address Map
description: Modify the description or default SNI for an address map owned
by the account.
operationId: ip-address-management-address-maps-update-address-map
parameters:
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
default_sni:
$ref: '#/components/schemas/default_sni'
description:
$ref: '#/components/schemas/address-maps_components-schemas-description'
responses:
4xx:
description: Update Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/address-maps_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/address-maps_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/address_maps/{address_map_identifier}/ips/{ip_address}:
delete:
tags:
- IP Address Management Address Maps
summary: Remove an IP from an Address Map
description: Remove an IP from a particular address map.
operationId: ip-address-management-address-maps-remove-an-ip-from-an-address-map
parameters:
- name: ip_address
in: path
required: true
schema:
$ref: '#/components/schemas/ip_address'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove an IP from an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove an IP from an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- IP Address Management Address Maps
summary: Add an IP to an Address Map
description: Add an IP from a prefix owned by the account to a particular address
map.
operationId: ip-address-management-address-maps-add-an-ip-to-an-address-map
parameters:
- name: ip_address
in: path
required: true
schema:
$ref: '#/components/schemas/ip_address'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Add an IP to an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an IP to an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/address_maps/{address_map_identifier}/zones/{zone_identifier}:
delete:
tags:
- IP Address Management Address Maps
summary: Remove a zone membership from an Address Map
description: Remove a zone as a member of a particular address map.
operationId: ip-address-management-address-maps-remove-a-zone-membership-from-an-address-map
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove a zone membership from an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove a zone membership from an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- IP Address Management Address Maps
summary: Add a zone membership to an Address Map
description: Add a zone as a member of a particular address map.
operationId: ip-address-management-address-maps-add-a-zone-membership-to-an-address-map
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Add a zone membership to an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add a zone membership to an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/loa_documents:
post:
tags:
- IP Address Management Prefixes
summary: Upload LOA Document
description: Submit LOA document (pdf format) under the account.
operationId: ip-address-management-prefixes-upload-loa-document
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- loa_document
properties:
loa_document:
type: string
description: LOA document to upload.
example: '@document.pdf'
responses:
4xx:
description: Upload LOA Document response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/loa_upload_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload LOA Document response
content:
application/json:
schema:
$ref: '#/components/schemas/loa_upload_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/loa_documents/{loa_document_identifier}/download:
get:
tags:
- IP Address Management Prefixes
summary: Download LOA Document
description: Download specified LOA document under the account.
operationId: ip-address-management-prefixes-download-loa-document
parameters:
- name: loa_document_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/loa_document_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Download LOA Document response failure
content:
application/json:
schema:
allOf:
- {}
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Download LOA Document response
content:
application/json:
schema: {}
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/prefixes:
get:
tags:
- IP Address Management Prefixes
summary: List Prefixes
description: List all prefixes owned by the account.
operationId: ip-address-management-prefixes-list-prefixes
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Prefixes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-prefixes_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Prefixes response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Address Management Prefixes
summary: Add Prefix
description: Add a prefix under the account.
operationId: ip-address-management-prefixes-add-prefix
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- cidr
- loa_document_id
properties:
asn:
$ref: '#/components/schemas/asn'
cidr:
$ref: '#/components/schemas/cidr'
loa_document_id:
$ref: '#/components/schemas/loa_document_identifier'
responses:
4xx:
description: Add Prefix response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add Prefix response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/prefixes/{prefix_identifier}:
delete:
tags:
- IP Address Management Prefixes
summary: Delete Prefix
description: Delete an unapproved prefix owned by the account.
operationId: ip-address-management-prefixes-delete-prefix
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Prefix response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Prefix response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- IP Address Management Prefixes
summary: Prefix Details
description: List a particular prefix owned by the account.
operationId: ip-address-management-prefixes-prefix-details
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Prefix Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Prefix Details response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Address Management Prefixes
summary: Update Prefix Description
description: Modify the description for a prefix owned by the account.
operationId: ip-address-management-prefixes-update-prefix-description
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- description
properties:
description:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-description'
responses:
4xx:
description: Update Prefix Description response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Prefix Description response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-prefixes_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/prefixes/{prefix_identifier}/bgp/status:
get:
tags:
- IP Address Management Dynamic Advertisement
summary: Get Advertisement Status
description: List the current advertisement state for a prefix.
operationId: ip-address-management-dynamic-advertisement-get-advertisement-status
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Advertisement Status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/advertised_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Advertisement Status response
content:
application/json:
schema:
$ref: '#/components/schemas/advertised_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Address Management Dynamic Advertisement
summary: Update Prefix Dynamic Advertisement Status
description: Advertise or withdraw BGP route for a prefix.
operationId: ip-address-management-dynamic-advertisement-update-prefix-dynamic-advertisement-status
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- advertised
properties:
advertised:
$ref: '#/components/schemas/schemas-advertised'
responses:
4xx:
description: Update Prefix Dynamic Advertisement Status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/advertised_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Prefix Dynamic Advertisement Status response
content:
application/json:
schema:
$ref: '#/components/schemas/advertised_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/prefixes/{prefix_identifier}/delegations:
get:
tags:
- IP Address Management Prefix Delegation
summary: List Prefix Delegations
description: List all delegations for a given account IP prefix.
operationId: ip-address-management-prefix-delegation-list-prefix-delegations
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Prefix Delegations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-delegations_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Prefix Delegations response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-delegations_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Address Management Prefix Delegation
summary: Create Prefix Delegation
description: Create a new account delegation for a given IP prefix.
operationId: ip-address-management-prefix-delegation-create-prefix-delegation
parameters:
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- cidr
- delegated_account_id
properties:
cidr:
$ref: '#/components/schemas/cidr'
delegated_account_id:
$ref: '#/components/schemas/delegated_account_identifier'
responses:
4xx:
description: Create Prefix Delegation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-delegations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Prefix Delegation response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-delegations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/addressing/prefixes/{prefix_identifier}/delegations/{delegation_identifier}:
delete:
tags:
- IP Address Management Prefix Delegation
summary: Delete Prefix Delegation
description: Delete an account delegation for a given IP prefix.
operationId: ip-address-management-prefix-delegation-delete-prefix-delegation
parameters:
- name: delegation_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/delegation_identifier'
- name: prefix_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Prefix Delegation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ipam-delegations_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Prefix Delegation response
content:
application/json:
schema:
$ref: '#/components/schemas/ipam-delegations_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/audit_logs:
get:
tags:
- Audit Logs
summary: Get account audit logs
description: Gets a list of audit logs for an account. The list can be filtered
by who made the change, which zone was the change made on, and the timeframe
of the change.
operationId: audit-logs-get-account-audit-logs
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get account audit logs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/audit_logs_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get account audit logs response
content:
application/json:
schema:
$ref: '#/components/schemas/audit_logs_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/billing/profile:
get:
tags:
- Account Billing Profile
summary: Billing Profile Details
description: Gets the current billing profile for the account.
operationId: account-billing-profile-billing-profile-details
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: Billing Profile Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/billing_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Billing Profile Details response
content:
application/json:
schema:
$ref: '#/components/schemas/billing_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/brand-protection/submit:
post:
tags:
- Phishing URL Scanner
summary: Submit suspicious URL for scanning
operationId: phishing-url-scanner-submit-suspicious-url-for-scanning
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/url_param'
type: object
responses:
4xx:
description: Submit suspicious URL for scanning response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/phishing-url-submit_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Submit suspicious URL for scanning response
content:
application/json:
schema:
$ref: '#/components/schemas/phishing-url-submit_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/brand-protection/url-info:
get:
tags:
- Phishing URL Information
summary: Get results for a URL scan
operationId: phishing-url-information-get-results-for-a-url-scan
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get results for a URL scan response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/phishing-url-info_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get results for a URL scan response
content:
application/json:
schema:
$ref: '#/components/schemas/phishing-url-info_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/cfd_tunnel:
get:
tags:
- Cloudflare Tunnel
summary: List Cloudflare Tunnels
description: Lists and filters Cloudflare Tunnels in an account.
operationId: cloudflare-tunnel-list-cloudflare-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: List Cloudflare Tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Cloudflare Tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Cloudflare Tunnel
summary: Create a Cloudflare Tunnel
description: Creates a new Cloudflare Tunnel in an account.
operationId: cloudflare-tunnel-create-a-cloudflare-tunnel
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- tunnel_secret
properties:
config_src:
$ref: '#/components/schemas/config_src'
name:
$ref: '#/components/schemas/tunnel_name'
tunnel_secret:
$ref: '#/components/schemas/tunnel_secret'
responses:
4xx:
description: Create a Cloudflare Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Cloudflare Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/cfd_tunnel/{tunnel_id}:
delete:
tags:
- Cloudflare Tunnel
summary: Delete a Cloudflare Tunnel
description: Deletes a Cloudflare Tunnel from an account.
operationId: cloudflare-tunnel-delete-a-cloudflare-tunnel
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
4xx:
description: Delete a Cloudflare Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Cloudflare Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Cloudflare Tunnel
summary: Get a Cloudflare Tunnel
description: Fetches a single Cloudflare Tunnel.
operationId: cloudflare-tunnel-get-a-cloudflare-tunnel
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: Get a Cloudflare Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Cloudflare Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Cloudflare Tunnel
summary: Update a Cloudflare Tunnel
description: Updates an existing Cloudflare Tunnel.
operationId: cloudflare-tunnel-update-a-cloudflare-tunnel
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
$ref: '#/components/schemas/tunnel_name'
tunnel_secret:
$ref: '#/components/schemas/tunnel_secret'
responses:
4xx:
description: Update a Cloudflare Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Cloudflare Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/cfd_tunnel/{tunnel_id}/configurations:
get:
tags:
- Cloudflare Tunnel configuration
summary: Get configuration
description: Gets the configuration for a remotely-managed tunnel
operationId: cloudflare-tunnel-configuration-get-configuration
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/config_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/config_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Cloudflare Tunnel configuration
summary: Put configuration
description: Adds or updates the configuration for a remotely-managed tunnel.
operationId: cloudflare-tunnel-configuration-put-configuration
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
config:
$ref: '#/components/schemas/components-schemas-config'
responses:
4xx:
description: Put configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/config_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Put configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/config_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/cfd_tunnel/{tunnel_id}/connections:
delete:
tags:
- Cloudflare Tunnel
summary: Clean up Cloudflare Tunnel connections
description: Removes connections that are in a disconnected or pending reconnect
state. We recommend running this command after shutting down a tunnel.
operationId: cloudflare-tunnel-clean-up-cloudflare-tunnel-connections
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
4xx:
description: Clean up Cloudflare Tunnel connections response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/cloudflare-tunnel_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Clean up Cloudflare Tunnel connections response
content:
application/json:
schema:
$ref: '#/components/schemas/cloudflare-tunnel_components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Cloudflare Tunnel
summary: List Cloudflare Tunnel connections
description: Fetches connection details for a Cloudflare Tunnel.
operationId: cloudflare-tunnel-list-cloudflare-tunnel-connections
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: List Cloudflare Tunnel connections response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_connections_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Cloudflare Tunnel connections response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_connections_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/cfd_tunnel/{tunnel_id}/token:
get:
tags:
- Cloudflare Tunnel
summary: Get a Cloudflare Tunnel token
description: Gets the token used to associate cloudflared with a specific tunnel.
operationId: cloudflare-tunnel-get-a-cloudflare-tunnel-token
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: Get a Cloudflare Tunnel token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_response_token'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Cloudflare Tunnel token response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_response_token'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/custom_pages:
get:
tags:
- Custom pages for an account
summary: List custom pages
description: Fetches all the custom pages at the account level.
operationId: custom-pages-for-an-account-list-custom-pages
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List custom pages response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List custom pages response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/custom_pages/{identifier}:
get:
tags:
- Custom pages for an account
summary: Get a custom page
description: Fetches the details of a custom page.
operationId: custom-pages-for-an-account-get-a-custom-page
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-pages_components-schemas-identifier-2'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a custom page response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a custom page response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Custom pages for an account
summary: Update a custom page
description: Updates the configuration of an existing custom page.
operationId: custom-pages-for-an-account-update-a-custom-page
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-pages_components-schemas-identifier-2'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- url
- state
properties:
state:
$ref: '#/components/schemas/components-schemas-state'
url:
$ref: '#/components/schemas/url'
responses:
4xx:
description: Update a custom page response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a custom page response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/diagnostics/traceroute:
post:
tags:
- Diagnostics
summary: Traceroute
description: Run traceroutes from Cloudflare colos.
operationId: diagnostics-traceroute
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- targets
properties:
colos:
$ref: '#/components/schemas/colos'
options:
$ref: '#/components/schemas/schemas-options'
targets:
$ref: '#/components/schemas/schemas-targets'
responses:
4xx:
description: Traceroute response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/traceroute_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Traceroute response
content:
application/json:
schema:
$ref: '#/components/schemas/traceroute_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/patterns/validate:
post:
tags:
- DLP Pattern Validation
summary: Validate pattern
description: Validates whether this pattern is a valid regular expression. Rejects
it if the regular expression is too complex or can match an unbounded-length
string. Your regex will be rejected if it uses the Kleene Star -- be sure
to bound the maximum number of characters that can be matched.
operationId: dlp-pattern-validation-validate-pattern
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/validate_pattern'
responses:
4xx:
description: Validate pattern response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-validate_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Validate pattern response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-validate_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/profiles:
get:
tags:
- DLP Profiles
summary: List all profiles
description: Lists all DLP profiles in an account.
operationId: dlp-profiles-list-all-profiles
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List all profiles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/profiles_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List all profiles response
content:
application/json:
schema:
$ref: '#/components/schemas/profiles_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/profiles/{profile_id}:
get:
tags:
- DLP Profiles
summary: Get DLP Profile
description: Fetches a DLP profile by ID. Supports both predefined and custom
profiles
operationId: dlp-profiles-get-dlp-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get DLP Profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/either_profile_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get DLP Profile response
content:
application/json:
schema:
$ref: '#/components/schemas/either_profile_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/profiles/custom:
post:
tags:
- DLP Profiles
summary: Create custom profiles
description: Creates a set of DLP custom profiles.
operationId: dlp-profiles-create-custom-profiles
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_custom_profiles'
responses:
4xx:
description: Create custom profiles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/create_custom_profile_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create custom profiles response
content:
application/json:
schema:
$ref: '#/components/schemas/create_custom_profile_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/profiles/custom/{profile_id}:
delete:
tags:
- DLP Profiles
summary: Delete custom profile
description: Deletes a DLP custom profile.
operationId: dlp-profiles-delete-custom-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete custom profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete custom profile response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- DLP Profiles
summary: Get custom profile
description: Fetches a custom DLP profile.
operationId: dlp-profiles-get-custom-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get custom profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_profile_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get custom profile response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_profile_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- DLP Profiles
summary: Update custom profile
description: Updates a DLP custom profile.
operationId: dlp-profiles-update-custom-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_custom_profile'
responses:
4xx:
description: Update custom profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_profile'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update custom profile response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_profile'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dlp/profiles/predefined/{profile_id}:
get:
tags:
- DLP Profiles
summary: Get predefined profile
description: Fetches a predefined DLP profile.
operationId: dlp-profiles-get-predefined-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get predefined profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/predefined_profile_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get predefined profile response
content:
application/json:
schema:
$ref: '#/components/schemas/predefined_profile_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- DLP Profiles
summary: Update predefined profile
description: Updates a DLP predefined profile. Only supports enabling/disabling
entries.
operationId: dlp-profiles-update-predefined-profile
parameters:
- name: profile_id
in: path
required: true
schema:
$ref: '#/components/schemas/profile_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_predefined_profile'
responses:
4xx:
description: Update predefined profile response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/predefined_profile'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update predefined profile response
content:
application/json:
schema:
$ref: '#/components/schemas/predefined_profile'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dns_firewall:
get:
tags:
- DNS Firewall
summary: List DNS Firewall Clusters
description: List configured DNS Firewall clusters for an account.
operationId: dns-firewall-list-dns-firewall-clusters
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List DNS Firewall Clusters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_firewall_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List DNS Firewall Clusters response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_firewall_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- DNS Firewall
summary: Create DNS Firewall Cluster
description: Create a configured DNS Firewall Cluster.
operationId: dns-firewall-create-dns-firewall-cluster
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- origin_ips
properties:
deprecate_any_requests:
$ref: '#/components/schemas/deprecate_any_requests'
ecs_fallback:
$ref: '#/components/schemas/ecs_fallback'
maximum_cache_ttl:
$ref: '#/components/schemas/maximum_cache_ttl'
minimum_cache_ttl:
$ref: '#/components/schemas/minimum_cache_ttl'
name:
$ref: '#/components/schemas/dns-firewall_components-schemas-name'
negative_cache_ttl:
$ref: '#/components/schemas/negative_cache_ttl'
origin_ips:
$ref: '#/components/schemas/origin_ips'
ratelimit:
$ref: '#/components/schemas/ratelimit'
responses:
4xx:
description: Create DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_firewall_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create DNS Firewall Cluster response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_firewall_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dns_firewall/{identifier}:
delete:
tags:
- DNS Firewall
summary: Delete DNS Firewall Cluster
description: Delete a configured DNS Firewall Cluster.
operationId: dns-firewall-delete-dns-firewall-cluster
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete DNS Firewall Cluster response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- DNS Firewall
summary: DNS Firewall Cluster Details
description: Show a single configured DNS Firewall cluster for an account.
operationId: dns-firewall-dns-firewall-cluster-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: DNS Firewall Cluster Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_firewall_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: DNS Firewall Cluster Details response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_firewall_single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- DNS Firewall
summary: Update DNS Firewall Cluster
description: Modify a DNS Firewall Cluster configuration.
operationId: dns-firewall-update-dns-firewall-cluster
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-dns-firewall'
responses:
4xx:
description: Update DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_firewall_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update DNS Firewall Cluster response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_firewall_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dns_firewall/{identifier}/dns_analytics/report:
get:
tags:
- DNS Firewall Analytics
summary: Table
description: Retrieves a list of summarised aggregate metrics over a given time
period.
operationId: dns-firewall-analytics-table
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Table response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Table response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/dns_firewall/{identifier}/dns_analytics/report/bytime:
get:
tags:
- DNS Firewall Analytics
summary: By Time
description: Retrieves a list of aggregate metrics grouped by time interval.
operationId: dns-firewall-analytics-by-time
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: By Time response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: By Time response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/email/routing/addresses:
get:
tags:
- Email Routing destination addresses
summary: List destination addresses
description: Lists existing destination addresses.
operationId: email-routing-destination-addresses-list-destination-addresses
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List destination addresses response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/destination_addresses_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List destination addresses response
content:
application/json:
schema:
$ref: '#/components/schemas/destination_addresses_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Email Routing destination addresses
summary: Create a destination address
description: Create a destination address to forward your emails to. Destination
addresses need to be verified before they can be used.
operationId: email-routing-destination-addresses-create-a-destination-address
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_destination_address_properties'
responses:
4xx:
description: Create a destination address response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/destination_address_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a destination address response
content:
application/json:
schema:
$ref: '#/components/schemas/destination_address_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/email/routing/addresses/{destination_address_identifier}:
delete:
tags:
- Email Routing destination addresses
summary: Delete destination address
description: Deletes a specific destination address.
operationId: email-routing-destination-addresses-delete-destination-address
parameters:
- name: destination_address_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/destination_address_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete destination address response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/destination_address_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete destination address response
content:
application/json:
schema:
$ref: '#/components/schemas/destination_address_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Email Routing destination addresses
summary: Get a destination address
description: Gets information for a specific destination email already created.
operationId: email-routing-destination-addresses-get-a-destination-address
parameters:
- name: destination_address_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/destination_address_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a destination address response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/destination_address_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a destination address response
content:
application/json:
schema:
$ref: '#/components/schemas/destination_address_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/firewall/access_rules/rules:
get:
tags:
- IP Access rules for an account
summary: List IP Access rules
description: Fetches IP Access rules of an account. These rules apply to all
the zones in the account. You can filter the results using several optional
parameters.
operationId: ip-access-rules-for-an-account-list-ip-access-rules
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: List IP Access rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IP Access rules response
content:
application/json:
schema:
$ref: '#/components/schemas/response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Access rules for an account
summary: Create an IP Access rule
description: |-
Creates a new IP Access rule for an account. The rule will apply to all zones in the account.
Note: To create an IP Access rule that applies to a single zone, refer to the [IP Access rules for a zone](#ip-access-rules-for-a-zone) endpoints.
operationId: ip-access-rules-for-an-account-create-an-ip-access-rule
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- mode
- configuration
properties:
configuration:
$ref: '#/components/schemas/schemas-configuration'
mode:
$ref: '#/components/schemas/schemas-mode'
notes:
$ref: '#/components/schemas/notes'
responses:
4xx:
description: Create an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/firewall/access_rules/rules/{identifier}:
delete:
tags:
- IP Access rules for an account
summary: Delete an IP Access rule
description: |-
Deletes an existing IP Access rule defined at the account level.
Note: This operation will affect all zones in the account.
operationId: ip-access-rules-for-an-account-delete-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- IP Access rules for an account
summary: Get an IP Access rule
description: Fetches the details of an IP Access rule defined at the account
level.
operationId: ip-access-rules-for-an-account-get-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: Get an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Access rules for an account
summary: Update an IP Access rule
description: |-
Updates an IP Access rule defined at the account level.
Note: This operation will affect all zones in the account.
operationId: ip-access-rules-for-an-account-update-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rule'
responses:
4xx:
description: Update an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1:
get:
tags:
- Cloudflare Images
summary: List images
description: List up to 100 images with one request. Use the optional parameters
below to get a specific range of images.
operationId: cloudflare-images-list-images
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
responses:
4xx:
description: List images response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/image_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List images response
content:
application/json:
schema:
$ref: '#/components/schemas/image_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Cloudflare Images
summary: Upload an image via URL
description: Upload an image via URL with up to 10 Megabytes using a single
HTTP POST (multipart/form-data) request.
operationId: cloudflare-images-upload-an-image-via-url
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/image_basic_upload_via_url'
responses:
4xx:
description: Upload an image via URL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/image_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload an image via URL response
content:
application/json:
schema:
$ref: '#/components/schemas/image_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/{identifier}:
delete:
tags:
- Cloudflare Images
summary: Delete image
description: Delete an image on Cloudflare Images. On success, all copies of
the image are deleted and purged from cache.
operationId: cloudflare-images-delete-image
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete image response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete image response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Cloudflare Images
summary: Image details
description: Fetch details for a single image.
operationId: cloudflare-images-image-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
responses:
4xx:
description: Image details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/image_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Image details response
content:
application/json:
schema:
$ref: '#/components/schemas/image_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Cloudflare Images
summary: Update image
description: Update image access control. On access control change, all copies
of the image are purged from cache.
operationId: cloudflare-images-update-image
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/image_patch_request'
responses:
4xx:
description: Update image response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/image_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update image response
content:
application/json:
schema:
$ref: '#/components/schemas/image_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/{identifier}/blob:
get:
tags:
- Cloudflare Images
summary: Base image
description: Fetch base image. For most images this will be the originally uploaded
file. For larger images it can be a near-lossless version of the original.
operationId: cloudflare-images-base-image
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
responses:
4xx:
description: Base image response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/image_response_blob'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Base image response
content:
application/json:
schema:
$ref: '#/components/schemas/image_response_blob'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/direct_upload:
post:
tags:
- Cloudflare Images
summary: Create authenticated direct upload URL
description: Direct uploads allow users to upload images without API keys. A
common use case are web apps, client-side applications, or mobile devices
where users upload content directly to Cloudflare Images.
operationId: cloudflare-images-create-authenticated-direct-upload-url
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-direct_upload_request'
responses:
4xx:
description: Create authenticated direct upload URL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-direct_upload_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create authenticated direct upload URL response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-direct_upload_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/keys:
get:
tags:
- Cloudflare Images Keys
summary: List Signing Keys
description: Lists your signing keys. These can be found on your Cloudflare
Images dashboard.
operationId: cloudflare-images-keys-list-signing-keys
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Signing Keys response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-key_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Signing Keys response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-key_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/stats:
get:
tags:
- Cloudflare Images
summary: Images usage statistics
description: Fetch usage statistics details for Cloudflare Images.
operationId: cloudflare-images-images-usage-statistics
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
responses:
4xx:
description: Images usage statistics response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/images_stats'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Images usage statistics response
content:
application/json:
schema:
$ref: '#/components/schemas/images_stats'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/variants:
get:
tags:
- Cloudflare Images Variants
summary: List variants
description: Lists existing variants.
operationId: cloudflare-images-variants-list-variants
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List variants response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/variant_list_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List variants response
content:
application/json:
schema:
$ref: '#/components/schemas/variant_list_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Cloudflare Images Variants
summary: Create a variant
description: Specify variants that allow you to resize images for different
use cases.
operationId: cloudflare-images-variants-create-a-variant
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/variant_generation_request'
responses:
4xx:
description: Create a variant response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/variant_simple_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a variant response
content:
application/json:
schema:
$ref: '#/components/schemas/variant_simple_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v1/variants/{identifier}:
delete:
tags:
- Cloudflare Images Variants
summary: Delete a variant
description: Deleting a variant purges the cache for all images associated with
the variant.
operationId: cloudflare-images-variants-delete-a-variant
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/variants_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a variant response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a variant response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Cloudflare Images Variants
summary: Variant details
description: Fetch details for a single variant.
operationId: cloudflare-images-variants-variant-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/variants_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Variant details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/variant_simple_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Variant details response
content:
application/json:
schema:
$ref: '#/components/schemas/variant_simple_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Cloudflare Images Variants
summary: Update a variant
description: Updating a variant purges the cache for all images associated with
the variant.
operationId: cloudflare-images-variants-update-a-variant
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/variants_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/variant_patch_request'
responses:
4xx:
description: Update a variant response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/variant_simple_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a variant response
content:
application/json:
schema:
$ref: '#/components/schemas/variant_simple_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/images/v2/direct_upload:
post:
tags:
- Cloudflare Images
summary: Create authenticated direct upload URL V2
description: 'Direct uploads allow users to upload images without API keys.
A common use case are web apps, client-side applications, or mobile devices
where users upload content directly to Cloudflare Images. This method creates
a draft record for a future image. It returns an upload URL and an image identifier.
To verify if the image itself has been uploaded, send an image details request
(accounts/:account_identifier/images/v1/:identifier), and check that the `draft:
true` property is not present.'
operationId: cloudflare-images-create-authenticated-direct-upload-url-v-2
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/images_components-schemas-account_identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/direct_upload_request_v2'
responses:
4xx:
description: Create authenticated direct upload URL V2 response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/direct_upload_response_v2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create authenticated direct upload URL V2 response
content:
application/json:
schema:
$ref: '#/components/schemas/direct_upload_response_v2'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/asn/{asn}:
get:
tags:
- ASN Intelligence
summary: Get ASN Overview
operationId: asn-intelligence-get-asn-overview
parameters:
- name: asn
in: path
required: true
schema:
$ref: '#/components/schemas/asn_components-schemas-asn'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get ASN Overview response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asn_components-schemas-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get ASN Overview response
content:
application/json:
schema:
$ref: '#/components/schemas/asn_components-schemas-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/asn/{asn}/subnets:
get:
tags:
- ASN Intelligence
summary: Get ASN Subnets
operationId: asn-intelligence-get-asn-subnets
parameters:
- name: asn
in: path
required: true
schema:
$ref: '#/components/schemas/asn_components-schemas-asn'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get ASN Subnets response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
asn:
$ref: '#/components/schemas/components-schemas-asn'
count:
$ref: '#/components/schemas/schemas-count'
ip_count_total:
type: integer
page:
$ref: '#/components/schemas/page'
per_page:
$ref: '#/components/schemas/per_page'
subnets:
type: array
example:
- 192.0.2.0/24
- 2001:DB8::/32
items:
type: string
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get ASN Subnets response
content:
application/json:
schema:
type: object
properties:
asn:
$ref: '#/components/schemas/components-schemas-asn'
count:
$ref: '#/components/schemas/schemas-count'
ip_count_total:
type: integer
page:
$ref: '#/components/schemas/page'
per_page:
$ref: '#/components/schemas/per_page'
subnets:
type: array
example:
- 192.0.2.0/24
- 2001:DB8::/32
items:
type: string
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/dns:
get:
tags:
- Passive DNS by IP
summary: Get Passive DNS by IP
operationId: passive-dns-by-ip-get-passive-dns-by-ip
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Passive DNS by IP response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/passive-dns-by-ip_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Passive DNS by IP response
content:
application/json:
schema:
$ref: '#/components/schemas/passive-dns-by-ip_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/domain:
get:
tags:
- Domain Intelligence
summary: Get Domain Details
operationId: domain-intelligence-get-domain-details
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Domain Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Domain Details response
content:
application/json:
schema:
$ref: '#/components/schemas/domain_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/domain-history:
get:
tags:
- Domain History
summary: Get Domain History
operationId: domain-history-get-domain-history
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Domain History response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Domain History response
content:
application/json:
schema:
$ref: '#/components/schemas/response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/domain/bulk:
get:
tags:
- Domain Intelligence
summary: Get Multiple Domain Details
operationId: domain-intelligence-get-multiple-domain-details
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Multiple Domain Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Multiple Domain Details response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-collection_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/ip:
get:
tags:
- IP Intelligence
summary: Get IP Overview
operationId: ip-intelligence-get-ip-overview
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get IP Overview response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get IP Overview response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/ip-list:
get:
tags:
- IP List
summary: Get IP Lists
operationId: ip-list-get-ip-lists
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get IP Lists response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get IP Lists response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/miscategorization:
post:
tags:
- Miscategorization
summary: Create Miscategorization
operationId: miscategorization-create-miscategorization
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/miscategorization'
responses:
4xx:
description: Create Miscategorization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Miscategorization response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/intel/whois:
get:
tags:
- WHOIS Record
summary: Get WHOIS Record
operationId: whois-record-get-whois-record
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get WHOIS Record response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/whois_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get WHOIS Record response
content:
application/json:
schema:
$ref: '#/components/schemas/whois_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/monitors:
get:
tags:
- Account Load Balancer Monitors
summary: List Monitors
description: List configured monitors for an account.
operationId: account-load-balancer-monitors-list-monitors
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Monitors response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-response_collection-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Monitors response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-response_collection-2'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Load Balancer Monitors
summary: Create Monitor
description: Create a configured monitor.
operationId: account-load-balancer-monitors-create-monitor
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
consecutive_down:
$ref: '#/components/schemas/consecutive_down'
consecutive_up:
$ref: '#/components/schemas/consecutive_up'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Create Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/monitors/{identifier}:
delete:
tags:
- Account Load Balancer Monitors
summary: Delete Monitor
description: Delete a configured monitor.
operationId: account-load-balancer-monitors-delete-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Load Balancer Monitors
summary: Monitor Details
description: List a single configured monitor for an account.
operationId: account-load-balancer-monitors-monitor-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Monitor Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Monitor Details response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Account Load Balancer Monitors
summary: Patch Monitor
description: Apply changes to an existing monitor, overwriting the supplied
properties.
operationId: account-load-balancer-monitors-patch-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
consecutive_down:
$ref: '#/components/schemas/consecutive_down'
consecutive_up:
$ref: '#/components/schemas/consecutive_up'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Patch Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Load Balancer Monitors
summary: Update Monitor
description: Modify a configured monitor.
operationId: account-load-balancer-monitors-update-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
consecutive_down:
$ref: '#/components/schemas/consecutive_down'
consecutive_up:
$ref: '#/components/schemas/consecutive_up'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Update Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/monitors/{identifier}/preview:
post:
tags:
- Account Load Balancer Monitors
summary: Preview Monitor
description: Preview pools using the specified monitor with provided monitor
details. The returned preview_id can be used in the preview endpoint to retrieve
the results.
operationId: account-load-balancer-monitors-preview-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Preview Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/monitors/{identifier}/references:
get:
tags:
- Account Load Balancer Monitors
summary: List Monitor References
description: Get the list of resources that reference the provided monitor.
operationId: account-load-balancer-monitors-list-monitor-references
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Monitor References response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/references_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Monitor References response
content:
application/json:
schema:
$ref: '#/components/schemas/references_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/pools:
get:
tags:
- Account Load Balancer Pools
summary: List Pools
description: List configured pools.
operationId: account-load-balancer-pools-list-pools
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Pools response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Pools response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Account Load Balancer Pools
summary: Patch Pools
description: Apply changes to a number of existing pools, overwriting the supplied
properties. Pools are ordered by ascending `name`. Returns the list of affected
pools. Supports the standard pagination query parameters, either `limit`/`offset`
or `per_page`/`page`.
operationId: account-load-balancer-pools-patch-pools
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
notification_email:
$ref: '#/components/schemas/patch_pools_notification_email'
responses:
4xx:
description: Patch Pools response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Pools response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Load Balancer Pools
summary: Create Pool
description: Create a new pool.
operationId: account-load-balancer-pools-create-pool
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- origins
- name
properties:
description:
$ref: '#/components/schemas/pool_components-schemas-description'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Create Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/pools/{identifier}:
delete:
tags:
- Account Load Balancer Pools
summary: Delete Pool
description: Delete a configured pool.
operationId: account-load-balancer-pools-delete-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Load Balancer Pools
summary: Pool Details
description: Fetch a single configured pool.
operationId: account-load-balancer-pools-pool-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Pool Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Pool Details response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Account Load Balancer Pools
summary: Patch Pool
description: Apply changes to an existing pool, overwriting the supplied properties.
operationId: account-load-balancer-pools-patch-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
disabled_at:
$ref: '#/components/schemas/schemas-disabled_at'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Patch Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Load Balancer Pools
summary: Update Pool
description: Modify a configured pool.
operationId: account-load-balancer-pools-update-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- origins
- name
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
disabled_at:
$ref: '#/components/schemas/schemas-disabled_at'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Update Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/pools/{identifier}/health:
get:
tags:
- Account Load Balancer Pools
summary: Pool Health Details
description: Fetch the latest pool health status for a single pool.
operationId: account-load-balancer-pools-pool-health-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Pool Health Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/health_details'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Pool Health Details response
content:
application/json:
schema:
$ref: '#/components/schemas/health_details'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/pools/{identifier}/preview:
post:
tags:
- Account Load Balancer Pools
summary: Preview Pool
description: Preview pool health using provided monitor details. The returned
preview_id can be used in the preview endpoint to retrieve the results.
operationId: account-load-balancer-pools-preview-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/schemas-expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/monitor_components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Preview Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/pools/{identifier}/references:
get:
tags:
- Account Load Balancer Pools
summary: List Pool References
description: Get the list of resources that reference the provided pool.
operationId: account-load-balancer-pools-list-pool-references
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Pool References response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-references_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Pool References response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-references_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/preview/{preview_id}:
get:
tags:
- Account Load Balancer Monitors
summary: Preview Result
description: Get the result of a previous preview operation using the provided
preview_id.
operationId: account-load-balancer-monitors-preview-result
parameters:
- name: preview_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-preview_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Preview Result response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_result_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Result response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_result_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/regions:
get:
tags:
- Load Balancer Regions
summary: List Regions
description: List all region mappings.
operationId: load-balancer-regions-list-regions
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Regions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/region_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Regions response
content:
application/json:
schema:
$ref: '#/components/schemas/region_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/regions/{region_code}:
get:
tags:
- Load Balancer Regions
summary: Get Region
description: Get a single region mapping.
operationId: load-balancer-regions-get-region
parameters:
- name: region_code
in: path
required: true
schema:
$ref: '#/components/schemas/region_code'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Region response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/region_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Region response
content:
application/json:
schema:
$ref: '#/components/schemas/region_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/load_balancers/search:
get:
tags:
- Account Load Balancer Search
summary: Search Resources
description: Search for Load Balancing resources.
operationId: account-load-balancer-search-search-resources
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Search Resources response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/search_result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Search Resources response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/search_result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/cf_interconnects:
get:
tags:
- Magic Interconnects
summary: List interconnects
description: Lists interconnects associated with an account.
operationId: magic-interconnects-list-interconnects
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List interconnects response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List interconnects response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Interconnects
summary: Update multiple interconnects
description: Updates multiple interconnects associated with an account. Use
`?validate_only=true` as an optional query parameter to only run validation
without persisting changes.
operationId: magic-interconnects-update-multiple-interconnects
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update multiple interconnects response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-modified_tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update multiple interconnects response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-modified_tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/cf_interconnects/{tunnel_identifier}:
get:
tags:
- Magic Interconnects
summary: List interconnect Details
description: Lists details for a specific interconnect.
operationId: magic-interconnects-list-interconnect-details
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List interconnect Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-tunnel_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List interconnect Details response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-tunnel_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Interconnects
summary: Update interconnect
description: Updates a specific interconnect associated with an account. Use
`?validate_only=true` as an optional query parameter to only run validation
without persisting changes.
operationId: magic-interconnects-update-interconnect
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-tunnel_update_request'
responses:
4xx:
description: Update interconnect response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-tunnel_modified_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update interconnect response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-tunnel_modified_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/gre_tunnels:
get:
tags:
- Magic GRE tunnels
summary: List GRE tunnels
description: Lists GRE tunnels associated with an account.
operationId: magic-gre-tunnels-list-gre-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List GRE tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List GRE tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic GRE tunnels
summary: Create GRE tunnels
description: Creates new GRE tunnels. Use `?validate_only=true` as an optional
query parameter to only run validation without persisting changes.
operationId: magic-gre-tunnels-create-gre-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- customer_gre_endpoint
- cloudflare_gre_endpoint
- interface_address
responses:
4xx:
description: Create GRE tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create GRE tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic GRE tunnels
summary: Update multiple GRE tunnels
description: Updates multiple GRE tunnels. Use `?validate_only=true` as an optional
query parameter to only run validation without persisting changes.
operationId: magic-gre-tunnels-update-multiple-gre-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update multiple GRE tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/modified_tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update multiple GRE tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/modified_tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/gre_tunnels/{tunnel_identifier}:
delete:
tags:
- Magic GRE tunnels
summary: Delete GRE Tunnel
description: Disables and removes a specific static GRE tunnel. Use `?validate_only=true`
as an optional query parameter to only run validation without persisting changes.
operationId: magic-gre-tunnels-delete-gre-tunnel
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete GRE Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete GRE Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Magic GRE tunnels
summary: List GRE Tunnel Details
description: Lists informtion for a specific GRE tunnel.
operationId: magic-gre-tunnels-list-gre-tunnel-details
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List GRE Tunnel Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List GRE Tunnel Details response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic GRE tunnels
summary: Update GRE Tunnel
description: Updates a specific GRE tunnel. Use `?validate_only=true` as an
optional query parameter to only run validation without persisting changes.
operationId: magic-gre-tunnels-update-gre-tunnel
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_update_request'
responses:
4xx:
description: Update GRE Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_modified_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update GRE Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_modified_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/ipsec_tunnels:
get:
tags:
- Magic IPsec tunnels
summary: List IPsec tunnels
description: Lists IPsec tunnels associated with an account.
operationId: magic-i-psec-tunnels-list-i-psec-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List IPsec tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IPsec tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic IPsec tunnels
summary: Create IPsec tunnels
description: Creates new IPsec tunnels associated with an account. Use `?validate_only=true`
as an optional query parameter to only run validation without persisting changes.
operationId: magic-i-psec-tunnels-create-i-psec-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- customer_ipsec_endpoint
- cloudflare_ipsec_endpoint
- interface_address
responses:
4xx:
description: Create IPsec tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create IPsec tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic IPsec tunnels
summary: Update multiple IPsec tunnels
description: Update multiple IPsec tunnels associated with an account. Use `?validate_only=true`
as an optional query parameter to only run validation without persisting changes.
operationId: magic-i-psec-tunnels-update-multiple-i-psec-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update multiple IPsec tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-modified_tunnels_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update multiple IPsec tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-modified_tunnels_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/ipsec_tunnels/{tunnel_identifier}:
delete:
tags:
- Magic IPsec tunnels
summary: Delete IPsec Tunnel
description: Disables and removes a specific static IPsec Tunnel associated
with an account. Use `?validate_only=true` as an optional query parameter
to only run validation without persisting changes.
operationId: magic-i-psec-tunnels-delete-i-psec-tunnel
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete IPsec Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete IPsec Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Magic IPsec tunnels
summary: List IPsec tunnel details
description: Lists details for a specific IPsec tunnel.
operationId: magic-i-psec-tunnels-list-i-psec-tunnel-details
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List IPsec tunnel details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IPsec tunnel details response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic IPsec tunnels
summary: Update IPsec Tunnel
description: Updates a specific IPsec tunnel associated with an account. Use
`?validate_only=true` as an optional query parameter to only run validation
without persisting changes.
operationId: magic-i-psec-tunnels-update-i-psec-tunnel
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_update_request'
responses:
4xx:
description: Update IPsec Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-tunnel_modified_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update IPsec Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-tunnel_modified_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/ipsec_tunnels/{tunnel_identifier}/psk_generate:
post:
tags:
- Magic IPsec tunnels
summary: Generate Pre Shared Key (PSK) for IPsec tunnels
description: Generates a Pre Shared Key for a specific IPsec tunnel used in
the IKE session. Use `?validate_only=true` as an optional query parameter
to only run validation without persisting changes. After a PSK is generated,
the PSK is immediately persisted to Cloudflare's edge and cannot be retrieved
later. Note the PSK in a safe place.
operationId: magic-i-psec-tunnels-generate-pre-shared-key-(-psk)-for-i-psec-tunnels
parameters:
- name: tunnel_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Generate Pre Shared Key (PSK) for IPsec tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_generation_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Generate Pre Shared Key (PSK) for IPsec tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/psk_generation_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/routes:
get:
tags:
- Magic Static Routes
summary: List Routes
description: List all Magic static routes.
operationId: magic-static-routes-list-routes
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Routes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/routes_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Routes response
content:
application/json:
schema:
$ref: '#/components/schemas/routes_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic Static Routes
summary: Create Routes
description: Creates a new Magic static route. Use `?validate_only=true` as
an optional query parameter to run validation only without persisting changes.
operationId: magic-static-routes-create-routes
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- prefix
- nexthop
- priority
responses:
4xx:
description: Create Routes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/routes_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Routes response
content:
application/json:
schema:
$ref: '#/components/schemas/routes_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Static Routes
summary: Update Many Routes
description: Update multiple Magic static routes. Use `?validate_only=true`
as an optional query parameter to run validation only without persisting changes.
Only fields for a route that need to be changed need be provided.
operationId: magic-static-routes-update-many-routes
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/route_update_many_request'
responses:
4xx:
description: Update Many Routes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/multiple_route_modified_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Many Routes response
content:
application/json:
schema:
$ref: '#/components/schemas/multiple_route_modified_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/magic/routes/{route_identifier}:
delete:
tags:
- Magic Static Routes
summary: Delete Route
description: Disable and remove a specific Magic static route.
operationId: magic-static-routes-delete-route
parameters:
- name: route_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Route response
content:
application/json:
schema:
$ref: '#/components/schemas/route_deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Magic Static Routes
summary: Route Details
description: Get a specific Magic static route.
operationId: magic-static-routes-route-details
parameters:
- name: route_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Route Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Route Details response
content:
application/json:
schema:
$ref: '#/components/schemas/route_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Static Routes
summary: Update Route
description: Update a specific Magic static route. Use `?validate_only=true`
as an optional query parameter to run validation only without persisting changes.
operationId: magic-static-routes-update-route
parameters:
- name: route_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/route_update_request'
responses:
4xx:
description: Update Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_modified_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Route response
content:
application/json:
schema:
$ref: '#/components/schemas/route_modified_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/members:
get:
tags:
- Account Members
summary: List Members
description: List all members of an account.
operationId: account-members-list-members
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: List Members response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Members response
content:
application/json:
schema:
$ref: '#/components/schemas/response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Members
summary: Add Member
description: Add a user to the list of members for this account.
operationId: account-members-add-member
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create'
responses:
4xx:
description: Add Member response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add Member response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/members/{identifier}:
delete:
tags:
- Account Members
summary: Remove Member
description: Remove a member from an account.
operationId: account-members-remove-member
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove Member response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove Member response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Members
summary: Member Details
description: Get information about a specific member of an account.
operationId: account-members-member-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: Member Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Member Details response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Members
summary: Update Member
description: Modify an account member.
operationId: account-members-update-member
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-member'
responses:
4xx:
description: Update Member response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Member response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/mnm/config:
delete:
tags:
- Magic Network Monitoring Configuration
summary: Delete account configuration
description: Delete an existing network monitoring configuration.
operationId: magic-network-monitoring-configuration-delete-account-configuration
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Magic Network Monitoring Configuration
summary: List account configuration
description: Lists default sampling and router IPs for account.
operationId: magic-network-monitoring-configuration-list-account-configuration
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
responses:
4xx:
description: List account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Magic Network Monitoring Configuration
summary: Update account configuration fields
description: Update fields in an existing network monitoring configuration.
operationId: magic-network-monitoring-configuration-update-account-configuration-fields
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update account configuration fields response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update account configuration fields response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic Network Monitoring Configuration
summary: Create account configuration
description: Create a new network monitoring configuration.
operationId: magic-network-monitoring-configuration-create-account-configuration
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Network Monitoring Configuration
summary: Update an entire account configuration
description: Update an existing network monitoring configuration, requires the
entire configuration to be updated at once.
operationId: magic-network-monitoring-configuration-update-an-entire-account-configuration
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update an entire account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an entire account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/mnm/config/full:
get:
tags:
- Magic Network Monitoring Configuration
summary: List rules and account configuration
description: Lists default sampling, router IPs, and rules for account.
operationId: magic-network-monitoring-configuration-list-rules-and-account-configuration
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/config_components-schemas-account_identifier'
responses:
4xx:
description: List rules and account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List rules and account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_config'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/mnm/rules:
get:
tags:
- Magic Network Monitoring Rules
summary: List rules
description: Lists network monitoring rules for account.
operationId: magic-network-monitoring-rules-list-rules
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
responses:
4xx:
description: List rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rules'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List rules response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rules'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic Network Monitoring Rules
summary: Create rules
description: Create network monitoring rules for account.
operationId: magic-network-monitoring-rules-create-rules
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rules'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create rules response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rules'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Magic Network Monitoring Rules
summary: Update rules
description: Update network monitoring rules for account.
operationId: magic-network-monitoring-rules-update-rules
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rules'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update rules response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rules'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/mnm/rules/{rule_identifier}:
delete:
tags:
- Magic Network Monitoring Rules
summary: Delete rule
description: Delete a network monitoring rule for account.
operationId: magic-network-monitoring-rules-delete-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-rule_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rule'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete rule response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rule'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Magic Network Monitoring Rules
summary: Get rule
description: List a single network monitoring rule for account.
operationId: magic-network-monitoring-rules-get-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-rule_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
responses:
4xx:
description: Get rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rule'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get rule response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rule'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Magic Network Monitoring Rules
summary: Update rule
description: Update a network monitoring rule for account.
operationId: magic-network-monitoring-rules-update-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-rule_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rule'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update rule response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rule'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/mnm/rules/{rule_identifier}/advertisement:
patch:
tags:
- Magic Network Monitoring Rules
summary: Update advertisement for rule
description: Update advertisement for rule.
operationId: magic-network-monitoring-rules-update-advertisement-for-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-rule_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update advertisement for rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mnm_rule_automatic_advertisement'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update advertisement for rule response
content:
application/json:
schema:
$ref: '#/components/schemas/mnm_rule_automatic_advertisement'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects:
get:
tags:
- Pages Project
summary: Get projects
description: Fetch a list of all user projects.
operationId: pages-project-get-projects
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get projects response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/projects-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get projects response
content:
application/json:
schema:
$ref: '#/components/schemas/projects-response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Pages Project
summary: Create project
description: Make a new project.
operationId: pages-project-create-project
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/projects'
responses:
4xx:
description: Create project response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/new-project-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create project response
content:
application/json:
schema:
$ref: '#/components/schemas/new-project-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}:
delete:
tags:
- Pages Project
summary: Delete project
description: Destroy a project by name.
operationId: pages-project-delete-project
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete project response failure
content:
application/json:
schema:
allOf:
- example:
errors: []
messages: []
result: null
success: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete project response
content:
application/json:
schema:
example:
errors: []
messages: []
result: null
success: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Pages Project
summary: Get project
description: Fetch a project by name.
operationId: pages-project-get-project
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get project response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/project-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get project response
content:
application/json:
schema:
$ref: '#/components/schemas/project-response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Pages Project
summary: Update project
description: Set new attributes for an existing project. Modify environment
variables. To delete an environment variable, set the key to null.
operationId: pages-project-update-project
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/project-patch'
responses:
4xx:
description: Update project response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/new-project-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update project response
content:
application/json:
schema:
$ref: '#/components/schemas/new-project-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/deployments:
get:
tags:
- Pages Deployment
summary: Get deployments
description: Fetch a list of deployments from a project.
operationId: pages-deployment-get-deployments
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get deployments response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-list-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get deployments response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-list-response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Pages Deployment
summary: Create deployment
description: Start a new deployment from production. The repo/account must have
been authorized through the Pages UI dash before.
operationId: pages-deployment-create-deployment
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create deployment response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-new-deployment'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create deployment response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-new-deployment'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/deployments/{deployment_identifier}:
delete:
tags:
- Pages Deployment
summary: Delete deployment
description: Destroy a deployment.
operationId: pages-deployment-delete-deployment
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete deployment response failure
content:
application/json:
schema:
allOf:
- example:
errors: []
messages: []
result: null
success: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete deployment response
content:
application/json:
schema:
example:
errors: []
messages: []
result: null
success: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Pages Deployment
summary: Get deployment info
description: Fetch a deployment.
operationId: pages-deployment-get-deployment-info
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get deployment info response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-response-details'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get deployment info response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-response-details'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/deployments/{deployment_identifier}/history/logs:
get:
tags:
- Pages Deployment
summary: Get deployment logs
description: Fetch deploy logs.
operationId: pages-deployment-get-deployment-logs
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get deployment logs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-response-logs'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get deployment logs response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-response-logs'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/deployments/{deployment_identifier}/retry:
post:
tags:
- Pages Deployment
summary: Retry deployment
description: Retry a previous deployment.
operationId: pages-deployment-retry-deployment
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Retry deployment response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-new-deployment'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retry deployment response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-new-deployment'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/deployments/{deployment_identifier}/rollback:
post:
tags:
- Pages Deployment
summary: Rollback deployment
description: Rollback the production deployment to a previous deploy. You can
only rollback to succesful builds on production.
operationId: pages-deployment-rollback-deployment
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Rollback deployment response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployment-response-details'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Rollback deployment response
content:
application/json:
schema:
$ref: '#/components/schemas/deployment-response-details'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/domains:
get:
tags:
- Pages Domains
summary: Get domains
description: Fetch a list of all domains.
operationId: pages-domains-get-domains
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get domains response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get domains response
content:
application/json:
schema:
$ref: '#/components/schemas/domain-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Pages Domains
summary: Add domain
description: Add a new domain for the Pages project.
operationId: pages-domains-add-domain
parameters:
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/domains-post'
responses:
4xx:
description: Add domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add domain response
content:
application/json:
schema:
$ref: '#/components/schemas/domain-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pages/projects/{project_name}/domains/{domain_name}:
delete:
tags:
- Pages Domains
summary: Delete domain
description: Delete a domain.
operationId: pages-domains-delete-domain
parameters:
- name: domain_name
in: path
required: true
schema:
$ref: '#/components/schemas/domain_name'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete domain response failure
content:
application/json:
schema:
allOf:
- example:
errors: []
messages: []
result: null
success: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete domain response
content:
application/json:
schema:
example:
errors: []
messages: []
result: null
success: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Pages Domains
summary: Get domain
description: Fetch a single domain.
operationId: pages-domains-get-domain
parameters:
- name: domain_name
in: path
required: true
schema:
$ref: '#/components/schemas/domain_name'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Get domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get domain response
content:
application/json:
schema:
$ref: '#/components/schemas/domain-response-single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Pages Domains
summary: Patch domain
description: Retry the validation status of a single domain.
operationId: pages-domains-patch-domain
parameters:
- name: domain_name
in: path
required: true
schema:
$ref: '#/components/schemas/domain_name'
- name: project_name
in: path
required: true
schema:
$ref: '#/components/schemas/project_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Patch domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch domain response
content:
application/json:
schema:
$ref: '#/components/schemas/domain-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps:
get:
tags:
- Magic PCAP collection
summary: List packet capture requests
description: Lists all packet capture requests for an account.
operationId: magic-pcap-collection-list-packet-capture-requests
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List packet capture requests response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List packet capture requests response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic PCAP collection
summary: Create PCAP request
description: Create new PCAP request for account.
operationId: magic-pcap-collection-create-pcap-request
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_request_pcap'
responses:
4xx:
description: Create PCAP request response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create PCAP request response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps/{identifier}:
get:
tags:
- Magic PCAP collection
summary: Get PCAP request
description: Get information for a PCAP request by id.
operationId: magic-pcap-collection-get-pcap-request
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get PCAP request response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get PCAP request response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps/{identifier}/download:
get:
tags:
- Magic PCAP collection
summary: Download Simple PCAP
description: Download PCAP information into a file. Response is a binary PCAP
file.
operationId: magic-pcap-collection-download-simple-pcap
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Download Simple PCAP response failure
content:
application/json: {}
"200":
description: Download Simple PCAP response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps/ownership:
get:
tags:
- Magic PCAP collection
summary: List PCAPs Bucket Ownership
description: List all buckets configured for use with PCAPs API.
operationId: magic-pcap-collection-list-pca-ps-bucket-ownership
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List PCAPs Bucket Ownership response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_ownership_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List PCAPs Bucket Ownership response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_ownership_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Magic PCAP collection
summary: Add buckets for full packet captures
description: Adds an AWS or GCP bucket to use with full packet captures.
operationId: magic-pcap-collection-add-buckets-for-full-packet-captures
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_ownership_request'
responses:
4xx:
description: Add buckets for full packet captures response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_ownership_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add buckets for full packet captures response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_ownership_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps/ownership/{identifier}:
delete:
tags:
- Magic PCAP collection
summary: Delete buckets for full packet captures
description: Deletes buckets added to the packet captures API.
operationId: magic-pcap-collection-delete-buckets-for-full-packet-captures
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete buckets for full packet captures response failure
content:
application/json: {}
"200":
description: Delete buckets for full packet captures response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/pcaps/ownership/validate:
post:
tags:
- Magic PCAP collection
summary: Validate buckets for full packet captures
description: Validates buckets added to the packet captures API.
operationId: magic-pcap-collection-validate-buckets-for-full-packet-captures
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_ownership_validate_request'
responses:
4xx:
description: Validate buckets for full packet captures response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcaps_ownership_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Validate buckets for full packet captures response
content:
application/json:
schema:
$ref: '#/components/schemas/pcaps_ownership_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/r2/buckets:
get:
tags:
- R2 Bucket
summary: List Buckets
description: Lists all R2 buckets on your account
operationId: r-2-bucket-list-buckets
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Buckets response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/r2-single-bucket-operation-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Buckets response
content:
application/json:
schema:
$ref: '#/components/schemas/r2-single-bucket-operation-response'
security:
- api_token: []
post:
tags:
- R2 Bucket
summary: Create Bucket
description: Creates a new R2 bucket.
operationId: r-2-bucket-create-bucket
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example: '{''name'': ''example-bucket''}'
responses:
4xx:
description: Create Bucket response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/r2-single-bucket-operation-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Bucket response
content:
application/json:
schema:
$ref: '#/components/schemas/r2-single-bucket-operation-response'
security:
- api_token: []
/accounts/{account_identifier}/r2/buckets/{bucket_name}:
delete:
tags:
- R2 Bucket
summary: Delete Bucket
description: Deletes an existing R2 bucket.
operationId: r-2-bucket-delete-bucket
parameters:
- name: bucket_name
in: path
required: true
schema:
$ref: '#/components/schemas/bucket_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Bucket response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/r2-single-bucket-operation-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Bucket response
content:
application/json:
schema:
$ref: '#/components/schemas/r2-single-bucket-operation-response'
security:
- api_token: []
/accounts/{account_identifier}/railguns:
get:
tags:
- Account Railguns
summary: List Railguns
description: List, search, sort and filter your Railguns.
operationId: account-railguns-list-railguns
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Railguns response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Railguns response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Railguns
summary: Create Railgun
operationId: account-railguns-create-railgun
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
$ref: '#/components/schemas/railgun_components-schemas-name'
responses:
4xx:
description: Create Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/railguns/{identifier}:
delete:
tags:
- Account Railguns
summary: Delete a Railgun
description: Disable and delete a Railgun. This will immediately disable the
Railgun for any connected zones.
operationId: account-railguns-delete-a-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single_id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Account Railguns
summary: Railgun details
operationId: account-railguns-railgun-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Railgun details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Railgun details response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Railguns
summary: Update Railgun
description: Update a Railgun.
operationId: account-railguns-update-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-railgun'
responses:
4xx:
description: Update Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/railguns/{railgun_identifier}/connections:
get:
tags:
- Railgun Connections
summary: List Connections
description: List connections associated with the Railgun.
operationId: railgun-connections-list-connections
parameters:
- name: railgun_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Connections response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/connection_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Connections response
content:
application/json:
schema:
$ref: '#/components/schemas/connection_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Railgun Connections
summary: Create connection
description: Associates a zone to the Railgun.
operationId: railgun-connections-create-connection
parameters:
- name: railgun_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/connection_single_request'
responses:
4xx:
description: Create connection response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/connection_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create connection response
content:
application/json:
schema:
$ref: '#/components/schemas/connection_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/railguns/{railgun_identifier}/connections/{identifier}:
delete:
tags:
- Railgun Connections
summary: Delete connection
description: Disable and remove the connection to a zone.
operationId: railgun-connections-delete-connection
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/connection_components-schemas-identifier'
- name: railgun_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete connection response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/connection_single_id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete connection response
content:
application/json:
schema:
$ref: '#/components/schemas/connection_single_id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Railgun Connections
summary: Connection details
description: Get a connection by ID.
operationId: railgun-connections-connection-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/connection_components-schemas-identifier'
- name: railgun_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Connection details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/connection_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Connection details response
content:
application/json:
schema:
$ref: '#/components/schemas/connection_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Railgun Connections
summary: Update connection
description: Enable or disable a connection.
operationId: railgun-connections-update-connection
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/connection_components-schemas-identifier'
- name: railgun_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-connection'
responses:
4xx:
description: Update connection response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/connection_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update connection response
content:
application/json:
schema:
$ref: '#/components/schemas/connection_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/registrar/domains:
post:
tags:
- Registrar Domains
summary: List domains
description: List domains handled by Registrar.
operationId: registrar-domains-list-domains
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
properties:
id:
$ref: '#/components/schemas/domain_names'
responses:
4xx:
description: List domains response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List domains response
content:
application/json:
schema:
$ref: '#/components/schemas/domain_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/registrar/domains/{domain_name}:
get:
tags:
- Registrar Domains
summary: Get domain
description: Show individual domain.
operationId: registrar-domains-get-domain
parameters:
- name: domain_name
in: path
required: true
schema:
$ref: '#/components/schemas/Cloudflare Client API_domain_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get domain response
content:
application/json:
schema:
$ref: '#/components/schemas/domain_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Registrar Domains
summary: Update domain
description: Update individual domain.
operationId: registrar-domains-update-domain
parameters:
- name: domain_name
in: path
required: true
schema:
$ref: '#/components/schemas/Cloudflare Client API_domain_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain_update_properties'
responses:
4xx:
description: Update domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/domain_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update domain response
content:
application/json:
schema:
$ref: '#/components/schemas/domain_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/roles:
get:
tags:
- Account Roles
summary: List Roles
description: Get all available roles for an account.
operationId: account-roles-list-roles
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: List Roles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Roles response
content:
application/json:
schema:
$ref: '#/components/schemas/response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/roles/{identifier}:
get:
tags:
- Account Roles
summary: Role Details
description: Get information about a specific role for an account.
operationId: account-roles-role-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/account_identifier'
responses:
4xx:
description: Role Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Role Details response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/rules/lists:
get:
tags:
- Lists
summary: Get lists
description: Fetches all lists in the account.
operationId: lists-get-lists
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get lists response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get lists response
content:
application/json:
schema:
$ref: '#/components/schemas/lists-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Lists
summary: Create a list
description: Creates a new list of the specified type.
operationId: lists-create-a-list
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- kind
properties:
description:
$ref: '#/components/schemas/lists_components-schemas-description'
kind:
$ref: '#/components/schemas/kind'
name:
$ref: '#/components/schemas/lists_components-schemas-name'
responses:
4xx:
description: Create a list response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a list response
content:
application/json:
schema:
$ref: '#/components/schemas/list-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/rules/lists/{list_id}:
delete:
tags:
- Lists
summary: Delete a list
description: Deletes a specific list and all its items.
operationId: lists-delete-a-list
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a list response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-delete-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a list response
content:
application/json:
schema:
$ref: '#/components/schemas/list-delete-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Lists
summary: Get a list
description: Fetches the details of a list.
operationId: lists-get-a-list
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a list response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a list response
content:
application/json:
schema:
$ref: '#/components/schemas/list-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Lists
summary: Update a list
description: Updates the description of a list.
operationId: lists-update-a-list
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
description:
$ref: '#/components/schemas/lists_components-schemas-description'
responses:
4xx:
description: Update a list response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a list response
content:
application/json:
schema:
$ref: '#/components/schemas/list-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/rules/lists/{list_id}/items:
delete:
tags:
- Lists
summary: Delete list items
description: |-
Removes one or more items from a list.
This operation is asynchronous. To get current the operation status, invoke the [Get bulk operation status](#lists-get-bulk-operation-status) endpoint with the returned `operation_id`.
operationId: lists-delete-list-items
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
items:
type: array
minItems: 1
items:
properties:
id:
$ref: '#/components/schemas/item_id'
responses:
4xx:
description: Delete list items response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists-async-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete list items response
content:
application/json:
schema:
$ref: '#/components/schemas/lists-async-response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Lists
summary: Get list items
description: Fetches all the items in the list.
operationId: lists-get-list-items
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get list items response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/items-list-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get list items response
content:
application/json:
schema:
$ref: '#/components/schemas/items-list-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Lists
summary: Create list items
description: |-
Appends new items to the list.
This operation is asynchronous. To get current the operation status, invoke the [Get bulk operation status](#lists-get-bulk-operation-status) endpoint with the returned `operation_id`.
operationId: lists-create-list-items
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/items-update-request-collection'
responses:
4xx:
description: Create list items response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists-async-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create list items response
content:
application/json:
schema:
$ref: '#/components/schemas/lists-async-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Lists
summary: Update all list items
description: |-
Removes all existing items from the list and adds the provided items to the list.
This operation is asynchronous. To get current the operation status, invoke the [Get bulk operation status](#lists-get-bulk-operation-status) endpoint with the returned `operation_id`.
operationId: lists-update-all-list-items
parameters:
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/items-update-request-collection'
responses:
4xx:
description: Update all list items response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists-async-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update all list items response
content:
application/json:
schema:
$ref: '#/components/schemas/lists-async-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/rules/lists/{list_id}/items/{item_id}:
get:
tags:
- Lists
summary: Get a list item
description: Fetches a list item in the list.
operationId: lists-get-a-list-item
parameters:
- name: item_id
in: path
required: true
schema:
$ref: '#/components/schemas/item_id'
- name: list_id
in: path
required: true
schema:
$ref: '#/components/schemas/list_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a list item response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/item-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a list item response
content:
application/json:
schema:
$ref: '#/components/schemas/item-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/rules/lists/bulk_operations/{operation_id}:
get:
tags:
- Lists
summary: Get bulk operation status
description: |-
Gets the current status of an asynchronous operation on a list.
The `status` property can have one of the following values: `pending`, `running`, `completed`, or `failed`. If the status is `failed`, the `error` property will contain a message describing the error.
operationId: lists-get-bulk-operation-status
parameters:
- name: operation_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-operation_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get bulk operation status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bulk-operation-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get bulk operation status response
content:
application/json:
schema:
$ref: '#/components/schemas/bulk-operation-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/acls:
get:
tags:
- Secondary DNS (ACL)
summary: List ACLs
description: List ACLs.
operationId: secondary-dns-(-acl)-list-ac-ls
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: List ACLs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acl_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List ACLs response
content:
application/json:
schema:
$ref: '#/components/schemas/acl_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Secondary DNS (ACL)
summary: Create ACL
description: Create ACL.
operationId: secondary-dns-(-acl)-create-acl
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- ip_range
responses:
4xx:
description: Create ACL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acl_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create ACL response
content:
application/json:
schema:
$ref: '#/components/schemas/acl_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/acls/{identifier}:
delete:
tags:
- Secondary DNS (ACL)
summary: Delete ACL
description: Delete ACL.
operationId: secondary-dns-(-acl)-delete-acl
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/acl_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete ACL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acl_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete ACL response
content:
application/json:
schema:
$ref: '#/components/schemas/acl_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Secondary DNS (ACL)
summary: ACL Details
description: Get ACL.
operationId: secondary-dns-(-acl)-acl-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/acl_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: ACL Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acl_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: ACL Details response
content:
application/json:
schema:
$ref: '#/components/schemas/acl_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Secondary DNS (ACL)
summary: Update ACL
description: Modify ACL.
operationId: secondary-dns-(-acl)-update-acl
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/acl_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/acl'
responses:
4xx:
description: Update ACL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acl_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update ACL response
content:
application/json:
schema:
$ref: '#/components/schemas/acl_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/peers:
get:
tags:
- Secondary DNS (Peer)
summary: List Peers
description: List Peers.
operationId: secondary-dns-(-peer)-list-peers
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: List Peers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/peer_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Peers response
content:
application/json:
schema:
$ref: '#/components/schemas/peer_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Secondary DNS (Peer)
summary: Create Peer
description: Create Peer.
operationId: secondary-dns-(-peer)-create-peer
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
responses:
4xx:
description: Create Peer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/peer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Peer response
content:
application/json:
schema:
$ref: '#/components/schemas/peer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/peers/{identifier}:
delete:
tags:
- Secondary DNS (Peer)
summary: Delete Peer
description: Delete Peer.
operationId: secondary-dns-(-peer)-delete-peer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/peer_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Peer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/peer_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Peer response
content:
application/json:
schema:
$ref: '#/components/schemas/peer_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Secondary DNS (Peer)
summary: Peer Details
description: Get Peer.
operationId: secondary-dns-(-peer)-peer-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/peer_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: Peer Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/peer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Peer Details response
content:
application/json:
schema:
$ref: '#/components/schemas/peer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Secondary DNS (Peer)
summary: Update Peer
description: Modify Peer.
operationId: secondary-dns-(-peer)-update-peer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/peer_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/peer'
responses:
4xx:
description: Update Peer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/peer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Peer response
content:
application/json:
schema:
$ref: '#/components/schemas/peer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/tsigs:
get:
tags:
- Secondary DNS (TSIG)
summary: List TSIGs
description: List TSIGs.
operationId: secondary-dns-(-tsig)-list-tsi-gs
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: List TSIGs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tsig_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List TSIGs response
content:
application/json:
schema:
$ref: '#/components/schemas/tsig_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Secondary DNS (TSIG)
summary: Create TSIG
description: Create TSIG.
operationId: secondary-dns-(-tsig)-create-tsig
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- algo
responses:
4xx:
description: Create TSIG response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create TSIG response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/secondary_dns/tsigs/{identifier}:
delete:
tags:
- Secondary DNS (TSIG)
summary: Delete TSIG
description: Delete TSIG.
operationId: secondary-dns-(-tsig)-delete-tsig
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/tsig_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete TSIG response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete TSIG response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Secondary DNS (TSIG)
summary: TSIG Details
description: Get TSIG.
operationId: secondary-dns-(-tsig)-tsig-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/tsig_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
responses:
4xx:
description: TSIG Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: TSIG Details response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Secondary DNS (TSIG)
summary: Update TSIG
description: Modify TSIG.
operationId: secondary-dns-(-tsig)-update-tsig
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/tsig_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/tsig'
responses:
4xx:
description: Update TSIG response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update TSIG response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/analytics:
get:
tags:
- Workers KV Request Analytics
summary: Query Request Analytics
description: Retrieves Workers KV request metrics for the given account.
operationId: workers-kv-request-analytics-query-request-analytics
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Query Request Analytics response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/components-schemas-result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Query Request Analytics response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/components-schemas-result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/analytics/stored:
get:
tags:
- Workers KV Stored Data Analytics
summary: Query Stored Data Analytics
description: Retrieves Workers KV stored data metrics for the given account.
operationId: workers-kv-stored-data-analytics-query-stored-data-analytics
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Query Stored Data Analytics response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/stored_components-schemas-result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Query Stored Data Analytics response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/stored_components-schemas-result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces:
get:
tags:
- Workers KV Namespace
summary: List Namespaces
description: Returns the namespaces owned by an account.
operationId: workers-kv-namespace-list-namespaces
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Namespaces response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/namespace'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Namespaces response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/namespace'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Workers KV Namespace
summary: Create a Namespace
description: Creates a namespace under the given title. A 400 is returned if
the account already owns a namespace with this title. A namespace must be
explicitly deleted to be replaced.
operationId: workers-kv-namespace-create-a-namespace
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_rename_namespace_body'
responses:
4xx:
description: Create a Namespace response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/namespace'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Namespace response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/namespace'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}:
delete:
tags:
- Workers KV Namespace
summary: Remove a Namespace
description: Deletes the namespace corresponding to the given ID.
operationId: workers-kv-namespace-remove-a-namespace
parameters:
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove a Namespace response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove a Namespace response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Workers KV Namespace
summary: Rename a Namespace
description: Modifies a namespace's title.
operationId: workers-kv-namespace-rename-a-namespace
parameters:
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_rename_namespace_body'
responses:
4xx:
description: Rename a Namespace response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Rename a Namespace response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}/bulk:
delete:
tags:
- Workers KV Namespace
summary: Delete multiple key-value pairs
description: Remove multiple KV pairs from the Namespace. Body should be an
array of up to 10,000 keys to be removed.
operationId: workers-kv-namespace-delete-multiple-key-value-pairs
parameters:
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/bulk_delete'
responses:
4xx:
description: Delete multiple key-value pairs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete multiple key-value pairs response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Workers KV Namespace
summary: Write multiple key-value pairs
description: Write multiple keys and values at once. Body should be an array
of up to 10,000 key-value pairs to be stored, along with optional expiration
information. Existing values and expirations will be overwritten. If neither
expiration nor expiration_ttl is specified, the key-value pair will never
expire. If both are set, `expiration_ttl` is used and `expiration` is ignored.
The entire request size must be 100 megabytes or less.
operationId: workers-kv-namespace-write-multiple-key-value-pairs
parameters:
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/bulk_write'
responses:
4xx:
description: Write multiple key-value pairs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Write multiple key-value pairs response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}/keys:
get:
tags:
- Workers KV Namespace
summary: List a Namespace's Keys
description: Lists a namespace's keys.
operationId: workers-kv-namespace-list-a-namespace'-s-keys
parameters:
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List a Namespace's Keys response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/key'
result_info:
properties:
count:
type: number
description: Total results returned based on your list
parameters.
example: 1
cursor:
$ref: '#/components/schemas/cursor'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List a Namespace's Keys response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/key'
result_info:
properties:
count:
type: number
description: Total results returned based on your list parameters.
example: 1
cursor:
$ref: '#/components/schemas/cursor'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}/metadata/{key_name}:
get:
tags:
- Workers KV Namespace
summary: Read the metadata for a key
description: Returns the metadata associated with the given key in the given
namespace. Use URL-encoding to use special characters (e.g. :, !, %) in the
key name.
operationId: workers-kv-namespace-read-the-metadata-for-a-key
parameters:
- name: key_name
in: path
required: true
schema:
$ref: '#/components/schemas/key_name'
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Read the metadata for a key response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/list_metadata'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Read the metadata for a key response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/list_metadata'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}/values/{key_name}:
delete:
tags:
- Workers KV Namespace
summary: Delete key-value pair
description: Remove a KV pair from the Namespace. Use URL-encoding to use special
characters (e.g. :, !, %) in the key name.
operationId: workers-kv-namespace-delete-key-value-pair
parameters:
- name: key_name
in: path
required: true
schema:
$ref: '#/components/schemas/key_name'
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete key-value pair response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete key-value pair response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Workers KV Namespace
summary: Read key-value pair
description: Returns the value associated with the given key in the given namespace.
Use URL-encoding to use special characters (e.g. :, !, %) in the key name.
If the KV-pair is set to expire at some point, the expiration time as measured
in seconds since the UNIX epoch will be returned in the "Expiration" response
header.
operationId: workers-kv-namespace-read-key-value-pair
parameters:
- name: key_name
in: path
required: true
schema:
$ref: '#/components/schemas/key_name'
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Read key-value pair response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/kv_components-schemas-value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Read key-value pair response
content:
application/json:
schema:
$ref: '#/components/schemas/kv_components-schemas-value'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Workers KV Namespace
summary: Write key-value pair with metadata
description: Write a value identified by a key. Use URL-encoding to use special
characters (e.g. :, !, %) in the key name. Body should be the value to be
stored along with json metadata to be associated with the key/value pair.
Existing values, expirations and metadata will be overwritten. If neither
`expiration` nor `expiration_ttl` is specified, the key-value pair will never
expire. If both are set, `expiration_ttl` is used and `expiration` is ignored.
operationId: workers-kv-namespace-write-key-value-pair-with-metadata
parameters:
- name: key_name
in: path
required: true
schema:
$ref: '#/components/schemas/key_name'
- name: namespace_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/namespace_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- value
- metadata
properties:
metadata:
$ref: '#/components/schemas/components-schemas-metadata'
value:
$ref: '#/components/schemas/kv_components-schemas-value'
responses:
4xx:
description: Write key-value pair with metadata response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Write key-value pair with metadata response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream:
get:
tags:
- Stream Videos
summary: List videos
description: Lists up to 1000 videos from a single request. For a specific range,
refer to the optional parameters.
operationId: stream-videos-list-videos
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
responses:
4xx:
description: List videos response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/video_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List videos response
content:
application/json:
schema:
$ref: '#/components/schemas/video_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Videos
summary: Initiate video uploads using TUS
description: Initiates a video upload using the TUS protocol. On success, the
server responds with a status code 201 (created) and includes a `location`
header to indicate where the content should be uploaded. Refer to https://tus.io
for protocol details.
operationId: stream-videos-initiate-video-uploads-using-tus
parameters:
- name: Tus-Resumable
in: header
required: true
schema:
$ref: '#/components/schemas/tus_resumable'
- name: Upload-Creator
in: header
required: true
schema:
$ref: '#/components/schemas/creator'
- name: Upload-Length
in: header
required: true
schema:
$ref: '#/components/schemas/upload_length'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Initiate video uploads using TUS response failure
content:
application/json: {}
"200":
description: Initiate video uploads using TUS response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{identifier}:
delete:
tags:
- Stream Videos
summary: Delete video
description: Deletes a video and its copies from Cloudflare Stream.
operationId: stream-videos-delete-video
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/videos_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete video response failure
content:
application/json: {}
"200":
description: Delete video response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Stream Videos
summary: Retrieve video details
description: Fetches details for a single video.
operationId: stream-videos-retrieve-video-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/videos_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
responses:
4xx:
description: Retrieve video details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/video_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve video details response
content:
application/json:
schema:
$ref: '#/components/schemas/video_response_single'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Videos
summary: Associate videos to NFTs
description: Asssociates videos with a token ID and contract address to transfer
admin rights on a video. If a change in ownership of the ERC-721 token happens
on the Ethereum blockchain, the new token owner can claim control of the video.
operationId: stream-videos-associate-videos-to-nf-ts
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/videos_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/nft'
responses:
4xx:
description: Associate videos to NFTs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/video_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Associate videos to NFTs response
content:
application/json:
schema:
$ref: '#/components/schemas/video_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{identifier}/embed:
get:
tags:
- Stream Videos
summary: Retreieve embed Code HTML
description: Fetches an HTML code snippet to embed a video in a web page delivered
through Cloudflare. On success, returns an HTML fragment for use on web pages
to display a video. On failure, returns a JSON response body.
operationId: stream-videos-retreieve-embed-code-html
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/videos_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
responses:
4xx:
description: Retreieve embed Code HTML response failure
content:
application/json:
schema:
allOf:
- example:
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retreieve embed Code HTML response
content:
application/json:
schema:
example:
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{identifier}/token:
post:
tags:
- Stream Videos
summary: Create signed URL tokens for videso
description: Creates a signed URL token for a video. If a body is not provided
in the request, a token is created with default values.
operationId: stream-videos-create-signed-url-tokens-for-videso
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/videos_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/signed_token_request'
responses:
4xx:
description: Create signed URL tokens for videso response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/signed_token_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create signed URL tokens for videso response
content:
application/json:
schema:
$ref: '#/components/schemas/signed_token_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{video_identifier}/captions:
get:
tags:
- Stream Subtitles/Captions
summary: List captions or subtitles
description: Lists the available captions or subtitles for a specific video.
operationId: stream-subtitles/-captions-list-captions-or-subtitles
parameters:
- name: video_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-video_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List captions or subtitles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/language_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List captions or subtitles response
content:
application/json:
schema:
$ref: '#/components/schemas/language_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{video_identifier}/captions/{language}:
delete:
tags:
- Stream Subtitles/Captions
summary: Delete captions or subtitles
description: Removes the captions or subtitles from a video.
operationId: stream-subtitles/-captions-delete-captions-or-subtitles
parameters:
- name: language
in: path
required: true
schema:
$ref: '#/components/schemas/language'
- name: video_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-video_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete captions or subtitles response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: string
example: ""
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete captions or subtitles response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: string
example: ""
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Stream Subtitles/Captions
summary: Upload captions or subtitles
description: Uploads the caption or subtitle file to the endpoint for a specific
BCP47 language. One caption or subtitle file per language is allowed.
operationId: stream-subtitles/-captions-upload-captions-or-subtitles
parameters:
- name: language
in: path
required: true
schema:
$ref: '#/components/schemas/language'
- name: video_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-video_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/caption_basic_upload'
responses:
4xx:
description: Upload captions or subtitles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/language_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload captions or subtitles response
content:
application/json:
schema:
$ref: '#/components/schemas/language_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/{video_identifier}/downloads:
get:
tags:
- Stream MP4 Downloads
summary: List downloads
description: Lists the downloads created for a video.
operationId: stream-m-p-4-downloads-list-downloads
parameters:
- name: video_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/video_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List downloads response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/downloads_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List downloads response
content:
application/json:
schema:
$ref: '#/components/schemas/downloads_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream MP4 Downloads
summary: Create downloads
description: Creates a download for a video when a video is ready to view.
operationId: stream-m-p-4-downloads-create-downloads
parameters:
- name: video_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/video_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create downloads response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/downloads_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create downloads response
content:
application/json:
schema:
$ref: '#/components/schemas/downloads_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/clip:
post:
tags:
- Stream Video Clipping
summary: Clip videos given a start and end time
description: Clips a video based on the specified start and end times provided
in seconds.
operationId: stream-video-clipping-clip-videos-given-a-start-and-end-time
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/videoClipStandard'
responses:
4xx:
description: Clip videos given a start and end time response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/clipResponseSingle'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Clip videos given a start and end time response
content:
application/json:
schema:
$ref: '#/components/schemas/clipResponseSingle'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/copy:
post:
tags:
- Stream Videos
summary: Upload videos from a URL
description: Uploads a video to Stream from a provided URL.
operationId: stream-videos-upload-videos-from-a-url
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/video_copy_request'
responses:
4xx:
description: Upload videos from a URL response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/video_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload videos from a URL response
content:
application/json:
schema:
$ref: '#/components/schemas/video_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/direct_upload:
post:
tags:
- Stream Videos
summary: Upload videos via direct upload URLs
description: Creates a direct upload that allows video uploads without an API
key.
operationId: stream-videos-upload-videos-via-direct-upload-ur-ls
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/direct_upload_request'
responses:
4xx:
description: Upload videos via direct upload URLs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/direct_upload_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload videos via direct upload URLs response
content:
application/json:
schema:
$ref: '#/components/schemas/direct_upload_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/keys:
get:
tags:
- Stream Signing Keys
summary: List signing keys
description: Lists the video ID and creation date and time when a signing key
was created.
operationId: stream-signing-keys-list-signing-keys
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List signing keys response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/key_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List signing keys response
content:
application/json:
schema:
$ref: '#/components/schemas/key_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Signing Keys
summary: Create signing keys
description: Creates an RSA private key in PEM and JWK formats. Key files are
only displayed once after creation. Keys are created, used, and deleted independently
of videos, and every key can sign any video.
operationId: stream-signing-keys-create-signing-keys
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create signing keys response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/key_generation_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create signing keys response
content:
application/json:
schema:
$ref: '#/components/schemas/key_generation_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/keys/{identifier}:
delete:
tags:
- Stream Signing Keys
summary: Delete signing keys
description: Deletes signing keys and revokes all signed URLs generated with
the key.
operationId: stream-signing-keys-delete-signing-keys
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keys_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete signing keys response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete signing keys response
content:
application/json:
schema:
$ref: '#/components/schemas/deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/live_inputs:
get:
tags:
- Stream Live Inputs
summary: List live inputs
description: Lists the live inputs created for an account. To get the credentials
needed to stream to a specific live input, request a single live input.
operationId: stream-live-inputs-list-live-inputs
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List live inputs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/live_input_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List live inputs response
content:
application/json:
schema:
$ref: '#/components/schemas/live_input_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Live Inputs
summary: Create a live input
description: Creates a live input, and returns credentials that you or your
users can use to stream live video to Cloudflare Stream.
operationId: stream-live-inputs-create-a-live-input
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_input_request'
responses:
4xx:
description: Create a live input response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/live_input_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a live input response
content:
application/json:
schema:
$ref: '#/components/schemas/live_input_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/live_inputs/{live_input_identifier}:
delete:
tags:
- Stream Live Inputs
summary: Delete a live input
description: Prevents a live input from being streamed to and makes the live
input inaccessible to any future API calls.
operationId: stream-live-inputs-delete-a-live-input
parameters:
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a live input response failure
content:
application/json: {}
"200":
description: Delete a live input response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Stream Live Inputs
summary: Retrieve a live input
description: Retrieves details of an existing live input.
operationId: stream-live-inputs-retrieve-a-live-input
parameters:
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve a live input response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/live_input_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve a live input response
content:
application/json:
schema:
$ref: '#/components/schemas/live_input_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Stream Live Inputs
summary: Update a live input
description: Updates a specified live input.
operationId: stream-live-inputs-update-a-live-input
parameters:
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_input_request'
responses:
4xx:
description: Update a live input response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/live_input_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a live input response
content:
application/json:
schema:
$ref: '#/components/schemas/live_input_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/live_inputs/{live_input_identifier}/outputs:
get:
tags:
- Stream Live Inputs
summary: List all outputs associated with a specified live input
description: Retrieves all outputs associated with a specified live input.
operationId: stream-live-inputs-list-all-outputs-associated-with-a-specified-live-input
parameters:
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List all outputs associated with a specified live input response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/output_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List all outputs associated with a specified live input response
content:
application/json:
schema:
$ref: '#/components/schemas/output_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Live Inputs
summary: Create a new output, connected to a live input
description: Creates a new output that can be used to simulcast or restream
live video to other RTMP or SRT destinations. Outputs are always linked to
a specific live input — one live input can have many outputs.
operationId: stream-live-inputs-create-a-new-output,-connected-to-a-live-input
parameters:
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_output_request'
responses:
4xx:
description: Create a new output, connected to a live input response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/output_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a new output, connected to a live input response
content:
application/json:
schema:
$ref: '#/components/schemas/output_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/live_inputs/{live_input_identifier}/outputs/{output_identifier}:
delete:
tags:
- Stream Live Inputs
summary: Delete an output
description: Deletes an output and removes it from the associated live input.
operationId: stream-live-inputs-delete-an-output
parameters:
- name: output_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/output_identifier'
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an output response failure
content:
application/json: {}
"200":
description: Delete an output response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Stream Live Inputs
summary: Update an output
description: Updates the state of an output.
operationId: stream-live-inputs-update-an-output
parameters:
- name: output_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/output_identifier'
- name: live_input_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/live_input_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_output_request'
responses:
4xx:
description: Update an output response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/output_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an output response
content:
application/json:
schema:
$ref: '#/components/schemas/output_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/watermarks:
get:
tags:
- Stream Watermark Profile
summary: List watermark profiles
description: Lists all watermark profiles for an account.
operationId: stream-watermark-profile-list-watermark-profiles
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
responses:
4xx:
description: List watermark profiles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/watermark_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List watermark profiles response
content:
application/json:
schema:
$ref: '#/components/schemas/watermark_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Stream Watermark Profile
summary: Create watermark profiles via basic upload
description: Creates watermark profiles using a single `HTTP POST multipart/form-data`
request.
operationId: stream-watermark-profile-create-watermark-profiles-via-basic-upload
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/watermark_basic_upload'
responses:
4xx:
description: Create watermark profiles via basic upload response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/watermark_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create watermark profiles via basic upload response
content:
application/json:
schema:
$ref: '#/components/schemas/watermark_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/watermarks/{identifier}:
delete:
tags:
- Stream Watermark Profile
summary: Delete watermark profiles
description: Deletes a watermark profile.
operationId: stream-watermark-profile-delete-watermark-profiles
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/watermarks_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete watermark profiles response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: string
example: ""
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete watermark profiles response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: string
example: ""
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Stream Watermark Profile
summary: Watermark profile details
description: Retrieves details for a single watermark profile.
operationId: stream-watermark-profile-watermark-profile-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/watermarks_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-account_identifier'
responses:
4xx:
description: Watermark profile details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/watermark_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Watermark profile details response
content:
application/json:
schema:
$ref: '#/components/schemas/watermark_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/stream/webhook:
delete:
tags:
- Stream Webhook
summary: Delete webhooks
description: Deletes a webhook.
operationId: stream-webhook-delete-webhooks
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/webhook_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete webhooks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deleted_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete webhooks response
content:
application/json:
schema:
$ref: '#/components/schemas/deleted_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Stream Webhook
summary: View webhooks
description: Retrieves a list of webhooks.
operationId: stream-webhook-view-webhooks
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/webhook_components-schemas-account_identifier'
responses:
4xx:
description: View webhooks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: View webhooks response
content:
application/json:
schema:
$ref: '#/components/schemas/webhook_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Stream Webhook
summary: Create webhooks
description: Creates a webhook notification.
operationId: stream-webhook-create-webhooks
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/webhook_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/webhook_request'
responses:
4xx:
description: Create webhooks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create webhooks response
content:
application/json:
schema:
$ref: '#/components/schemas/webhook_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/subscriptions:
get:
tags:
- Account Subscriptions
summary: List Subscriptions
description: Lists all of an account's subscriptions.
operationId: account-subscriptions-list-subscriptions
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Subscriptions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_subscription_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Subscriptions response
content:
application/json:
schema:
$ref: '#/components/schemas/account_subscription_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account Subscriptions
summary: Create Subscription
description: Creates an account subscription.
operationId: account-subscriptions-create-subscription
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/subscription-v2'
responses:
4xx:
description: Create Subscription response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Subscription response
content:
application/json:
schema:
$ref: '#/components/schemas/account_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/subscriptions/{subscription_identifier}:
delete:
tags:
- Account Subscriptions
summary: Delete Subscription
description: Deletes an account's subscription.
operationId: account-subscriptions-delete-subscription
parameters:
- name: subscription_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Subscription response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
subscription_id:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Subscription response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
type: object
properties:
subscription_id:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account Subscriptions
summary: Update Subscription
description: Updates an account subscription.
operationId: account-subscriptions-update-subscription
parameters:
- name: subscription_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/subscription-v2'
responses:
4xx:
description: Update Subscription response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Subscription response
content:
application/json:
schema:
$ref: '#/components/schemas/account_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/teamnet/routes:
get:
tags:
- Tunnel route
summary: List tunnel routes
description: Lists and filters private network routes in an account.
operationId: tunnel-route-list-tunnel-routes
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: List tunnel routes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List tunnel routes response
content:
application/json:
schema:
$ref: '#/components/schemas/route_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/teamnet/routes/ip/{ip}:
get:
tags:
- Tunnel route
summary: Get tunnel route by IP
description: Fetches routes that contain the given IP address.
operationId: tunnel-route-get-tunnel-route-by-ip
parameters:
- name: ip
in: path
required: true
schema:
$ref: '#/components/schemas/teamnet_components-schemas-ip'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: Get tunnel route by IP response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get tunnel route by IP response
content:
application/json:
schema:
$ref: '#/components/schemas/route_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/teamnet/routes/network/{ip_network_encoded}:
delete:
tags:
- Tunnel route
summary: Delete a tunnel route
description: Deletes a private network route from an account. The CIDR in `ip_network_encoded`
must be written in URL-encoded format.
operationId: tunnel-route-delete-a-tunnel-route
parameters:
- name: ip_network_encoded
in: path
required: true
schema:
$ref: '#/components/schemas/ip_network_encoded'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
virtual_network_id:
$ref: '#/components/schemas/virtual_network_id'
responses:
4xx:
description: Delete a tunnel route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a tunnel route response
content:
application/json:
schema:
$ref: '#/components/schemas/route_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Tunnel route
summary: Update a tunnel route
description: Updates an existing private network route in an account. The CIDR
in `ip_network_encoded` must be written in URL-encoded format.
operationId: tunnel-route-update-a-tunnel-route
parameters:
- name: ip_network_encoded
in: path
required: true
schema:
$ref: '#/components/schemas/ip_network_encoded'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
comment:
$ref: '#/components/schemas/comment'
network:
description: The new IPv4 or IPv6 range of this route, in CIDR notation.
tunnel_id:
description: UUID of the tunnel this route should belong to.
virtual_network_id:
$ref: '#/components/schemas/virtual_network_id'
responses:
4xx:
description: Update a tunnel route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a tunnel route response
content:
application/json:
schema:
$ref: '#/components/schemas/route_response_single'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Tunnel route
summary: Create a tunnel route
description: Routes a private network through a Cloudflare Tunnel. The CIDR
in `ip_network_encoded` must be written in URL-encoded format.
operationId: tunnel-route-create-a-tunnel-route
parameters:
- name: ip_network_encoded
in: path
required: true
schema:
$ref: '#/components/schemas/ip_network_encoded'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- tunnel_id
properties:
comment:
$ref: '#/components/schemas/comment'
tunnel_id:
$ref: '#/components/schemas/tunnel_id'
virtual_network_id:
$ref: '#/components/schemas/virtual_network_id'
responses:
4xx:
description: Create a tunnel route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a tunnel route response
content:
application/json:
schema:
$ref: '#/components/schemas/route_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/teamnet/virtual_networks:
get:
tags:
- Tunnel Virtual Network
summary: List virtual networks
description: Lists and filters virtual networks in an account.
operationId: tunnel-virtual-network-list-virtual-networks
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: List virtual networks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vnet_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List virtual networks response
content:
application/json:
schema:
$ref: '#/components/schemas/vnet_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Tunnel Virtual Network
summary: Create a virtual network
description: Adds a new virtual network to an account.
operationId: tunnel-virtual-network-create-a-virtual-network
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
comment:
$ref: '#/components/schemas/schemas-comment'
is_default:
$ref: '#/components/schemas/is_default_network'
name:
$ref: '#/components/schemas/vnet_name'
responses:
4xx:
description: Create a virtual network response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vnet_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a virtual network response
content:
application/json:
schema:
$ref: '#/components/schemas/vnet_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/teamnet/virtual_networks/{vnet_id}:
delete:
tags:
- Tunnel Virtual Network
summary: Delete a virtual network
description: Deletes an existing virtual network.
operationId: tunnel-virtual-network-delete-a-virtual-network
parameters:
- name: vnet_id
in: path
required: true
schema:
$ref: '#/components/schemas/vnet_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a virtual network response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vnet_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a virtual network response
content:
application/json:
schema:
$ref: '#/components/schemas/vnet_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Tunnel Virtual Network
summary: Update a virtual network
description: Updates an existing virtual network.
operationId: tunnel-virtual-network-update-a-virtual-network
parameters:
- name: vnet_id
in: path
required: true
schema:
$ref: '#/components/schemas/vnet_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
comment:
$ref: '#/components/schemas/schemas-comment'
is_default_network:
$ref: '#/components/schemas/is_default_network'
name:
$ref: '#/components/schemas/vnet_name'
responses:
4xx:
description: Update a virtual network response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vnet_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a virtual network response
content:
application/json:
schema:
$ref: '#/components/schemas/vnet_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/tunnels:
get:
tags:
- Argo Tunnel
summary: List Argo Tunnels
description: Lists and filters Argo Tunnels in an account.
operationId: argo-tunnel-list-argo-tunnels
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: List Argo Tunnels response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Argo Tunnels response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_response_collection'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Argo Tunnel
summary: Create an Argo Tunnel
description: Creates a new Argo Tunnel in an account.
operationId: argo-tunnel-create-an-argo-tunnel
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- tunnel_secret
properties:
name:
$ref: '#/components/schemas/tunnel_name'
tunnel_secret:
description: Sets the password required to run the tunnel. Must
be at least 32 bytes and encoded as a base64 string.
responses:
4xx:
description: Create an Argo Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an Argo Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/tunnels/{tunnel_id}:
delete:
tags:
- Argo Tunnel
summary: Delete an Argo Tunnel
description: Deletes an Argo Tunnel from an account.
operationId: argo-tunnel-delete-an-argo-tunnel
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
4xx:
description: Delete an Argo Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Argo Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Argo Tunnel
summary: Get an Argo Tunnel
description: Fetches a single Argo Tunnel.
operationId: argo-tunnel-get-an-argo-tunnel
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: Get an Argo Tunnel response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tunnel_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Argo Tunnel response
content:
application/json:
schema:
$ref: '#/components/schemas/tunnel_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/tunnels/{tunnel_id}/connections:
delete:
tags:
- Argo Tunnel
summary: Clean up Argo Tunnel connections
description: Removes connections that are in a disconnected or pending reconnect
state. We recommend running this command after shutting down a tunnel.
operationId: argo-tunnel-clean-up-argo-tunnel-connections
parameters:
- name: tunnel_id
in: path
required: true
schema:
$ref: '#/components/schemas/tunnel_id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/cf_account_id'
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
4xx:
description: Clean up Argo Tunnel connections response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/argo-tunnel_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Clean up Argo Tunnel connections response
content:
application/json:
schema:
$ref: '#/components/schemas/argo-tunnel_components-schemas-empty_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/virtual_dns:
get:
tags:
- DNS Firewall (Legacy)
summary: List DNS Firewall Clusters
description: List configured DNS Firewall clusters for an account.
operationId: dns-firewall-(-legacy)-list-dns-firewall-clusters
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List DNS Firewall Clusters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_dns_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List DNS Firewall Clusters response
content:
application/json:
schema:
$ref: '#/components/schemas/virtual_dns_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- DNS Firewall (Legacy)
summary: Create DNS Firewall Cluster
description: Create a configured DNS Firewall Cluster.
operationId: dns-firewall-(-legacy)-create-dns-firewall-cluster
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- origin_ips
- virtual_dns_ips
properties:
deprecate_any_requests:
$ref: '#/components/schemas/deprecate_any_requests'
ecs_fallback:
$ref: '#/components/schemas/ecs_fallback'
maximum_cache_ttl:
$ref: '#/components/schemas/maximum_cache_ttl'
minimum_cache_ttl:
$ref: '#/components/schemas/minimum_cache_ttl'
name:
$ref: '#/components/schemas/virtual-dns_components-schemas-name'
negative_cache_ttl:
$ref: '#/components/schemas/schemas-negative_cache_ttl'
origin_ips:
$ref: '#/components/schemas/origin_ips'
ratelimit:
$ref: '#/components/schemas/schemas-ratelimit'
responses:
4xx:
description: Create DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_dns_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create DNS Firewall Cluster response
content:
application/json:
schema:
$ref: '#/components/schemas/virtual_dns_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/virtual_dns/{identifier}:
delete:
tags:
- DNS Firewall (Legacy)
summary: Delete DNS Firewall Cluster
description: Delete a configured DNS Firewall Cluster.
operationId: dns-firewall-(-legacy)-delete-dns-firewall-cluster
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete DNS Firewall Cluster response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- DNS Firewall (Legacy)
summary: DNS Firewall Cluster Details
description: Show a single configured DNS Firewall cluster for an account.
operationId: dns-firewall-(-legacy)-dns-firewall-cluster-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: DNS Firewall Cluster Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_dns_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: DNS Firewall Cluster Details response
content:
application/json:
schema:
$ref: '#/components/schemas/virtual_dns_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- DNS Firewall (Legacy)
summary: Update DNS Firewall Cluster
description: Modify a DNS Firewall Cluster configuration.
operationId: dns-firewall-(-legacy)-update-dns-firewall-cluster
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-virtual-dns'
responses:
4xx:
description: Update DNS Firewall Cluster response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_dns_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update DNS Firewall Cluster response
content:
application/json:
schema:
$ref: '#/components/schemas/virtual_dns_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/virtual_dns/{identifier}/dns_analytics/report:
get:
tags:
- DNS Firewall Analytics (Legacy)
summary: Table
description: Retrieves a list of summarised aggregate metrics over a given time
period.
operationId: dns-firewall-analytics-(-legacy)-table
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Table response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Table response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/virtual_dns/{identifier}/dns_analytics/report/bytime:
get:
tags:
- DNS Firewall Analytics (Legacy)
summary: By Time
description: Retrieves a list of aggregate metrics grouped by time interval.
operationId: dns-firewall-analytics-(-legacy)-by-time
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: By Time response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: By Time response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/account-settings:
get:
tags:
- Worker Account Settings
summary: Fetch Worker Account Settings
description: Fetches Worker Account Settings for an account.
operationId: worker-account-settings-fetch-worker-account-settings
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Fetch Worker Account Settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Fetch Worker Account Settings response
content:
application/json:
schema:
$ref: '#/components/schemas/account-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Account Settings
summary: Create Worker Account Settings
description: Creates Worker Account Settings for an account.
operationId: worker-account-settings-create-worker-account-settings
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example: '{''default_usage_model'': ''unbound''}'
responses:
4xx:
description: Create Worker Account Settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Worker Account Settings response
content:
application/json:
schema:
$ref: '#/components/schemas/account-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/deployments/by-script/{script_identifier}:
get:
tags:
- Worker Deployments
summary: List Deployments
operationId: worker-deployments-list-deployments
parameters:
- name: script_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/script_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Deployments response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployments-list-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Deployments response
content:
application/json:
schema:
$ref: '#/components/schemas/deployments-list-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/deployments/by-script/{script_identifier}/detail/{deployment_identifier}:
get:
tags:
- Worker Deployments
summary: Get Deployment Detail
operationId: worker-deployments-get-deployment-detail
parameters:
- name: deployment_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/deployment_identifier'
- name: script_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/script_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Deployment Detail response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deployments-single-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Deployment Detail response
content:
application/json:
schema:
$ref: '#/components/schemas/deployments-single-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/domains:
get:
tags:
- Worker Domain
summary: List Domains
description: Lists all Worker Domains.
operationId: worker-domain-list-domains
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domains_components-schemas-account_identifier'
responses:
4xx:
description: List Domains response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Cloudflare Client API_domain-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Domains response
content:
application/json:
schema:
$ref: '#/components/schemas/Cloudflare Client API_domain-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Domain
summary: Attach to Domain
description: Attaches a worker to a zone and hostname.
operationId: worker-domain-attach-to-domain
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domains_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- zone_id
- hostname
- service
- environment
properties:
environment:
$ref: '#/components/schemas/environment'
hostname:
$ref: '#/components/schemas/components-schemas-hostname'
service:
$ref: '#/components/schemas/service'
zone_id:
$ref: '#/components/schemas/zone_identifier'
responses:
4xx:
description: Attach to Domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Cloudflare Client API_domain-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Attach to Domain response
content:
application/json:
schema:
$ref: '#/components/schemas/Cloudflare Client API_domain-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/domains/{domain_identifier}:
delete:
tags:
- Worker Domain
summary: Detach from Domain
description: Detaches a worker from a zone and hostname.
operationId: worker-domain-detach-from-domain
parameters:
- name: domain_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domain_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domains_components-schemas-account_identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Detach from Domain response failure
content:
application/json: {}
"200":
description: Detach from Domain response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Worker Domain
summary: Get a Domain
description: Gets a Worker Domain.
operationId: worker-domain-get-a-domain
parameters:
- name: domain_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domain_identifier'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/domains_components-schemas-account_identifier'
responses:
4xx:
description: Get a Domain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Cloudflare Client API_domain-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Domain response
content:
application/json:
schema:
$ref: '#/components/schemas/Cloudflare Client API_domain-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/durable_objects/namespaces:
get:
tags:
- Durable Objects Namespace
summary: List Namespaces
description: Returns the namespaces owned by an account.
operationId: durable-objects-namespace-list-namespaces
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Namespaces response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-namespace'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Namespaces response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/schemas-namespace'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/durable_objects/namespaces/{id}/objects:
get:
tags:
- Durable Objects Namespace
summary: List Objects
description: Returns the Durable Objects in a given namespace.
operationId: durable-objects-namespace-list-objects
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/namespaces_components-schemas-id'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Objects response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/object'
result_info:
properties:
count:
type: number
description: Total results returned based on your list
parameters.
example: 1
cursor:
$ref: '#/components/schemas/schemas-cursor'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Objects response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/object'
result_info:
properties:
count:
type: number
description: Total results returned based on your list parameters.
example: 1
cursor:
$ref: '#/components/schemas/schemas-cursor'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/queues:
get:
tags:
- Queue
summary: List Queues
description: Returns the queues owned by an account.
operationId: queue-list-queues
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Queues response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
errors:
nullable: true
- properties:
messages:
nullable: true
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
total_pages:
example: 1
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
- producers_total_count
- producers
- consumers_total_count
- consumers
properties:
result:
type: array
items:
$ref: '#/components/schemas/queue'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Queues response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
errors:
nullable: true
- properties:
messages:
nullable: true
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
total_pages:
example: 1
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
- producers_total_count
- producers
- consumers_total_count
- consumers
properties:
result:
type: array
items:
$ref: '#/components/schemas/queue'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Queue
summary: Create Queue
description: Creates a new queue.
operationId: queue-create-queue
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example:
queue_name: example-queue
responses:
4xx:
description: Create Queue response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue_created'
type: object
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Queue response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue_created'
type: object
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/queues/{name}:
delete:
tags:
- Queue
summary: Delete Queue
description: Deletes a queue.
operationId: queue-delete-queue
parameters:
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Queue response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- nullable: true
properties:
result:
nullable: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Queue response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- nullable: true
properties:
result:
nullable: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Queue
summary: Queue Details
description: Get information about a specific queue.
operationId: queue-queue-details
parameters:
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Queue Details response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue'
type: object
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Queue Details response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue'
type: object
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Queue
summary: Update Queue
description: Updates a queue.
operationId: queue-update-queue
parameters:
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example:
queue_name: renamed-example-queue
responses:
4xx:
description: Update Queue response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue_updated'
type: object
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Queue response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_id
- queue_name
- created_on
- modified_on
properties:
result:
allOf:
- $ref: '#/components/schemas/queue_updated'
type: object
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/queues/{name}/consumers:
get:
tags:
- Queue
summary: List Queue Consumers
description: Returns the consumers for a queue.
operationId: queue-list-queue-consumers
parameters:
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Queue Consumers response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
errors:
nullable: true
- properties:
messages:
nullable: true
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
total_pages:
example: 1
- type: object
required:
- queue_name
- created_on
- settings
properties:
result:
type: array
items:
$ref: '#/components/schemas/consumer'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Queue Consumers response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
errors:
nullable: true
- properties:
messages:
nullable: true
- properties:
result_info:
type: object
properties:
count:
example: 1
page:
example: 1
per_page:
example: 100
total_count:
example: 1
total_pages:
example: 1
- type: object
required:
- queue_name
- created_on
- settings
properties:
result:
type: array
items:
$ref: '#/components/schemas/consumer'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Queue
summary: Create Queue Consumer
description: Creates a new consumer for a queue.
operationId: queue-create-queue-consumer
parameters:
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example:
dead_letter_queue: example-dlq
environment: production
script_name: example-consumer
settings:
batch_size: 10
max_retries: 3
max_wait_time_ms: 5000
responses:
4xx:
description: Create Queue Consumer response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_name
- script_name
- settings
- dead_letter_queue
- created_on
properties:
result:
allOf:
- $ref: '#/components/schemas/consumer_created'
type: object
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Queue Consumer response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_name
- script_name
- settings
- dead_letter_queue
- created_on
properties:
result:
allOf:
- $ref: '#/components/schemas/consumer_created'
type: object
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/queues/{name}/consumers/{consumer_name}:
delete:
tags:
- Queue
summary: Delete Queue Consumer
description: Deletes the consumer for a queue.
operationId: queue-delete-queue-consumer
parameters:
- name: consumer_name
in: path
required: true
schema:
$ref: '#/components/schemas/consumer_name'
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Queue Consumer response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- nullable: true
properties:
result:
nullable: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Queue Consumer response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- nullable: true
properties:
result:
nullable: true
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Queue
summary: Update Queue Consumer
description: Updates the consumer for a queue, or creates one if it does not
exist.
operationId: queue-update-queue-consumer
parameters:
- name: consumer_name
in: path
required: true
schema:
$ref: '#/components/schemas/consumer_name'
- name: name
in: path
required: true
schema:
$ref: '#/components/schemas/queues_components-schemas-name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example:
dead_letter_queue: updated-example-dlq
environment: production
script_name: example-consumer
settings:
batch_size: 100
responses:
4xx:
description: Update Queue Consumer response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_name
- script_name
- settings
- dead_letter_queue
- created_on
properties:
result:
allOf:
- $ref: '#/components/schemas/consumer_updated'
type: object
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Queue Consumer response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- type: object
required:
- queue_name
- script_name
- settings
- dead_letter_queue
- created_on
properties:
result:
allOf:
- $ref: '#/components/schemas/consumer_updated'
type: object
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts:
get:
tags:
- Worker Script
summary: List Workers
description: Fetch a list of uploaded workers.
operationId: worker-script-list-workers
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Workers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/script-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Workers response
content:
application/json:
schema:
$ref: '#/components/schemas/script-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts/{script_name}:
delete:
tags:
- Worker Script
summary: Delete Worker
description: |-
Delete your worker. This call has no response body on a successful delete.
**Query paramaters**:
1. `force`: boolean; If set to true, delete will not be stopped by associated service binding, durable object, or other binding. Any of these associated bindings/durable objects will be deleted along with the script.
operationId: worker-script-delete-worker
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Worker response failure
content:
application/json: {}
"200":
description: Delete Worker response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Worker Script
summary: Download Worker
description: Fetch raw script content for your worker. Note this is the original
script content, not JSON encoded.
operationId: worker-script-download-worker
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Download Worker response failure
content:
undefined:
schema:
example: addEventListener('fetch', event => { event.respondWith(fetch(event.request))
})
"200":
description: Download Worker response
content:
undefined:
schema:
example: addEventListener('fetch', event => { event.respondWith(fetch(event.request))
})
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Script
summary: Upload Worker Module
description: Upload a worker module.
operationId: worker-script-upload-worker-module
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
properties:
'"second-file.js"':
type: string
description: Worker script.
example: '@second-file.js;type=application/javascript+module'
'"worker.js"':
type: string
description: Worker script.
example: '@worker.js;type=application/javascript+module'
metadata:
type: string
description: Metadata for script such as bindings. Main module needs
to be specified with `main_module`.
example: '{"main_module": "worker.js", "some_binding": "stuff"}'
responses:
4xx:
description: Upload Worker Module response failure
content:
application/json:
schema:
allOf:
- example:
errors: []
messages: []
result:
created_on: "2022-05-05T05:15:11.602148Z"
etag: 777f24a43bef5f69174aa69ceaf1dea67968d510a31d1vw3e49d34a0187c06d1
handlers:
- fetch
id: this-is_my_script-01
modified_on: "2022-05-20T19:02:56.446492Z"
usage_model: bundled
success: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload Worker Module response
content:
application/json:
schema:
example:
errors: []
messages: []
result:
created_on: "2022-05-05T05:15:11.602148Z"
etag: 777f24a43bef5f69174aa69ceaf1dea67968d510a31d1vw3e49d34a0187c06d1
handlers:
- fetch
id: this-is_my_script-01
modified_on: "2022-05-20T19:02:56.446492Z"
usage_model: bundled
success: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts/{script_name}/schedules:
get:
tags:
- Worker Cron Trigger
summary: Get Cron Triggers
description: Fetches Cron Triggers for a Worker.
operationId: worker-cron-trigger-get-cron-triggers
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Cron Triggers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/cron-trigger-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Cron Triggers response
content:
application/json:
schema:
$ref: '#/components/schemas/cron-trigger-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Cron Trigger
summary: Update Cron Triggers
description: Updates Cron Triggers for a Worker.
operationId: worker-cron-trigger-update-cron-triggers
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example: '[{''cron'': ''*/30 * * * *''}]'
responses:
4xx:
description: Update Cron Triggers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/cron-trigger-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Cron Triggers response
content:
application/json:
schema:
$ref: '#/components/schemas/cron-trigger-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts/{script_name}/tails:
get:
tags:
- Worker Tail Logs
summary: List Tails
description: Get list of tails currently deployed on a worker.
operationId: worker-tail-logs-list-tails
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Tails response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tail-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Tails response
content:
application/json:
schema:
$ref: '#/components/schemas/tail-response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Worker Tail Logs
summary: Start Tail
description: Starts a tail that receives logs and exception from a Worker.
operationId: worker-tail-logs-start-tail
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Start Tail response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/tail-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Start Tail response
content:
application/json:
schema:
$ref: '#/components/schemas/tail-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts/{script_name}/tails/{id}:
delete:
tags:
- Worker Tail Logs
summary: Delete Tail
description: Deletes a tail from a Worker.
operationId: worker-tail-logs-delete-tail
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-id'
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Tail response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-common'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Tail response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-common'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/scripts/{script_name}/usage-model:
get:
tags:
- Worker Script
summary: Fetch Usage Model
description: Fetches the Usage Model for a given Worker.
operationId: worker-script-fetch-usage-model
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Fetch Usage Model response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/usage-model-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Fetch Usage Model response
content:
application/json:
schema:
$ref: '#/components/schemas/usage-model-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Script
summary: Update Usage Model
description: Updates the Usage Model for a given Worker. Requires a Workers
Paid subscription.
operationId: worker-script-update-usage-model
parameters:
- name: script_name
in: path
required: true
schema:
$ref: '#/components/schemas/script_name'
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example: '{''usage_model'': ''unbound''}'
responses:
4xx:
description: Update Usage Model response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/usage-model-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Usage Model response
content:
application/json:
schema:
$ref: '#/components/schemas/usage-model-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier}/workers/subdomain:
get:
tags:
- Worker Subdomain
summary: Get Subdomain
description: Returns a Workers subdomain for an account.
operationId: worker-subdomain-get-subdomain
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Subdomain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/subdomain-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Subdomain response
content:
application/json:
schema:
$ref: '#/components/schemas/subdomain-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Subdomain
summary: Create Subdomain
description: Creates a Workers subdomain for an account.
operationId: worker-subdomain-create-subdomain
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
example: '{''subdomain'': ''example-subdomain''}'
responses:
4xx:
description: Create Subdomain response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/subdomain-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Subdomain response
content:
application/json:
schema:
$ref: '#/components/schemas/subdomain-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{account_identifier1}/addressing/address_maps/{address_map_identifier}/accounts/{account_identifier}:
delete:
tags:
- IP Address Management Address Maps
summary: Remove an account membership from an Address Map
description: Remove an account as a member of a particular address map.
operationId: ip-address-management-address-maps-remove-an-account-membership-from-an-address-map
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove an account membership from an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove an account membership from an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- IP Address Management Address Maps
summary: Add an account membership to an Address Map
description: Add an account as a member of a particular address map.
operationId: ip-address-management-address-maps-add-an-account-membership-to-an-address-map
parameters:
- name: account_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: address_map_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: account_identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Add an account membership to an Address Map response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an account membership to an Address Map response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}:
get:
tags:
- Accounts
summary: Account Details
description: Get information about a specific account that you are a member
of.
operationId: accounts-account-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
responses:
4xx:
description: Account Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Account Details response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Accounts
summary: Update Account
description: Update an existing account.
operationId: accounts-update-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-account'
responses:
4xx:
description: Update Account response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Account response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps:
get:
tags:
- Access applications
summary: List Access applications
description: Lists all Access applications in an account.
operationId: access-applications-list-access-applications
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: List Access applications response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access applications response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access applications
summary: Add a Bookmark application
description: Adds a custom link to the App Launcher. Bookmark applications are
not protected by Access.
operationId: access-applications-add-a-bookmark-application
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- domain
responses:
4xx:
description: Add a Bookmark application response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/bookmark_props'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add a Bookmark application response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/bookmark_props'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{app_id}:
delete:
tags:
- Access applications
summary: Delete an Access application
description: Deletes an application from Access.
operationId: access-applications-delete-an-access-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access application response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access applications
summary: Get an Access application
description: Fetches information about an Access application.
operationId: access-applications-get-an-access-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: Get an Access application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access application response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access applications
summary: Update a Bookmark application
description: Updates a Bookmark application.
operationId: access-applications-update-a-bookmark-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- domain
responses:
4xx:
description: Update a Bookmark application response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/bookmark_props'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Bookmark application response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/bookmark_props'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{app_id}/revoke_tokens:
post:
tags:
- Access applications
summary: Revoke service tokens
description: Revokes all service tokens used by an application.
operationId: access-applications-revoke-service-tokens
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Revoke service tokens response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke service tokens response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{app_id}/user_policy_checks:
get:
tags:
- Access applications
summary: Test Access policies
description: Tests if a specific user has permission to access an application.
operationId: access-applications-test-access-policies
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: Test Access policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policy_check_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Test Access policies response
content:
application/json:
schema:
$ref: '#/components/schemas/policy_check_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{uuid}/ca:
delete:
tags:
- Access short-lived certificate CAs
summary: Delete a short-lived certificate CA
description: Deletes a short-lived certificate CA.
operationId: access-short-lived-certificate-c-as-delete-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access short-lived certificate CAs
summary: Get a short-lived certificate CA
description: Fetches a short-lived certificate CA and its public key.
operationId: access-short-lived-certificate-c-as-get-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access short-lived certificate CAs
summary: Create a short-lived certificate CA
description: Generates a new short-lived certificate CA and public key.
operationId: access-short-lived-certificate-c-as-create-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{uuid}/policies:
get:
tags:
- Access policies
summary: List Access policies
description: Lists Access policies configured for an application.
operationId: access-policies-list-access-policies
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
responses:
4xx:
description: List Access policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access policies response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access policies
summary: Create an Access policy
description: Create a new Access policy for an application.
operationId: access-policies-create-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- decision
- include
properties:
approval_groups:
$ref: '#/components/schemas/approval_groups'
approval_required:
$ref: '#/components/schemas/approval_required'
decision:
$ref: '#/components/schemas/decision'
exclude:
$ref: '#/components/schemas/schemas-exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/policies_components-schemas-name'
precedence:
$ref: '#/components/schemas/precedence'
purpose_justification_prompt:
$ref: '#/components/schemas/purpose_justification_prompt'
purpose_justification_required:
$ref: '#/components/schemas/purpose_justification_required'
require:
$ref: '#/components/schemas/schemas-require'
responses:
4xx:
description: Create an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/{uuid1}/policies/{uuid}:
delete:
tags:
- Access policies
summary: Delete an Access policy
description: Delete an Access policy.
operationId: access-policies-delete-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access policies
summary: Get an Access policy
description: Fetches a single Access policy.
operationId: access-policies-get-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
responses:
4xx:
description: Get an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access policies
summary: Update an Access policy
description: Update a configured Access policy.
operationId: access-policies-update-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- decision
- include
properties:
approval_groups:
$ref: '#/components/schemas/approval_groups'
approval_required:
$ref: '#/components/schemas/approval_required'
decision:
$ref: '#/components/schemas/decision'
exclude:
$ref: '#/components/schemas/schemas-exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/policies_components-schemas-name'
precedence:
$ref: '#/components/schemas/precedence'
purpose_justification_prompt:
$ref: '#/components/schemas/purpose_justification_prompt'
purpose_justification_required:
$ref: '#/components/schemas/purpose_justification_required'
require:
$ref: '#/components/schemas/schemas-require'
responses:
4xx:
description: Update an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/apps/ca:
get:
tags:
- Access short-lived certificate CAs
summary: List short-lived certificate CAs
description: Lists short-lived certificate CAs and their public keys.
operationId: access-short-lived-certificate-c-as-list-short-lived-certificate-c-as
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List short-lived certificate CAs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List short-lived certificate CAs response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/bookmarks:
get:
tags:
- Access Bookmark applications (Deprecated)
summary: List Bookmark applications
description: Lists Bookmark applications.
operationId: access-bookmark-applications-(-deprecated)-list-bookmark-applications
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-identifier'
responses:
4xx:
description: List Bookmark applications response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bookmarks_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Bookmark applications response
content:
application/json:
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-response_collection'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/bookmarks/{uuid}:
delete:
tags:
- Access Bookmark applications (Deprecated)
summary: Delete a Bookmark application
description: Deletes a Bookmark application.
operationId: access-bookmark-applications-(-deprecated)-delete-a-bookmark-application
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Bookmark application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bookmarks_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Bookmark application response
content:
application/json:
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-id_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access Bookmark applications (Deprecated)
summary: Get a Bookmark application
description: Fetches a single Bookmark application.
operationId: access-bookmark-applications-(-deprecated)-get-a-bookmark-application
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-identifier'
responses:
4xx:
description: Get a Bookmark application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bookmarks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Bookmark application response
content:
application/json:
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-single_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access Bookmark applications (Deprecated)
summary: Create a Bookmark application
description: Create a new Bookmark application.
operationId: access-bookmark-applications-(-deprecated)-create-a-bookmark-application
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create a Bookmark application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bookmarks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Bookmark application response
content:
application/json:
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-single_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access Bookmark applications (Deprecated)
summary: Update a Bookmark application
description: Updates a configured Bookmark application.
operationId: access-bookmark-applications-(-deprecated)-update-a-bookmark-application
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Update a Bookmark application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/bookmarks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Bookmark application response
content:
application/json:
schema:
$ref: '#/components/schemas/bookmarks_components-schemas-single_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/certificates:
get:
tags:
- Access mTLS authentication
summary: List mTLS certificates
description: Lists all mTLS certificates.
operationId: access-m-tls-authentication-list-m-tls-certificates
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List mTLS certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List mTLS certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access mTLS authentication
summary: Add an mTLS certificate
description: Adds a new mTLS root certificate to Access.
operationId: access-m-tls-authentication-add-an-m-tls-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- certificate
properties:
associated_hostnames:
$ref: '#/components/schemas/associated_hostnames'
certificate:
type: string
description: The certificate content.
example: |-
-----BEGIN CERTIFICATE-----
MIIGAjCCA+qgAwIBAgIJAI7kymlF7CWT...N4RI7KKB7nikiuUf8vhULKy5IX10
DrUtmu/B
-----END CERTIFICATE-----
name:
$ref: '#/components/schemas/certificates_components-schemas-name'
responses:
4xx:
description: Add an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/certificates/{uuid}:
delete:
tags:
- Access mTLS authentication
summary: Delete an mTLS certificate
description: Deletes an mTLS certificate.
operationId: access-m-tls-authentication-delete-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access mTLS authentication
summary: Get an mTLS certificate
description: Fetches a single mTLS certificate.
operationId: access-m-tls-authentication-get-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access mTLS authentication
summary: Update an mTLS certificate
description: Updates a configured mTLS certificate.
operationId: access-m-tls-authentication-update-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- associated_hostnames
properties:
associated_hostnames:
$ref: '#/components/schemas/associated_hostnames'
name:
$ref: '#/components/schemas/certificates_components-schemas-name'
responses:
4xx:
description: Update an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/groups:
get:
tags:
- Access groups
summary: List Access groups
description: Lists all Access groups.
operationId: access-groups-list-access-groups
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Access groups response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access groups response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access groups
summary: Create an Access group
description: Creates a new Access group.
operationId: access-groups-create-an-access-group
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- include
properties:
exclude:
$ref: '#/components/schemas/exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/groups_components-schemas-name'
require:
$ref: '#/components/schemas/require'
responses:
4xx:
description: Create an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/groups/{uuid}:
delete:
tags:
- Access groups
summary: Delete an Access group
description: Deletes an Access group.
operationId: access-groups-delete-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access groups
summary: Get an Access group
description: Fetches a single Access group.
operationId: access-groups-get-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access groups
summary: Update an Access group
description: Updates a configured Access group.
operationId: access-groups-update-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- include
properties:
exclude:
$ref: '#/components/schemas/exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/groups_components-schemas-name'
require:
$ref: '#/components/schemas/require'
responses:
4xx:
description: Update an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/identity_providers:
get:
tags:
- Access identity providers
summary: List Access identity providers
description: Lists all configured identity providers.
operationId: access-identity-providers-list-access-identity-providers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
responses:
4xx:
description: List Access identity providers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access identity providers response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access identity providers
summary: Add an Access identity provider
description: Adds a new identity provider to Access.
operationId: access-identity-providers-add-an-access-identity-provider
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- config
properties:
config:
$ref: '#/components/schemas/schemas-config'
name:
$ref: '#/components/schemas/identity-providers_components-schemas-name'
type:
$ref: '#/components/schemas/identity-providers_components-schemas-type'
responses:
4xx:
description: Add an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/identity_providers/{uuid}:
delete:
tags:
- Access identity providers
summary: Delete an Access identity provider
description: Deletes an identity provider from Access.
operationId: access-identity-providers-delete-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Access identity providers
summary: Get an Access identity provider
description: Fetches a configured identity provider.
operationId: access-identity-providers-get-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
responses:
4xx:
description: Get an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access identity providers
summary: Update an Access identity provider
description: Updates a configured identity provider.
operationId: access-identity-providers-update-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- config
properties:
config:
$ref: '#/components/schemas/schemas-config'
name:
$ref: '#/components/schemas/identity-providers_components-schemas-name'
type:
$ref: '#/components/schemas/identity-providers_components-schemas-type'
responses:
4xx:
description: Update an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/keys:
get:
tags:
- Access key configuration
summary: Get the Access key configuration
description: Gets the Access key rotation settings for an account.
operationId: access-key-configuration-get-the-access-key-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keys_components-schemas-identifier-2'
responses:
4xx:
description: Get the Access key configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keys_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get the Access key configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keys_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access key configuration
summary: Update the Access key configuration
description: Updates the Access key rotation settings for an account.
operationId: access-key-configuration-update-the-access-key-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keys_components-schemas-identifier-2'
requestBody:
required: true
content:
application/json:
schema:
required:
- key_rotation_interval_days
properties:
key_rotation_interval_days:
$ref: '#/components/schemas/key_rotation_interval_days'
responses:
4xx:
description: Update the Access key configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keys_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update the Access key configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keys_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/keys/rotate:
post:
tags:
- Access key configuration
summary: Rotate Access keys
description: Perfoms a key rotation for an account.
operationId: access-key-configuration-rotate-access-keys
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keys_components-schemas-identifier-2'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Rotate Access keys response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keys_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Rotate Access keys response
content:
application/json:
schema:
$ref: '#/components/schemas/keys_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/logs/access_requests:
get:
tags:
- Access authentication logs
summary: Get Access authentication logs
description: Gets a list of Access authentication audit logs for an account.
operationId: access-authentication-logs-get-access-authentication-logs
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/access-requests_components-schemas-identifier'
responses:
4xx:
description: Get Access authentication logs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/access-requests_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Access authentication logs response
content:
application/json:
schema:
$ref: '#/components/schemas/access-requests_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/organizations:
get:
tags:
- Zero Trust organization
summary: Get your Zero Trust organization
description: Returns the configuration for your Zero Trust organization.
operationId: zero-trust-organization-get-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
responses:
4xx:
description: Get your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust organization
summary: Create your Zero Trust organization
description: Sets up a Zero Trust organization for your account.
operationId: zero-trust-organization-create-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- auth_domain
properties:
auth_domain:
$ref: '#/components/schemas/auth_domain'
is_ui_read_only:
$ref: '#/components/schemas/is_ui_read_only'
login_design:
$ref: '#/components/schemas/login_design'
name:
$ref: '#/components/schemas/organizations_components-schemas-name'
responses:
4xx:
description: Create your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust organization
summary: Update your Zero Trust organization
description: Updates the configuration for your Zero Trust organization.
operationId: zero-trust-organization-update-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
auth_domain:
$ref: '#/components/schemas/auth_domain'
is_ui_read_only:
$ref: '#/components/schemas/is_ui_read_only'
login_design:
$ref: '#/components/schemas/login_design'
name:
$ref: '#/components/schemas/organizations_components-schemas-name'
responses:
4xx:
description: Update your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/organizations/revoke_user:
post:
tags:
- Zero Trust organization
summary: Revoke all Access tokens for a user
description: Revokes a user's access across all applications.
operationId: zero-trust-organization-revoke-all-access-tokens-for-a-user
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- email
properties:
email:
type: string
description: The email of the user to revoke.
example: test@example.com
responses:
4xx:
description: Revoke all Access tokens for a user response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke all Access tokens for a user response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/seats:
patch:
tags:
- Zero Trust seats
summary: Update a user seat
description: Removes a user from a Zero Trust seat when both `access_seat` and
`gateway_seat` are set to false.
operationId: zero-trust-seats-update-a-user-seat
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/seats_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/seats_definition'
responses:
4xx:
description: Update a user seat response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/seats_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a user seat response
content:
application/json:
schema:
$ref: '#/components/schemas/seats_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/service_tokens:
get:
tags:
- Access service tokens
summary: List service tokens
description: Lists all service tokens.
operationId: access-service-tokens-list-service-tokens
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List service tokens response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List service tokens response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Access service tokens
summary: Create a service token
description: Generates a new service token. **Note:** This is the only time
you can get the Client Secret. If you lose the Client Secret, you will have
to rotate the Client Secret or create a new service token.
operationId: access-service-tokens-create-a-service-token
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
properties:
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
responses:
4xx:
description: Create a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/create_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/create_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/service_tokens/{uuid}:
delete:
tags:
- Access service tokens
summary: Delete a service token
description: Deletes a service token.
operationId: access-service-tokens-delete-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Access service tokens
summary: Update a service token
description: Updates a configured service token.
operationId: access-service-tokens-update-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
responses:
4xx:
description: Update a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/service_tokens/{uuid}/refresh:
post:
tags:
- Access service tokens
summary: Refresh a service token
description: Refreshes the expiration of a service token.
operationId: access-service-tokens-refresh-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Refresh a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Refresh a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/service_tokens/{uuid}/rotate:
post:
tags:
- Access service tokens
summary: Rotate a service token
description: Generates a new Client Secret for a service token and revokes the
old one.
operationId: access-service-tokens-rotate-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Rotate a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/create_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Rotate a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/create_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/users:
get:
tags:
- Zero Trust users
summary: Get users
description: Gets a list of users for an account.
operationId: zero-trust-users-get-users
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/users_components-schemas-identifier'
responses:
4xx:
description: Get users response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/users_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get users response
content:
application/json:
schema:
$ref: '#/components/schemas/users_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/access/users/{id}/failed_logins:
get:
tags:
- Zero Trust users
summary: Get failed logins
description: Get all failed login attempts for a single user.
operationId: zero-trust-users-get-failed-logins
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/users_components-schemas-id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/users_components-schemas-identifier'
responses:
4xx:
description: Get failed logins response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/failed_login_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get failed logins response
content:
application/json:
schema:
$ref: '#/components/schemas/failed_login_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/available_alerts:
get:
tags:
- Notification Alert Types
summary: Get Alert Types
description: Gets a list of all alert types for which an account is eligible.
operationId: notification-alert-types-get-alert-types
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Alert Types response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alert-types_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Alert Types response
content:
application/json:
schema:
$ref: '#/components/schemas/alert-types_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/destinations/eligible:
get:
tags:
- Notification Mechanism Eligibility
summary: Get delivery mechanism eligibility
description: Get a list of all delivery mechanism types for which an account
is eligible.
operationId: notification-mechanism-eligibility-get-delivery-mechanism-eligibility
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get delivery mechanism eligibility response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/eligibility_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get delivery mechanism eligibility response
content:
application/json:
schema:
$ref: '#/components/schemas/eligibility_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/destinations/pagerduty:
get:
tags:
- Notification destinations with PagerDuty
summary: List PagerDuty services
description: Get a list of all configured PagerDuty services.
operationId: notification-destinations-with-pager-duty-list-pager-duty-services
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List PagerDuty services response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerduty_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List PagerDuty services response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerduty_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/destinations/webhooks:
get:
tags:
- Notification webhooks
summary: List webhooks
description: Gets a list of all configured webhook destinations.
operationId: notification-webhooks-list-webhooks
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List webhooks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhooks_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List webhooks response
content:
application/json:
schema:
$ref: '#/components/schemas/webhooks_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Notification webhooks
summary: Create a webhook
description: Creates a new webhook destination.
operationId: notification-webhooks-create-a-webhook
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- url
properties:
name:
$ref: '#/components/schemas/webhooks_components-schemas-name'
secret:
$ref: '#/components/schemas/schemas-secret'
url:
$ref: '#/components/schemas/webhooks_components-schemas-url'
responses:
4xx:
description: Create a webhook response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhooks_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a webhook response
content:
application/json:
schema:
$ref: '#/components/schemas/webhooks_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/destinations/webhooks/{uuid}:
delete:
tags:
- Notification webhooks
summary: Delete a webhook
description: Delete a configured webhook destination.
operationId: notification-webhooks-delete-a-webhook
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a webhook response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a webhook response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Notification webhooks
summary: Get a webhook
description: Get details for a single webhooks destination.
operationId: notification-webhooks-get-a-webhook
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a webhook response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhooks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a webhook response
content:
application/json:
schema:
$ref: '#/components/schemas/webhooks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Notification webhooks
summary: Update a webhook
description: Update a webhook destination.
operationId: notification-webhooks-update-a-webhook
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- url
properties:
name:
$ref: '#/components/schemas/webhooks_components-schemas-name'
secret:
$ref: '#/components/schemas/schemas-secret'
url:
$ref: '#/components/schemas/webhooks_components-schemas-url'
responses:
4xx:
description: Update a webhook response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhooks_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a webhook response
content:
application/json:
schema:
$ref: '#/components/schemas/webhooks_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/history:
get:
tags:
- Notification History
summary: List History
description: Gets a list of history records for notifications sent to an account.
The records are displayed for last `x` number of days based on the zone plan
(free = 30, pro = 30, biz = 30, ent = 90).
operationId: notification-history-list-history
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List History response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/history_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List History response
content:
application/json:
schema:
$ref: '#/components/schemas/history_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/policies:
get:
tags:
- Notification policies
summary: List Notification policies
description: Get a list of all Notification policies.
operationId: notification-policies-list-notification-policies
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Notification policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-response_collection-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Notification policies response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-response_collection-2'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Notification policies
summary: Create a Notification policy
description: Creates a new Notification policy.
operationId: notification-policies-create-a-notification-policy
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- alert_type
- enabled
- mechanisms
properties:
alert_type:
$ref: '#/components/schemas/alert_type'
description:
$ref: '#/components/schemas/policies_components-schemas-description'
enabled:
$ref: '#/components/schemas/policies_components-schemas-enabled'
filters:
$ref: '#/components/schemas/components-schemas-filters'
mechanisms:
$ref: '#/components/schemas/mechanisms'
name:
$ref: '#/components/schemas/policies_components-schemas-name-2'
responses:
4xx:
description: Create a Notification policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-id_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Notification policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-id_response-2'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/alerting/v3/policies/{uuid}:
delete:
tags:
- Notification policies
summary: Delete a Notification policy
description: Delete a Notification policy.
operationId: notification-policies-delete-a-notification-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Notification policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Notification policy response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Notification policies
summary: Get a Notification policy
description: Get details for a single policy.
operationId: notification-policies-get-a-notification-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a Notification policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Notification policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Notification policies
summary: Update a Notification policy
description: Update a Notification policy.
operationId: notification-policies-update-a-notification-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
alert_type:
$ref: '#/components/schemas/alert_type'
description:
$ref: '#/components/schemas/policies_components-schemas-description'
enabled:
$ref: '#/components/schemas/policies_components-schemas-enabled'
filters:
$ref: '#/components/schemas/components-schemas-filters'
mechanisms:
$ref: '#/components/schemas/mechanisms'
name:
$ref: '#/components/schemas/policies_components-schemas-name-2'
responses:
4xx:
description: Update a Notification policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-id_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Notification policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-id_response-2'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/custom_ns:
get:
tags:
- Account-Level Custom Nameservers
summary: List Account Custom Nameservers
description: List an account's custom nameservers.
operationId: account-level-custom-nameservers-list-account-custom-nameservers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-ns_components-schemas-identifier'
responses:
4xx:
description: List Account Custom Nameservers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acns_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Account Custom Nameservers response
content:
application/json:
schema:
$ref: '#/components/schemas/acns_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Account-Level Custom Nameservers
summary: Add Account Custom Nameserver
operationId: account-level-custom-nameservers-add-account-custom-nameserver
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-ns_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CustomNSInput'
responses:
4xx:
description: Add Account Custom Nameserver response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acns_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add Account Custom Nameserver response
content:
application/json:
schema:
$ref: '#/components/schemas/acns_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/custom_ns/{ns_name}:
delete:
tags:
- Account-Level Custom Nameservers
summary: Delete Account Custom Nameserver
operationId: account-level-custom-nameservers-delete-account-custom-nameserver
parameters:
- name: ns_name
in: path
required: true
schema:
$ref: '#/components/schemas/ns_name'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-ns_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Account Custom Nameserver response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Account Custom Nameserver response
content:
application/json:
schema:
$ref: '#/components/schemas/empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/custom_ns/availability:
get:
tags:
- Account-Level Custom Nameservers
summary: Get Eligible Zones for Account Custom Nameservers
operationId: account-level-custom-nameservers-get-eligible-zones-for-account-custom-nameservers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-ns_components-schemas-identifier'
responses:
4xx:
description: Get Eligible Zones for Account Custom Nameservers response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/availability_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Eligible Zones for Account Custom Nameservers response
content:
application/json:
schema:
$ref: '#/components/schemas/availability_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/custom_ns/verify:
post:
tags:
- Account-Level Custom Nameservers
summary: Verify Account Custom Nameserver Glue Records
operationId: account-level-custom-nameservers-verify-account-custom-nameserver-glue-records
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-ns_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Verify Account Custom Nameserver Glue Records response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/acns_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Verify Account Custom Nameserver Glue Records response
content:
application/json:
schema:
$ref: '#/components/schemas/acns_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices:
get:
tags:
- Devices
summary: List Devices
description: List Enrolled Devices.
operationId: devices-list-devices
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: List Devices response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/devices_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Devices response
content:
application/json:
schema:
$ref: '#/components/schemas/devices_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/{uuid}:
get:
tags:
- Devices
summary: Device Details
description: Fetch a single Device.
operationId: devices-device-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Device Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Device Details response
content:
application/json:
schema:
$ref: '#/components/schemas/device_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/{uuid}/override_codes:
get:
tags:
- Devices
summary: List Admin Override code for device
description: Fetch one-time use admin override code for a device. This relies
on the Admin Override setting being enabled in your device configuration.
operationId: devices-list-admin-override-code-for-device
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: List Admin Override code for device response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/override_codes_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Admin Override code for device response
content:
application/json:
schema:
$ref: '#/components/schemas/override_codes_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policies:
get:
tags:
- Devices
summary: List Device Settings Policies
description: Lists the device settings policies for an account.
operationId: devices-list-device-settings-policies
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: List Device Settings Policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Device Settings Policies response
content:
application/json:
schema:
$ref: '#/components/schemas/device_settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy:
get:
tags:
- Devices
summary: Get Default Device Settings Policy
description: Get the default device settings policy for an account.
operationId: devices-get-default-device-settings-policy
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Default Device Settings Policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/default_device_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Default Device Settings Policy response
content:
application/json:
schema:
$ref: '#/components/schemas/default_device_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Devices
summary: Update Default Device Settings Policy
description: Update the default device settings policy for an account.
operationId: devices-update-default-device-settings-policy
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
allow_mode_switch:
$ref: '#/components/schemas/allow_mode_switch'
allow_updates:
$ref: '#/components/schemas/allow_updates'
allowed_to_leave:
$ref: '#/components/schemas/allowed_to_leave'
auto_connect:
$ref: '#/components/schemas/auto_connect'
captive_portal:
$ref: '#/components/schemas/captive_portal'
disable_auto_fallback:
$ref: '#/components/schemas/disable_auto_fallback'
service_mode_v2:
$ref: '#/components/schemas/service_mode_v2'
support_url:
$ref: '#/components/schemas/support_url'
switch_locked:
$ref: '#/components/schemas/switch_locked'
responses:
4xx:
description: Update Default Device Settings Policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/default_device_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Default Device Settings Policy response
content:
application/json:
schema:
$ref: '#/components/schemas/default_device_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Devices
summary: Create Device Settings Policy
description: Create a device settings policy to be applied to certain devices
matching the criteria.
operationId: devices-create-device-settings-policy
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- precedence
- match
properties:
allow_mode_switch:
$ref: '#/components/schemas/allow_mode_switch'
allow_updates:
$ref: '#/components/schemas/allow_updates'
allowed_to_leave:
$ref: '#/components/schemas/allowed_to_leave'
auto_connect:
$ref: '#/components/schemas/auto_connect'
captive_portal:
$ref: '#/components/schemas/captive_portal'
disable_auto_fallback:
$ref: '#/components/schemas/disable_auto_fallback'
enabled:
type: boolean
description: Whether the policy will be applied to matching devices.
example: true
match:
$ref: '#/components/schemas/components-schemas-match'
name:
type: string
description: The name of the device settings policy.
example: Allow Developers
maxLength: 100
precedence:
$ref: '#/components/schemas/components-schemas-precedence'
service_mode_v2:
$ref: '#/components/schemas/service_mode_v2'
support_url:
$ref: '#/components/schemas/support_url'
switch_locked:
$ref: '#/components/schemas/switch_locked'
responses:
4xx:
description: Create Device Settings Policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Device Settings Policy response
content:
application/json:
schema:
$ref: '#/components/schemas/device_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/{uuid}:
delete:
tags:
- Devices
summary: Delete Device Settings Policy
description: Delete a device settings policy. Returns the remaining policies
for the account.
operationId: devices-delete-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Device Settings Policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Device Settings Policy response
content:
application/json:
schema:
$ref: '#/components/schemas/device_settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Devices
summary: Get Device Settings Policy by ID
description: Get the device settings policy by ID.
operationId: devices-get-device-settings-policy-by-id
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Device Settings Policy by ID response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Device Settings Policy by ID response
content:
application/json:
schema:
$ref: '#/components/schemas/device_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Devices
summary: Update Device Settings Policy
description: Update a device settings policy.
operationId: devices-update-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
allow_mode_switch:
$ref: '#/components/schemas/allow_mode_switch'
allow_updates:
$ref: '#/components/schemas/allow_updates'
allowed_to_leave:
$ref: '#/components/schemas/allowed_to_leave'
auto_connect:
$ref: '#/components/schemas/auto_connect'
captive_portal:
$ref: '#/components/schemas/captive_portal'
disable_auto_fallback:
$ref: '#/components/schemas/disable_auto_fallback'
enabled:
type: boolean
description: Whether the policy will be applied to matching devices.
example: true
match:
$ref: '#/components/schemas/components-schemas-match'
name:
type: string
description: The name of the device settings policy.
example: Allow Developers
maxLength: 100
precedence:
$ref: '#/components/schemas/components-schemas-precedence'
service_mode_v2:
$ref: '#/components/schemas/service_mode_v2'
support_url:
$ref: '#/components/schemas/support_url'
switch_locked:
$ref: '#/components/schemas/switch_locked'
responses:
4xx:
description: Update Device Settings Policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Device Settings Policy response
content:
application/json:
schema:
$ref: '#/components/schemas/device_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/{uuid}/exclude:
get:
tags:
- Devices
summary: Get Split Tunnel Exclude List for a Device Settings Policy
description: Get the list of routes excluded from the WARP client's tunnel for
one specific device settings policy.
operationId: devices-get-split-tunnel-exclude-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Split Tunnel Exclude List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Split Tunnel Exclude List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Split Tunnel Exclude List for a Device Settings Policy
description: Set the list of routes excluded from the WARP client's tunnel for
one specific device settings policy.
operationId: devices-set-split-tunnel-exclude-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/split_tunnel'
responses:
4xx:
description: Set Split Tunnel Exclude List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Split Tunnel Exclude List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/{uuid}/fallback_domains:
get:
tags:
- Devices
summary: Get Local Domain Fallback List for a Device Settings Policy
description: Get the list of domains to bypass Gateway for DNS resolution and
instead use the specified server.
operationId: devices-get-local-domain-fallback-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Local Domain Fallback List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_domain_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Local Domain Fallback List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_domain_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Local Domain Fallback List for a Device Settings Policy
description: Set the list of domains to bypass Gateway for DNS resolution and
instead use the specified server.
operationId: devices-set-local-domain-fallback-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/fallback_domain'
responses:
4xx:
description: Set Local Domain Fallback List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_domain_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Local Domain Fallback List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_domain_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/{uuid}/include:
get:
tags:
- Devices
summary: Get Split Tunnel Include List for a Device Settings Policy
description: Get the list of routes included in the WARP client's tunnel for
one specific device settings policy.
operationId: devices-get-split-tunnel-include-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Split Tunnel Include List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_include_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Split Tunnel Include List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_include_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Split Tunnel Include List for a Device Settings Policy
description: Set the list of routes included in the WARP client's tunnel for
one specific device settings policy.
operationId: devices-set-split-tunnel-include-list-for-a-device-settings-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/split_tunnel_include'
responses:
4xx:
description: Set Split Tunnel Include List for a Device Settings Policy
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_include_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Split Tunnel Include List for a Device Settings Policy
response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_include_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/exclude:
get:
tags:
- Devices
summary: Get Split Tunnel Exclude List
description: Get the list of routes excluded from the WARP client's tunnel.
operationId: devices-get-split-tunnel-exclude-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Split Tunnel Exclude List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Split Tunnel Exclude List response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Split Tunnel Exclude List
description: Set the list of routes excluded from the WARP client's tunnel.
operationId: devices-set-split-tunnel-exclude-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/split_tunnel'
responses:
4xx:
description: Set Split Tunnel Exclude List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Split Tunnel Exclude List response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/fallback_domains:
get:
tags:
- Devices
summary: Get Local Domain Fallback List
description: Get the list of domains to bypass Gateway for DNS resolution and
instead use the specified server.
operationId: devices-get-local-domain-fallback-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Local Domain Fallback List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_domain_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Local Domain Fallback List response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_domain_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Local Domain Fallback List
description: Set the list of domains to bypass Gateway for DNS resolution and
instead use the specified server.
operationId: devices-set-local-domain-fallback-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/fallback_domain'
responses:
4xx:
description: Set Local Domain Fallback List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_domain_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Local Domain Fallback List response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_domain_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/policy/include:
get:
tags:
- Devices
summary: Get Split Tunnel Include List
description: Get the list of routes included in the WARP client's tunnel.
operationId: devices-get-split-tunnel-include-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
responses:
4xx:
description: Get Split Tunnel Include List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_include_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Split Tunnel Include List response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_include_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Devices
summary: Set Split Tunnel Include List
description: Set the list of routes included in the WARP client's tunnel.
operationId: devices-set-split-tunnel-include-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/split_tunnel_include'
responses:
4xx:
description: Set Split Tunnel Include List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/split_tunnel_include_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Split Tunnel Include List response
content:
application/json:
schema:
$ref: '#/components/schemas/split_tunnel_include_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/posture:
get:
tags:
- Device Posture Rules
summary: List Device Posture Rules
description: List Device Posture Rules for an account.
operationId: device-posture-rules-list-device-posture-rules
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-identifier'
responses:
4xx:
description: List Device Posture Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-rules_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Device Posture Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Device Posture Rules
summary: Create Device Posture Rule
description: Create a new Device Posture Rule.
operationId: device-posture-rules-create-device-posture-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
properties:
description:
$ref: '#/components/schemas/device-posture-rules_components-schemas-description'
expiration:
$ref: '#/components/schemas/schemas-expiration'
input:
$ref: '#/components/schemas/schemas-input'
match:
$ref: '#/components/schemas/schemas-match'
name:
$ref: '#/components/schemas/device-posture-rules_components-schemas-name'
schedule:
$ref: '#/components/schemas/schedule'
type:
$ref: '#/components/schemas/device-posture-rules_components-schemas-type'
responses:
4xx:
description: Create Device Posture Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Device Posture Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/posture/{uuid}:
delete:
tags:
- Device Posture Rules
summary: Delete Device Posture Rule
description: Delete a Device Posture Rule.
operationId: device-posture-rules-delete-device-posture-rule
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Device Posture Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-rules_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Device Posture Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Device Posture Rules
summary: Device Posture Rules Details
description: Fetch a single Device Posture Rule.
operationId: device-posture-rules-device-posture-rules-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-identifier'
responses:
4xx:
description: Device Posture Rules Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Device Posture Rules Details response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Device Posture Rules
summary: Update Device Posture Rule
description: Update a Device Posture Rule.
operationId: device-posture-rules-update-device-posture-rule
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
properties:
description:
$ref: '#/components/schemas/device-posture-rules_components-schemas-description'
expiration:
$ref: '#/components/schemas/schemas-expiration'
input:
$ref: '#/components/schemas/schemas-input'
match:
$ref: '#/components/schemas/schemas-match'
name:
$ref: '#/components/schemas/device-posture-rules_components-schemas-name'
schedule:
$ref: '#/components/schemas/schedule'
type:
$ref: '#/components/schemas/device-posture-rules_components-schemas-type'
responses:
4xx:
description: Update Device Posture Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Device Posture Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/posture/integration:
get:
tags:
- Device Posture Integrations
summary: List Device Posture Integrations
description: List Device Posture Integrations for an account.
operationId: device-posture-integrations-list-device-posture-integrations
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-identifier'
responses:
4xx:
description: List Device Posture Integrations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-integrations_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Device Posture Integrations response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Device Posture Integrations
summary: Create Device Posture Integration
description: Create a new Device Posture Integration.
operationId: device-posture-integrations-create-device-posture-integration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- interval
- config
properties:
config:
$ref: '#/components/schemas/config_request'
interval:
$ref: '#/components/schemas/schemas-interval'
name:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-name'
type:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-type'
responses:
4xx:
description: Create Device Posture Integration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Device Posture Integration response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/posture/integration/{uuid}:
delete:
tags:
- Device Posture Integrations
summary: Delete Device Posture Integration
description: Delete a Device Posture Integration.
operationId: device-posture-integrations-delete-device-posture-integration
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Device Posture Integration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-integrations_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Device Posture Integration response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Device Posture Integrations
summary: Device Posture Integration Details
description: Fetch a single Device Posture Integration.
operationId: device-posture-integrations-device-posture-integration-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-identifier'
responses:
4xx:
description: Device Posture Integration Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Device Posture Integration Details response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Device Posture Integrations
summary: Update Device Posture Integration
description: Update a Device Posture Integration.
operationId: device-posture-integrations-update-device-posture-integration
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
config:
$ref: '#/components/schemas/config_request'
interval:
$ref: '#/components/schemas/schemas-interval'
name:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-name'
type:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-type'
responses:
4xx:
description: Update Device Posture Integration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Device Posture Integration response
content:
application/json:
schema:
$ref: '#/components/schemas/device-posture-integrations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/revoke:
post:
tags:
- Devices
summary: Revoke Devices
description: Revoke a list of devices.
operationId: devices-revoke-devices
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/revoke_devices_request'
responses:
4xx:
description: Revoke Devices response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke Devices response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/settings:
get:
tags:
- Zero Trust accounts
summary: Get device settings for Zero Trust account
description: Describes the current device settings Zero Trust account.
operationId: zero-trust-accounts-get-device-settings-for-zero-trust-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
responses:
4xx:
description: Get device settings for Zero Trust account response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway-account-device-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get device settings for Zero Trust account response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-device-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust accounts
summary: Update device settings for the Zero Trust account
description: Updates the current device settings for Zero Trust account.
operationId: zero-trust-accounts-update-device-settings-for-the-zero-trust-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-device-settings'
responses:
4xx:
description: Update device settings for the Zero Trust account response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway-account-device-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update device settings for the Zero Trust account response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-device-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/devices/unrevoke:
post:
tags:
- Devices
summary: Unrevoke Devices
description: Unrevoke a list of devices.
operationId: devices-unrevoke-devices
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/devices_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/unrevoke_devices_request'
responses:
4xx:
description: Unrevoke Devices response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Unrevoke Devices response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway:
get:
tags:
- Zero Trust accounts
summary: Get Zero Trust account information
description: Get Zero Trust account information.
operationId: zero-trust-accounts-get-zero-trust-account-information
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
responses:
4xx:
description: Get Zero Trust account information response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_account'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Zero Trust account information response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway_account'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust accounts
summary: Create Zero Trust account
description: Create Zero Trust account with existing cloudflare account.
operationId: zero-trust-accounts-create-zero-trust-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- account_id
properties:
account_id:
$ref: '#/components/schemas/cf_account_id'
responses:
4xx:
description: Create Zero Trust account response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_account'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zero Trust account response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway_account'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/app_types:
get:
tags:
- Zero Trust Gateway Application and Application Type mappings
summary: List Application and Application Type mappings
description: List all Application and Application Type mappings.
operationId: zero-trust-gateway-application-and-application-type-mappings-list-application-and-application-type-mappings
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Application and Application Type mappings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/app-types_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Application and Application Type mappings response
content:
application/json:
schema:
$ref: '#/components/schemas/app-types_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/configuration:
get:
tags:
- Zero Trust accounts
summary: Get Zero Trust account configuration
description: Describes current Zero Trust account configuration.
operationId: zero-trust-accounts-get-zero-trust-account-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
responses:
4xx:
description: Get Zero Trust account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_account_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Zero Trust account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway_account_config'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust accounts
summary: Update Zero Trust account configuration
description: Updates the current Zero Trust account configuration.
operationId: zero-trust-accounts-update-zero-trust-account-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-settings'
responses:
4xx:
description: Update Zero Trust account configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_account_config'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Zero Trust account configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway_account_config'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/lists:
get:
tags:
- Zero Trust Lists
summary: List Zero Trust Lists
description: List Zero Trust Lists for an account.
operationId: zero-trust-lists-list-zero-trust-lists
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
responses:
4xx:
description: List Zero Trust Lists response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Zero Trust Lists response
content:
application/json:
schema:
$ref: '#/components/schemas/lists_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust Lists
summary: Create Zero Trust List
description: Create a new Zero Trust List.
operationId: zero-trust-lists-create-zero-trust-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
properties:
description:
$ref: '#/components/schemas/lists_components-schemas-description-2'
items:
$ref: '#/components/schemas/schemas-items'
name:
$ref: '#/components/schemas/lists_components-schemas-name-2'
type:
$ref: '#/components/schemas/lists_components-schemas-type'
responses:
4xx:
description: Create Zero Trust List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_with_list_items'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zero Trust List response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_with_list_items'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/lists/{uuid}:
delete:
tags:
- Zero Trust Lists
summary: Delete Zero Trust List
description: Delete a Zero Trust List.
operationId: zero-trust-lists-delete-zero-trust-list
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Zero Trust List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Zero Trust List response
content:
application/json:
schema:
$ref: '#/components/schemas/lists_components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zero Trust Lists
summary: Zero Trust List Details
description: Fetch a single Zero Trust List.
operationId: zero-trust-lists-zero-trust-list-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
responses:
4xx:
description: Zero Trust List Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zero Trust List Details response
content:
application/json:
schema:
$ref: '#/components/schemas/lists_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zero Trust Lists
summary: Patch Zero Trust List
description: Append or remove an item from a configured Zero Trust List.
operationId: zero-trust-lists-patch-zero-trust-list
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
append:
$ref: '#/components/schemas/schemas-items'
remove:
type: array
description: A list of the item values you want to remove.
items:
$ref: '#/components/schemas/lists_components-schemas-value'
responses:
4xx:
description: Patch Zero Trust List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Zero Trust List response
content:
application/json:
schema:
$ref: '#/components/schemas/lists_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust Lists
summary: Update Zero Trust List
description: Update a configured Zero Trust List.
operationId: zero-trust-lists-update-zero-trust-list
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
properties:
description:
$ref: '#/components/schemas/lists_components-schemas-description-2'
name:
$ref: '#/components/schemas/lists_components-schemas-name-2'
responses:
4xx:
description: Update Zero Trust List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/lists_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Zero Trust List response
content:
application/json:
schema:
$ref: '#/components/schemas/lists_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/lists/{uuid}/items:
get:
tags:
- Zero Trust Lists
summary: Zero Trust List Items
description: Fetch all items of a single Zero Trust List.
operationId: zero-trust-lists-zero-trust-list-items
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/lists_components-schemas-identifier'
responses:
4xx:
description: Zero Trust List Items response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list_item_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zero Trust List Items response
content:
application/json:
schema:
$ref: '#/components/schemas/list_item_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/locations:
get:
tags:
- Zero Trust Gateway Locations
summary: List Zero Trust Gateway Locations
description: List Zero Trust Gateway Locations for an account.
operationId: zero-trust-gateway-locations-list-zero-trust-gateway-locations
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-identifier'
responses:
4xx:
description: List Zero Trust Gateway Locations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/locations_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Zero Trust Gateway Locations response
content:
application/json:
schema:
$ref: '#/components/schemas/locations_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust Gateway Locations
summary: Create Zero Trust Gateway Location
description: Create a new Zero Trust Gateway Location.
operationId: zero-trust-gateway-locations-create-zero-trust-gateway-location
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
properties:
client_default:
$ref: '#/components/schemas/client-default'
ecs_support:
$ref: '#/components/schemas/ecs-support'
name:
$ref: '#/components/schemas/locations_components-schemas-name'
networks:
$ref: '#/components/schemas/network'
responses:
4xx:
description: Create Zero Trust Gateway Location response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/locations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zero Trust Gateway Location response
content:
application/json:
schema:
$ref: '#/components/schemas/locations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/locations/{uuid}:
delete:
tags:
- Zero Trust Gateway Locations
summary: Delete Zero Trust Gateway Location
description: Delete a Zero Trust Gateway Location.
operationId: zero-trust-gateway-locations-delete-zero-trust-gateway-location
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Zero Trust Gateway Location response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/locations_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Zero Trust Gateway Location response
content:
application/json:
schema:
$ref: '#/components/schemas/locations_components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zero Trust Gateway Locations
summary: Zero Trust Gateway Location Details
description: Fetch a single Zero Trust Gateway Location.
operationId: zero-trust-gateway-locations-zero-trust-gateway-location-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-identifier'
responses:
4xx:
description: Zero Trust Gateway Location Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/locations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zero Trust Gateway Location Details response
content:
application/json:
schema:
$ref: '#/components/schemas/locations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust Gateway Locations
summary: Update Zero Trust Gateway Location
description: Update a configured Zero Trust Gateway Location.
operationId: zero-trust-gateway-locations-update-zero-trust-gateway-location
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/locations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
properties:
client_default:
$ref: '#/components/schemas/client-default'
ecs_support:
$ref: '#/components/schemas/ecs-support'
name:
$ref: '#/components/schemas/locations_components-schemas-name'
networks:
$ref: '#/components/schemas/network'
responses:
4xx:
description: Update Zero Trust Gateway Location response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/locations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Zero Trust Gateway Location response
content:
application/json:
schema:
$ref: '#/components/schemas/locations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/logging:
get:
tags:
- Zero Trust accounts
summary: Get logging settings for the Zero Trust account
description: Describes the current logging settings for Zero Trust account.
operationId: zero-trust-accounts-get-logging-settings-for-the-zero-trust-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
responses:
4xx:
description: Get logging settings for the Zero Trust account response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway-account-logging-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get logging settings for the Zero Trust account response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-logging-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust accounts
summary: Update logging settings for the Zero Trust account
description: Updates the current logging settings for the Zero Trust accounty.
operationId: zero-trust-accounts-update-logging-settings-for-the-zero-trust-account
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/accounts_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-logging-settings'
responses:
4xx:
description: Update logging settings for the Zero Trust account response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway-account-logging-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update logging settings for the Zero Trust account response
content:
application/json:
schema:
$ref: '#/components/schemas/gateway-account-logging-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/proxy_endpoints:
get:
tags:
- Zero Trust Gateway Proxy Endpoints
summary: List Proxy Endpoints
description: Fetch a single Zero Trust Gateway Proxy Endpoint.
operationId: zero-trust-gateway-proxy-endpoints-list-proxy-endpoints
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-identifier'
responses:
4xx:
description: List Proxy Endpoints response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/proxy-endpoints_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Proxy Endpoints response
content:
application/json:
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust Gateway Proxy Endpoints
summary: Create Proxy Endpoint
description: Create a new Zero Trust Gateway Proxy Endpoint.
operationId: zero-trust-gateway-proxy-endpoints-create-proxy-endpoint
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- ips
properties:
ips:
$ref: '#/components/schemas/components-schemas-ips'
name:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-name'
subdomain:
$ref: '#/components/schemas/schemas-subdomain'
responses:
4xx:
description: Create Proxy Endpoint response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Proxy Endpoint response
content:
application/json:
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/proxy_endpoints/{uuid}:
delete:
tags:
- Zero Trust Gateway Proxy Endpoints
summary: Delete Proxy Endpoint
description: Delete a Zero Trust Gateway Proxy Endpoint.
operationId: zero-trust-gateway-proxy-endpoints-delete-proxy-endpoint
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Proxy Endpoint response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/proxy-endpoints_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Proxy Endpoint response
content:
application/json:
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zero Trust Gateway Proxy Endpoints
summary: Proxy Endpoint Details
description: List Zero Trust Gateway Proxy Endpoints for an account.
operationId: zero-trust-gateway-proxy-endpoints-proxy-endpoint-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-identifier'
responses:
4xx:
description: Proxy Endpoint Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Proxy Endpoint Details response
content:
application/json:
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zero Trust Gateway Proxy Endpoints
summary: Update Proxy Endpoint
description: Update a new Zero Trust Gateway Proxy Endpoint.
operationId: zero-trust-gateway-proxy-endpoints-update-proxy-endpoint
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
ips:
$ref: '#/components/schemas/components-schemas-ips'
name:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-name'
subdomain:
$ref: '#/components/schemas/schemas-subdomain'
responses:
4xx:
description: Update Proxy Endpoint response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Proxy Endpoint response
content:
application/json:
schema:
$ref: '#/components/schemas/proxy-endpoints_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/rules:
get:
tags:
- Zero Trust Gateway Rules
summary: List Zero Trust Gateway Rules
description: List Zero Trust Gateway Rules for an account.
operationId: zero-trust-gateway-rules-list-zero-trust-gateway-rules
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-identifier'
responses:
4xx:
description: List Zero Trust Gateway Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Zero Trust Gateway Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zero Trust Gateway Rules
summary: Create Zero Trust Gateway Rule
description: Create a new Zero Trust Gateway Rule.
operationId: zero-trust-gateway-rules-create-zero-trust-gateway-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- action
properties:
action:
$ref: '#/components/schemas/rules_components-schemas-action-2'
description:
$ref: '#/components/schemas/rules_components-schemas-description-2'
device_posture:
$ref: '#/components/schemas/device_posture'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled-3'
filters:
$ref: '#/components/schemas/schemas-filters'
identity:
$ref: '#/components/schemas/identity'
name:
$ref: '#/components/schemas/rules_components-schemas-name-2'
precedence:
$ref: '#/components/schemas/schemas-precedence'
rule_settings:
$ref: '#/components/schemas/rule-settings'
traffic:
$ref: '#/components/schemas/traffic'
responses:
4xx:
description: Create Zero Trust Gateway Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zero Trust Gateway Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/accounts/{identifier}/gateway/rules/{uuid}:
delete:
tags:
- Zero Trust Gateway Rules
summary: Delete Zero Trust Gateway Rule
description: Delete a Zero Trust Gateway Rule.
operationId: zero-trust-gateway-rules-delete-zero-trust-gateway-rule
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Zero Trust Gateway Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Zero Trust Gateway Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zero Trust Gateway Rules
summary: Zero Trust Gateway Rule Details
description: Fetch a single Zero Trust Gateway Rule.
operationId: zero-trust-gateway-rules-zero-trust-gateway-rule-details
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-identifier'
responses:
4xx:
description: Zero Trust Gateway Rule Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zero Trust Gateway Rule Details response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zero Trust Gateway Rules
summary: Update Zero Trust Gateway Rule
description: Update a configured Zero Trust Gateway Rule.
operationId: zero-trust-gateway-rules-update-zero-trust-gateway-rule
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- action
properties:
action:
$ref: '#/components/schemas/rules_components-schemas-action-2'
description:
$ref: '#/components/schemas/rules_components-schemas-description-2'
device_posture:
$ref: '#/components/schemas/device_posture'
enabled:
$ref: '#/components/schemas/rules_components-schemas-enabled-3'
filters:
$ref: '#/components/schemas/schemas-filters'
identity:
$ref: '#/components/schemas/identity'
name:
$ref: '#/components/schemas/rules_components-schemas-name-2'
precedence:
$ref: '#/components/schemas/schemas-precedence'
rule_settings:
$ref: '#/components/schemas/rule-settings'
traffic:
$ref: '#/components/schemas/traffic'
responses:
4xx:
description: Update Zero Trust Gateway Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Zero Trust Gateway Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/certificates:
get:
tags:
- Origin CA
summary: List Certificates
description: List all existing Origin CA certificates for a given zone. Use
your Origin CA Key as your User Service Key when calling this endpoint ([see
above](#requests)).
operationId: origin-ca-list-certificates
responses:
4xx:
description: List Certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-certificate_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-certificate_response_collection'
security:
- user_service_key: []
- api_token: []
post:
tags:
- Origin CA
summary: Create Certificate
description: Create an Origin CA certificate. Use your Origin CA Key as your
User Service Key when calling this endpoint ([see above](#requests)).
operationId: origin-ca-create-certificate
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
csr:
$ref: '#/components/schemas/csr'
hostnames:
$ref: '#/components/schemas/hostnames'
request_type:
$ref: '#/components/schemas/request_type'
requested_validity:
$ref: '#/components/schemas/requested_validity'
responses:
4xx:
description: Create Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-certificate_response_single'
security:
- user_service_key: []
- api_token: []
/certificates/{identifier}:
delete:
tags:
- Origin CA
summary: Revoke Certificate
description: Revoke an existing Origin CA certificate by its serial number.
Use your Origin CA Key as your User Service Key when calling this endpoint
([see above](#requests)).
operationId: origin-ca-revoke-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/certificates_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Revoke Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single_id'
security:
- user_service_key: []
- api_token: []
get:
tags:
- Origin CA
summary: Get Certificate
description: Get an existing Origin CA certificate by its serial number. Use
your Origin CA Key as your User Service Key when calling this endpoint ([see
above](#requests)).
operationId: origin-ca-get-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/certificates_components-schemas-identifier'
responses:
4xx:
description: Get Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-certificate_response_single'
security:
- user_service_key: []
- api_token: []
/ips:
get:
tags:
- Cloudflare IPs
summary: Cloudflare IP Details
description: Get Cloudflare IPs.
operationId: cloudflare-i-ps-cloudflare-ip-details
responses:
4xx:
description: Cloudflare IP Details response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/ips'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Cloudflare IP Details response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/ips'
security:
- api_email: []
api_key: []
- api_token: []
/memberships:
get:
tags:
- User's Account Memberships
summary: List Memberships
description: List memberships of accounts the user can access.
operationId: user'-s-account-memberships-list-memberships
responses:
4xx:
description: List Memberships response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_membership_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Memberships response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_membership_response'
security:
- api_email: []
api_key: []
- api_token: []
/memberships/{identifier}:
delete:
tags:
- User's Account Memberships
summary: Delete Membership
description: Remove the associated member from an account.
operationId: user'-s-account-memberships-delete-membership
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/membership_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Membership response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/membership_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Membership response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/membership_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- User's Account Memberships
summary: Membership Details
description: Get a specific membership.
operationId: user'-s-account-memberships-membership-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/membership_components-schemas-identifier'
responses:
4xx:
description: Membership Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_membership_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Membership Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_membership_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- User's Account Memberships
summary: Update Membership
description: Accept or reject this account invitation.
operationId: user'-s-account-memberships-update-membership
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/membership_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- status
properties:
status:
description: Whether to accept or reject this account invitation.
enum:
- accepted
- rejected
example: accepted
responses:
4xx:
description: Update Membership response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_membership_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Membership response
content:
application/json:
schema:
$ref: '#/components/schemas/single_membership_response'
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{identifier}:
get:
tags:
- Organizations (Deprecated)
summary: Organization Details
description: Get information about a specific organization that you are a member
of.
operationId: organizations-(-deprecated)-organization-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Organization Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_organization_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Organization Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_organization_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Organizations (Deprecated)
summary: Edit Organization
description: Update an existing Organization.
operationId: organizations-(-deprecated)-edit-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
$ref: '#/components/schemas/schemas-name'
responses:
4xx:
description: Edit Organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_organization_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Organization response
content:
application/json:
schema:
$ref: '#/components/schemas/single_organization_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/audit_logs:
get:
tags:
- Audit Logs
summary: Get organization audit logs
description: Gets a list of audit logs for an organization. The list can be
filtered by who made the change, which zone was the change made on, and the
timeframe of the change.
operationId: audit-logs-get-organization-audit-logs
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get organization audit logs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/audit_logs_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get organization audit logs response
content:
application/json:
schema:
$ref: '#/components/schemas/audit_logs_response_collection'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/invites:
get:
tags:
- Organization Invites
summary: List Invitations
description: List all invitations associated with an organization.
operationId: organization-invites-list-invitations
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Invitations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Invitations response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_invite_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Organization Invites
summary: Create Invitation
description: Invite a User to become a Member of an Organization.
operationId: organization-invites-create-invitation
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- invited_member_email
- roles
properties:
auto_accept:
type: boolean
description: When present and set to true, allows for the invited
user to be automatically accepted to the organization. No invitation
is sent.
default: false
example: true
invited_member_email:
$ref: '#/components/schemas/invited_member_email'
roles:
type: array
description: Array of Roles associated with the invited user.
example:
- id: 5a7805061c76ada191ed06f989cc3dac
- id: 9a7806061c88ada191ed06f989cc3dac
items:
type: object
required:
- id
properties:
description:
$ref: '#/components/schemas/description'
id:
$ref: '#/components/schemas/role_components-schemas-identifier'
name:
$ref: '#/components/schemas/components-schemas-name'
permissions:
$ref: '#/components/schemas/schemas-permissions'
responses:
4xx:
description: Create Invitation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Invitation response
content:
application/json:
schema:
$ref: '#/components/schemas/single_invite_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/invites/{identifier}:
delete:
tags:
- Organization Invites
summary: Cancel Invitation
description: Cancel an existing invitation.
operationId: organization-invites-cancel-invitation
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/invite_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Cancel Invitation response failure
content:
application/json:
schema:
allOf:
- properties:
id:
$ref: '#/components/schemas/invite_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Cancel Invitation response
content:
application/json:
schema:
properties:
id:
$ref: '#/components/schemas/invite_components-schemas-identifier'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Organization Invites
summary: Invitation Details
description: Get the details of an invitation.
operationId: organization-invites-invitation-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/invite_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Invitation Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Invitation Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_invite_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Organization Invites
summary: Edit Invitation Roles
description: Change the Roles of a Pending Invite.
operationId: organization-invites-edit-invitation-roles
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/invite_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
roles:
type: array
description: Array of Roles associated with the invited user.
items:
$ref: '#/components/schemas/role_components-schemas-identifier'
responses:
4xx:
description: Edit Invitation Roles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Invitation Roles response
content:
application/json:
schema:
$ref: '#/components/schemas/single_invite_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/members:
get:
tags:
- Organization Members
summary: List Members
description: List all members of a organization.
operationId: organization-members-list-members
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
responses:
4xx:
description: List Members response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_member_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Members response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_member_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/members/{identifier}:
delete:
tags:
- Organization Members
summary: Remove Member
description: Remove a member from an organization.
operationId: organization-members-remove-member
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Remove Member response failure
content:
application/json:
schema:
allOf:
- properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Remove Member response
content:
application/json:
schema:
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Organization Members
summary: Member Details
description: Get information about a specific member of an organization.
operationId: organization-members-member-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
responses:
4xx:
description: Member Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_member_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Member Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_member_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Organization Members
summary: Edit Member Roles
description: Change the Roles of an Organization's Member.
operationId: organization-members-edit-member-roles
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
roles:
type: array
description: Array of Roles associated with this Member.
items:
$ref: '#/components/schemas/role_components-schemas-identifier'
responses:
4xx:
description: Edit Member Roles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_member_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Member Roles response
content:
application/json:
schema:
$ref: '#/components/schemas/single_member_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/railguns:
get:
tags:
- Organization Railgun
summary: List Railguns
description: List, search, sort and filter your Railguns.
operationId: organization-railgun-list-railguns
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Railguns response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Railguns response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_collection'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Organization Railgun
summary: Create Railgun
operationId: organization-railgun-create-railgun
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
$ref: '#/components/schemas/railgun_components-schemas-name'
responses:
4xx:
description: Create Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/railguns/{identifier}:
delete:
tags:
- Organization Railgun
summary: Delete Railgun
description: Disable and delete a Railgun. This will immediately disable the
Railgun for any connected zones.
operationId: organization-railgun-delete-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single_id'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Organization Railgun
summary: Railgun details
operationId: organization-railgun-railgun-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Railgun details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Railgun details response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Organization Railgun
summary: Enable or disable a Railgun
description: Enable or disable a Railgun for all zones connected to it.
operationId: organization-railgun-enable-or-disable-a-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- enabled
properties:
enabled:
$ref: '#/components/schemas/railgun_components-schemas-enabled'
responses:
4xx:
description: Enable or disable a Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable or disable a Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/railguns/{identifier}/zones:
get:
tags:
- Organization Railgun
summary: Get Railgun zones
description: Lists the zones that are currently using this Railgun.
operationId: organization-railgun-get-railgun-zones
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Railgun zones response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-zone'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Railgun zones response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-zone'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/roles:
get:
tags:
- Organization Roles
summary: List Roles
description: Get all available roles for an organization.
operationId: organization-roles-list-roles
parameters:
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
responses:
4xx:
description: List Roles response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_role_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Roles response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_role_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/organizations/{organization_identifier}/roles/{identifier}:
get:
tags:
- Organization Roles
summary: Role Details
description: Get information about a specific role for an organization.
operationId: organization-roles-role-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/role_components-schemas-identifier'
- name: organization_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organization_components-schemas-identifier'
responses:
4xx:
description: Role Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_role_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Role Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_role_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/annotations/outages:
get:
tags:
- Radar Annotations
summary: Get outages annotations
operationId: radar_get_AnnotationsOutages
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: offset
in: query
description: Number of objects to skip before grabbing results.
schema:
type: integer
description: Number of objects to skip before grabbing results.
default: 0
example: 0
- name: dateRange
in: query
description: Shorthand date ranges for the last X days - use when you don't
need specific start and end dates.
schema:
type: string
description: Shorthand date ranges for the last X days - use when you don't
need specific start and end dates.
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
example: 7d
- name: dateStart
in: query
description: Start of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: End of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
asns:
type: array
items:
type: integer
example: 189
dataSource:
type: string
example: ALL
description:
type: string
example: example
endDate:
type: string
example: "2022-09-08T10:00:28Z"
eventType:
type: string
example: OUTAGE
linkedUrl:
type: string
example: http://example.com
locations:
type: array
items:
type: string
example: MX
outage:
type: object
properties:
outageCause:
type: string
example: CABLE_CUT
outageType:
type: string
example: NATIONWIDE
scope:
type: string
example: Colima, Michoacán, México
startDate:
type: string
example: "2022-09-06T10:00:28Z"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/annotations/outages/locations:
get:
tags:
- Radar Annotations
summary: Get top outages annotations
operationId: radar_get_AnnotationsOutagesTop
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: dateRange
in: query
description: Shorthand date ranges for the last X days - use when you don't
need specific start and end dates.
schema:
type: string
description: Shorthand date ranges for the last X days - use when you don't
need specific start and end dates.
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
example: 7d
- name: dateStart
in: query
description: Start of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: End of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: PT
clientCountryName:
type: string
example: Portugal
value:
type: string
example: "5"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer3/summary:
get:
tags:
- Radar Attacks
summary: Get a summary of layer 3 attacks
description: Percentage distribution of network protocols in layer 3/4 attacks.
operationId: radar_get_AttacksLayer3Summary
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
summary_0:
type: object
properties:
gre:
type: string
example: "0.9"
icmp:
type: string
example: "0.1"
tcp:
type: string
example: "60"
udp:
type: string
example: "39"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer3/timeseries:
get:
tags:
- Radar Attacks
summary: Get layer 3 attacks time series
description: Get layer 3/4 attacks change over time. Values are normalized using
min-max by default, with the minimum set to 0. When asking for multiple time
series, you can also get the percentual relative change of the 1st/main series,
with respect to the 2nd/control series - for example, to get the relative
change of this week from the previous week, the 1st series would have a date
range of 7d, the 2nd, a date range of 7dControl, and the normalization would
be set to PERCENTAGE_CHANGE.
operationId: radar_get_AttacksLayer3Timeseries
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: attack
in: query
description: Array of L3/4 attack types.
schema:
type: array
items:
type: string
description: Array of L3/4 attack types.
enum:
- udp
- tcp
- icmp
- gre
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: normalization
in: query
description: Normalization method applied.
schema:
type: string
description: Normalization method applied.
enum:
- PERCENTAGE_CHANGE
- MIN0_MAX
example: MIN0_MAX
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
series:
type: object
properties:
timestamps:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
values:
type: array
items:
type: string
example: 0.56
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer3/timeseries_groups:
get:
tags:
- Radar Attacks
summary: Get layer 3 attacks by network protocol, over time
description: Get percentage of what type of network protocols are used in layer
3/4 attacks, over time.
operationId: radar_get_AttacksLayer3TimeseriesGroups
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
serie_0:
type: object
properties:
gre:
type: array
items:
type: string
example: "0.9"
icmp:
type: array
items:
type: string
example: "0.1"
tcp:
type: array
items:
type: string
example: "70"
timeseries:
type: array
items:
type: string
udp:
type: array
items:
type: string
example: "29"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/summary:
get:
tags:
- Radar Attacks
summary: Get a summary of layer 7 attacks
description: Percentage distribution of mitigation techniques in layer 7 attacks.
operationId: radar_get_AttacksLayer7Summary
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
summary_0:
type: object
properties:
gre:
type: string
example: "0.1"
icmp:
type: string
example: "0.9"
tcp:
type: string
example: "65"
udp:
type: string
example: "34"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/timeseries:
get:
tags:
- Radar Attacks
summary: Get attacks layer 7 time series
description: Get layer 7 attacks change over time. Values are normalized using
min-max by default, with the minimum set to 0. When asking for multiple time
series, you can also get the percentage relative change of the first/main
series, with respect to the second/control series - for example, to get the
relative change of this week from the previous week, the first series would
have a date range of `7d`, the second, a date range of `7dControl`, and the
normalization would be set to `PERCENTAGE_CHANGE`.
operationId: radar_get_AttacksLayer7Timeseries
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: attack
in: query
description: Array of L7 attack types.
schema:
type: array
items:
type: string
description: Array of L7 attack types.
enum:
- ddos
- waf
- bot_management
- access_rules
- ip_reputation
- api_shield
- data_loss_prevention
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: normalization
in: query
description: Normalization method applied.
schema:
type: string
description: Normalization method applied.
enum:
- PERCENTAGE_CHANGE
- MIN0_MAX
example: MIN0_MAX
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
series:
type: object
properties:
timestamps:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
values:
type: array
items:
type: string
example: 0.56
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/timeseries_groups:
get:
tags:
- Radar Attacks
summary: Get layer 7 attacks by mitigation technique, over time
description: Get percentage of what type of mitigation techniques are used to
block layer 7 attacks, over time.
operationId: radar_get_AttacksLayer7TimeseriesGroups
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
serie_0:
type: object
properties:
gre:
type: array
items:
type: string
example: "5"
icmp:
type: array
items:
type: string
example: "5"
tcp:
type: array
items:
type: string
example: "60"
timeseries:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
udp:
type: array
items:
type: string
example: "30"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/top/ases/origin:
get:
tags:
- Radar Attacks
summary: Get layer 7 top origin ASes
description: Get the top origin ASes by layer 7 attacks. Values are a percentage
out of the total layer 7 attacks. The origin location is determined by the
client IP.
operationId: radar_get_AttacksLayer7TopOriginASes
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: location
in: query
description: Array of locations (alpha-2 country codes).
schema:
type: array
items:
type: string
description: Array of locations (alpha-2 country codes).
example: US
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
originAsn:
type: number
example: 16509
originAsnName:
type: string
example: AMAZON-02
rank:
type: string
example: "1"
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/top/attacks:
get:
tags:
- Radar Attacks
summary: Get layer 7 top attack pairs (origin and target locations)
description: Get the top attacks from origin to target location. Values are
a percentage out of the total layer 7 attacks (with billing country). The
attack magnitude can be defined by the number of mitigated requests or by
the number of zones affected. You can optionally limit the number of attacks
per origin/target location (useful if all the top attacks are from or to the
same location).
operationId: radar_get_AttacksLayer7TopAttacks
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: magnitude
in: query
description: Attack magnitude can be defined by total requests mitigated or
by total zones attacked.
schema:
type: string
description: Attack magnitude can be defined by total requests mitigated
or by total zones attacked.
enum:
- AFFECTED_ZONES
- MITIGATED_REQUESTS
example: mitigated_requests
- name: limitDirection
in: query
description: Array of attack origin/target location attack limits. Together
with `limitPerLocation`, limits how many objects will be fetched per origin/target
location.
schema:
type: array
items:
type: string
description: Array of attack origin/target location attack limits. Together
with `limitPerLocation`, limits how many objects will be fetched per
origin/target location.
enum:
- ORIGIN
- TARGET
example: origin
- name: limitPerLocation
in: query
description: Limit the number of attacks per origin/target (see `limitDirection`
parameter) location.
schema:
type: array
items:
type: integer
description: Limit the number of attacks per origin/target (see `limitDirection`
parameter) location.
default: 10
example: 10
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
originCountryAlpha2:
type: string
example: US
originCountryName:
type: string
example: United States
rank:
type: string
example: "1"
targetCountryAlpha2:
type: string
example: PT
targetCountryName:
type: string
example: Portugal
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/top/locations/origin:
get:
tags:
- Radar Attacks
summary: Get layer 7 top origin locations
description: Get the top origin locations of and by layer 7 attacks. Values
are a percentage out of the total layer 7 attacks. The origin location is
determined by the client IP.
operationId: radar_get_AttacksLayer7TopOriginLocations
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
originCountryAlpha2:
type: string
example: US
originCountryName:
type: string
example: United States
rank:
type: string
example: "1"
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/attacks/layer7/top/locations/target:
get:
tags:
- Radar Attacks
summary: Get layer 7 top target locations
description: Get the top target locations of and by layer 7 attacks. Values
are a percentage out of the total layer 7 attacks. The target location is
determined by the attacked zone's billing country, when available.
operationId: radar_get_AttacksLayer7TopTargetLocations
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
rank:
type: string
example: "1"
targetCountryAlpha2:
type: string
example: US
targetCountryName:
type: string
example: United States
value:
type: string
example: "0.73996"
security:
- api_email: []
api_key: []
- api_token: []
/radar/bgp/leaks/events:
get:
tags:
- Radar BGP
summary: Get BGP route leak events
description: Get the BGP route leak events.
operationId: radar_get_BGPRouteLeakEvents
parameters:
- name: page
in: query
description: Current page number, starting from 1
schema:
type: integer
description: Current page number, starting from 1
default: 1
- name: per_page
in: query
description: Number of entries per page
schema:
type: integer
description: Number of entries per page
default: 50
- name: leakAsn
in: query
description: The leaking AS of a route leak event
schema:
type: integer
description: The leaking AS of a route leak event
- name: involvedAsn
in: query
description: ASN that is causing or affected by a route leak event
schema:
type: integer
description: ASN that is causing or affected by a route leak event
- name: dateRange
in: query
description: For example, use `7d` to get route leak events happened within
this week.
schema:
type: string
description: For example, use `7d` to get route leak events happened within
this week.
enum:
- 1d
- 7d
- 14d
- 28d
default: 1d
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
data:
type: object
properties:
asn_info:
type: array
items:
type: object
properties:
asn:
type: integer
org_name:
type: string
events:
type: array
items:
type: object
properties:
detected_ts:
type: string
finished:
type: boolean
id:
type: integer
leak_asn:
type: integer
leak_count:
type: integer
leak_seg:
type: array
items:
type: integer
leak_type:
type: integer
max_ts:
type: string
min_ts:
type: string
origin_count:
type: integer
peer_count:
type: integer
prefix_count:
type: integer
result_info:
type: object
properties:
count:
type: integer
page:
type: integer
per_page:
type: integer
total_count:
type: integer
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/bgp/timeseries:
get:
tags:
- Radar BGP
summary: Get BGP time series
description: Gets BGP updates change over time. Raw values are returned. When
requesting updates of an autonomous system (AS), only BGP updates of type
announcement are returned.
operationId: radar_get_BgpTimeseries
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: prefix
in: query
description: Network prefix, IPv4 or IPv6.
schema:
type: string
description: Network prefix, IPv4 or IPv6.
example: 1.1.1.0/24
- name: updateType
in: query
description: Array of BGP update types.
schema:
type: array
items:
type: string
description: Array of BGP update types.
enum:
- ANNOUNCEMENT
- WITHDRAWAL
example: ANNOUNCEMENT
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
series:
type: object
properties:
timestamps:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
values:
type: array
items:
type: string
example: 0.56
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/bgp/top/ases:
get:
tags:
- Radar BGP
summary: Get top autonomous systems
description: Get the top autonomous systems (AS) by BGP updates (announcements
only). Values are a percentage out of the total updates.
operationId: radar_get_BGPTopASes
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: prefix
in: query
description: Array of BGP network prefixes.
schema:
type: array
items:
type: string
description: Array of BGP network prefixes.
example: 1.1.1.0/24
- name: updateType
in: query
description: Array of BGP update types.
schema:
type: array
items:
type: string
description: Array of BGP update types.
enum:
- ANNOUNCEMENT
- WITHDRAWAL
example: ANNOUNCEMENT
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
top_0:
type: array
items:
type: object
properties:
ASName:
type: string
example: Apple-Engineering
asn:
type: string
example: "714"
value:
type: string
description: Percentage of updates by this AS out of
the total updates by all autonomous systems.
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/bgp/top/prefixes:
get:
tags:
- Radar BGP
summary: Get top prefixes
description: Get the top network prefixes by BGP updates. Values are a percentage
out of the total BGP updates.
operationId: radar_get_BGPTopPrefixes
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: updateType
in: query
description: Array of BGP update types.
schema:
type: array
items:
type: string
description: Array of BGP update types.
enum:
- ANNOUNCEMENT
- WITHDRAWAL
example: ANNOUNCEMENT
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
top_0:
type: array
items:
type: object
properties:
prefix:
type: string
example: 2804:77cc:8000::/33
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/datasets:
get:
tags:
- Radar Datasets
summary: Get Datasets
description: Get a list of datasets.
operationId: radar_get_DatasetList
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: offset
in: query
description: Number of objects to skip before grabbing results.
schema:
type: integer
description: Number of objects to skip before grabbing results.
default: 0
example: 0
- name: datasetType
in: query
description: Dataset type.
schema:
type: string
description: Dataset type.
enum:
- RANKING_BUCKET
- REPORT
default: RANKING_BUCKET
example: RANKING_BUCKET
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
datasets:
type: array
items:
type: object
properties:
description:
type: string
example: This dataset contains a list of the op 20000
domains globally
id:
type: integer
example: 3
meta:
type: object
tags:
type: array
items:
type: string
example: global
title:
type: string
example: Top bucket 20000 domains
type:
type: string
example: RANKING_BUCKET
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/datasets/{alias}:
get:
tags:
- Radar Datasets
summary: Get Dataset csv Stream
description: Get the content of a dataset.
operationId: radar_get_DatasetStream
parameters:
- name: alias
in: path
description: Dataset alias or id
required: true
schema:
type: string
description: Dataset alias or id
example: year-in-review
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
security:
- api_email: []
api_key: []
- api_token: []
/radar/datasets/download:
post:
tags:
- Radar Datasets
summary: Get Dataset download url
description: Get a url to download a single dataset.
operationId: radar_post_DatasetDownload
parameters:
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
requestBody:
content:
application/json:
schema:
type: object
properties:
datasetId:
type: integer
example: 3
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
dataset:
type: object
properties:
url:
type: string
example: https://example.com/download
security:
- api_email: []
api_key: []
- api_token: []
/radar/dns/top/ases:
get:
tags:
- Radar DNS
summary: Get top autonomous systems by DNS queries.
description: Get top autonomous systems by DNS queries made to Cloudflare's
public DNS resolver.
operationId: radar_get_DnsTopAses
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: domain
in: query
description: Array of domain names.
required: true
schema:
type: array
items:
type: string
description: Array of domain names.
example: google.com
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "174"
clientASName:
type: string
example: Cogent-174
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/dns/top/locations:
get:
tags:
- Radar DNS
summary: Get top locations by DNS queries
description: Get top locations by DNS queries made to Cloudflare's public DNS
resolver.
operationId: radar_get_DnsTopLocations
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: domain
in: query
description: Array of domain names.
required: true
schema:
type: array
items:
type: string
description: Array of domain names.
example: google.com
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: PT
clientCountryName:
type: string
example: Portugal
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/entities/asns:
get:
tags:
- Radar Entities
summary: Get autonomous systems
description: Gets a list of autonomous systems (AS).
operationId: radar_get_ASNsList
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: offset
in: query
description: Number of objects to skip before grabbing results.
schema:
type: integer
description: Number of objects to skip before grabbing results.
default: 0
example: 0
- name: asn
in: query
description: Comma separated list of ASNs.
schema:
type: string
description: Comma separated list of ASNs.
example: 174,7922
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
ases:
type: array
items:
type: object
properties:
aka:
type: string
asn:
type: integer
example: 714
name:
type: string
example: Apple Inc.
nameLong:
type: string
website:
type: string
example: https://www.apple.com/support/systemstatus/
security:
- api_email: []
api_key: []
- api_token: []
/radar/entities/asns/{asn}:
get:
tags:
- Radar Entities
summary: Get autonomous system (AS) by ID
description: Get the requested autonomous system information. A confidence level
below `5` indicates a low level of confidence in the traffic data - normally
this happens because Cloudflare has a small amount of traffic from/to this
AS).
operationId: radar_get_ASNId
parameters:
- name: asn
in: path
description: Autonomous System Number (ASN).
required: true
schema:
type: integer
description: Autonomous System Number (ASN).
example: 3
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
asn:
type: object
properties:
aka:
type: string
asn:
type: integer
example: 714
confidenceLevel:
type: integer
example: 5
country:
type: string
name:
type: string
example: Apple Inc.
nameLong:
type: string
related:
type: array
items:
type: object
properties:
aka:
type: string
example: ""
asn:
type: integer
example: 174
name:
type: string
example: Cogent-174
website:
type: string
example: https://www.apple.com/support/systemstatus/
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/entities/asns/ip:
get:
tags:
- Radar Entities
summary: Get autonomous system information by IP address
operationId: radar_get_ASNIp
parameters:
- name: ip
in: query
description: IP address.
required: true
schema:
type: string
description: IP address.
example: 1.1.1.1
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
asn:
type: object
properties:
aka:
type: string
asn:
type: integer
example: 714
country:
type: string
name:
type: string
example: Apple Inc.
nameLong:
type: string
related:
type: array
items:
type: object
properties:
aka:
type: string
asn:
type: integer
name:
type: string
website:
type: string
example: https://www.apple.com/support/systemstatus/
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/entities/locations:
get:
tags:
- Radar Entities
summary: Get locations
description: Get a list of locations.
operationId: radar_get_LocationsList
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: offset
in: query
description: Number of objects to skip before grabbing results.
schema:
type: integer
description: Number of objects to skip before grabbing results.
default: 0
example: 0
- name: location
in: query
description: Comma separated list of locations.
schema:
type: string
description: Comma separated list of locations.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
locations:
type: array
items:
type: object
properties:
alpha2:
type: string
example: AF
latitude:
type: string
example: 33.939116
longitude:
type: string
example: 67.709953
name:
type: string
example: Afghanistan
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/entities/locations/{location}:
get:
tags:
- Radar Entities
summary: Get location
description: Get the requested location information. A confidence level below
`5` indicates a low level of confidence in the traffic data - normally this
happens because Cloudflare has a small amount of traffic from/to this location).
operationId: radar_get_LocationsOne
parameters:
- name: location
in: path
description: Alpha-2 country code.
required: true
schema:
type: string
description: Alpha-2 country code.
example: US
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
location:
type: object
properties:
alpha2:
type: string
example: AF
confidenceLvel:
type: integer
example: 5
latitude:
type: string
example: 33.939116
longitude:
type: string
example: 67.709953
name:
type: string
example: Afghanistan
region:
type: string
example: Middle East
subregion:
type: string
example: Southern Asia
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/bot_class:
get:
tags:
- Radar Http
summary: Get a summary of bot classes
description: Percentage distribution of traffic classified as automated or human.
operationId: radar_get_SummaryBotClass
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
bot:
type: string
example: "35"
human:
type: string
example: "65"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/device_type:
get:
tags:
- Radar Http
summary: Get a summary of device types
description: Percentage distribution of traffic per device type.
operationId: radar_get_SummaryDeviceType
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
desktop:
type: string
example: "65"
mobile:
type: string
example: "30"
other:
type: string
example: "5"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/http_protocol:
get:
tags:
- Radar Http
summary: Get a summary of HTTP protocols
description: Percentage distribution of traffic per HTTP protocol.
operationId: radar_get_SummaryHttpProtocol
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
http:
type: string
example: "99"
https:
type: string
example: "1"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/http_version:
get:
tags:
- Radar Http
summary: Get a summary of HTTP versions
description: Percentage distribution of traffic per HTTP protocol version.
operationId: radar_get_SummaryHttpVersion
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
HTTP/1.x:
type: string
example: "1"
HTTP/2:
type: string
example: "39"
HTTP/3:
type: string
example: "60"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/ip_version:
get:
tags:
- Radar Http
summary: Get a summary of IP versions
description: Percentage distribution of traffic per IP protocol version.
operationId: radar_get_SummaryIpVersion
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
IPv4:
type: string
example: "65"
IPv6:
type: string
example: "35"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/summary/tls_version:
get:
tags:
- Radar Http
summary: Get a summary of TLS versions
description: Percentage distribution of traffic per TLS protocol version.
operationId: radar_get_SummaryTLSVersion
parameters:
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
summary_0:
type: object
properties:
TLS 1.0:
type: string
example: "0.5"
TLS 1.1:
type: string
example: "0.5"
TLS 1.2:
type: string
example: "60"
TLS 1.3:
type: string
example: "10"
TLS QUIC:
type: string
example: "29"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/bot_class:
get:
tags:
- Radar Http
summary: Get time series of bot classes
description: Percentage distribution of traffic classified as automated or human
over time.
operationId: radar_get_TimeseriesBotClass
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
bot:
type: array
items:
type: string
human:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/browser:
get:
tags:
- Radar Http
summary: Get time series of user agents
description: Percentage distribution of traffic of the top user agents in the
selected time range, over time.
operationId: radar_get_TimeseriesBrowsers
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: limitPerGroup
in: query
description: Limit the number of objects (eg browsers) to the top items over
the time range.
schema:
type: integer
description: Limit the number of objects (eg browsers) to the top items
over the time range.
default: 10
example: 2
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/browser_family:
get:
tags:
- Radar Http
summary: Get time series of user agents aggregated in families
description: Percentage distribution of traffic of the top user agents aggregated
in families in the selected time range, over time.
operationId: radar_get_TimeseriesBrowserFamilies
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/device_type:
get:
tags:
- Radar Http
summary: Get time series of device types
description: Percentage distribution of traffic per device type over time.
operationId: radar_get_TimeseriesDeviceType
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
desktop:
type: array
items:
type: string
mobile:
type: array
items:
type: string
other:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/http_protocol:
get:
tags:
- Radar Http
summary: Get time series of HTTP protocols
description: Percentage distribution of traffic per HTTP protocol over time.
operationId: radar_get_TimeseriesHttpProtocol
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
http:
type: array
items:
type: string
https:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/http_version:
get:
tags:
- Radar Http
summary: Get time series of HTTP versions
description: Percentage distribution of traffic per HTTP protocol version over
time.
operationId: radar_get_TimeseriesHttpVersion
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
HTTP/1.x:
type: array
items:
type: string
HTTP/2:
type: array
items:
type: string
HTTP/3:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/ip_version:
get:
tags:
- Radar Http
summary: Get time series of IP versions
description: Percentage distribution of traffic per IP protocol version over
time.
operationId: radar_get_TimeseriesIpVersion
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
IPv4:
type: array
items:
type: string
IPv6:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/timeseries/tls_version:
get:
tags:
- Radar Http
summary: Get time series of TLS versions
description: Percentage distribution of traffic per TLS protocol version over
time.
operationId: radar_get_TimeseriesTLSVersion
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
serie_0:
type: object
properties:
TLS 1.0:
type: array
items:
type: string
TLS 1.1:
type: array
items:
type: string
TLS 1.2:
type: array
items:
type: string
TLS 1.3:
type: array
items:
type: string
TLS QUIC:
type: array
items:
type: string
timestamps:
type: array
items:
type: string
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases:
get:
tags:
- Radar Http
summary: Get top autonomous systems by HTTP requests
description: Get the top autonomous systems (AS) by HTTP traffic. Values are
a percentage out of the total traffic.
operationId: radar_get_HttpTopASes
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/bot_class/{bot_class}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by bot class
description: Get the top autonomous systems (AS), by HTTP traffic, of the requested
bot class. These two categories use Cloudflare's bot score - refer to [Bot
Scores](https://developers.cloudflare.com/bots/concepts/bot-score) for more
information. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByBotClass
parameters:
- name: bot_class
in: path
description: Bot class.
required: true
schema:
type: string
description: Bot class.
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/device_type/{device_type}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by device type
description: Get the top autonomous systems (AS), by HTTP traffic, of the requested
device type. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByDeviceType
parameters:
- name: device_type
in: path
description: Device type.
required: true
schema:
type: string
description: Device type.
enum:
- DESKTOP
- MOBILE
- OTHER
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/http_protocol/{http_protocol}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by HTTP protocol
description: Get the top autonomous systems (AS), by HTTP traffic, of the requested
HTTP protocol. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByHTTPProtocol
parameters:
- name: http_protocol
in: path
description: HTTP Protocol.
required: true
schema:
type: string
description: HTTP Protocol.
enum:
- HTTP
- HTTPS
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/http_version/{http_version}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by HTTP version
description: Get the top autonomous systems (AS), by HTTP traffic, of the requested
HTTP protocol version. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByHTTPVersion
parameters:
- name: http_version
in: path
description: HTTP version.
required: true
schema:
type: string
description: HTTP version.
enum:
- HTTPv1
- HTTPv2
- HTTPv3
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/ip_version/{ip_version}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by IP version
description: Get the top autonomous systems, by HTTP traffic, of the requested
IP protocol version. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByIpVersion
parameters:
- name: ip_version
in: path
description: IP version.
required: true
schema:
type: string
description: IP version.
enum:
- IPv4
- IPv6
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/ases/tls_version/{tls_version}:
get:
tags:
- Radar Http
summary: Get top autonomous systems by TLS version
description: Get the top autonomous systems (AS), by HTTP traffic, of the requested
TLS protocol version. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopASesByTLSVersion
parameters:
- name: tls_version
in: path
description: TLS version.
required: true
schema:
type: string
description: TLS version.
enum:
- TLSv1_0
- TLSv1_1
- TLSv1_2
- TLSv1_3
- TLSvQUIC
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientASN:
type: string
example: "3243"
clientASName:
type: string
example: MEO
value:
type: string
example: "3"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/browser_families:
get:
tags:
- Radar Http
summary: Get top user agents aggregated in families by HTTP requests
description: Get the top user agents aggregated in families by HTTP traffic.
Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopBrowserFamilies
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
:
type: string
value:
type: string
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/browsers:
get:
tags:
- Radar Http
summary: Get top user agents by HTTP requests
description: Get the top user agents by HTTP traffic. Values are a percentage
out of the total traffic.
operationId: radar_get_HttpTopBrowsers
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
:
type: string
value:
type: string
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations:
get:
tags:
- Radar Http
summary: Get top locations by HTTP requests
description: Get the top locations by HTTP traffic. Values are a percentage
out of the total traffic.
operationId: radar_get_HttpTopLocations
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/bot_class/{bot_class}:
get:
tags:
- Radar Http
summary: Get top locations by bot class
description: Get the top locations, by HTTP traffic, of the requested bot class.
These two categories use Cloudflare's bot score - refer to [Bot scores])https://developers.cloudflare.com/bots/concepts/bot-score).
Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByBotClass
parameters:
- name: bot_class
in: path
description: Bot class.
required: true
schema:
type: string
description: Bot class.
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/device_type/{device_type}:
get:
tags:
- Radar Http
summary: Get top locations by device type
description: Get the top locations, by HTTP traffic, of the requested device
type. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByDeviceType
parameters:
- name: device_type
in: path
description: Device type.
required: true
schema:
type: string
description: Device type.
enum:
- DESKTOP
- MOBILE
- OTHER
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/http_protocol/{http_protocol}:
get:
tags:
- Radar Http
summary: Get top locations by HTTP protocol
description: Get the top locations, by HTTP traffic, of the requested HTTP protocol.
Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByHTTPProtocol
parameters:
- name: http_protocol
in: path
description: HTTP Protocol.
required: true
schema:
type: string
description: HTTP Protocol.
enum:
- HTTP
- HTTPS
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/http_version/{http_version}:
get:
tags:
- Radar Http
summary: Get top locations by HTTP version
description: Get the top locations, by HTTP traffic, of the requested HTTP protocol.
Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByHTTPVersion
parameters:
- name: http_version
in: path
description: HTTP version.
required: true
schema:
type: string
description: HTTP version.
enum:
- HTTPv1
- HTTPv2
- HTTPv3
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/ip_version/{ip_version}:
get:
tags:
- Radar Http
summary: Get top locations by IP version
description: Get the top locations, by HTTP traffic, of the requested IP protocol
version. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByIpVersion
parameters:
- name: ip_version
in: path
description: IP version.
required: true
schema:
type: string
description: IP version.
enum:
- IPv4
- IPv6
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/http/top/locations/tls_version/{tls_version}:
get:
tags:
- Radar Http
summary: Get top locations by TLS version
description: Get the top locations, by HTTP traffic, of the requested TLS protocol
version. Values are a percentage out of the total traffic.
operationId: radar_get_HttpTopLocationsByTLSVersion
parameters:
- name: tls_version
in: path
description: TLS version.
required: true
schema:
type: string
description: TLS version.
enum:
- TLSv1_0
- TLSv1_1
- TLSv1_2
- TLSv1_3
- TLSvQUIC
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: botClass
in: query
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
schema:
type: array
items:
type: string
description: Filter for bot class. Refer to [Bot Groupings](https://developers.cloudflare.com/bots/concepts/bot-score#bot-groupings)
enum:
- LIKELY_AUTOMATED
- LIKELY_HUMAN
example: LIKELY_AUTOMATED
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "65"
success:
type: boolean
example: true
"404":
description: Not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Not Found
security:
- api_email: []
api_key: []
- api_token: []
/radar/netflows/timeseries:
get:
tags:
- Radar Netflows
summary: Get NetFlow time series
description: Get network traffic change over time. Values are normalized using
min-max by default, with the minimum set to 0. When asking for multiple time
series, you can also get the percentage relative change of the first/main
series, with respect to the second/control series - for example, to get the
relative change of this week from the previous week, the first series would
have a date range of `7d`, the second, a date range of `7dControl`, and the
normalization would be set to `PERCENTAGE_CHANGE`.
operationId: radar_get_Timeseries
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: product
in: query
description: Array of network traffic product types.
schema:
type: array
items:
type: string
description: Array of network traffic product types.
enum:
- http
- all
example: all
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: normalization
in: query
description: Normalization method applied.
schema:
type: string
description: Normalization method applied.
enum:
- PERCENTAGE_CHANGE
- MIN0_MAX
example: MIN0_MAX
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
aggInterval:
type: string
example: 1h
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
example: ALL
description:
type: string
example: Cable cut in Tonga
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
example: OUTAGE
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
lastUpdated:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
series:
type: object
properties:
timestamps:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
values:
type: array
items:
type: string
example: 0.56
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/netflows/top/ases:
get:
tags:
- Radar Netflows
summary: Get top autonomous systems
description: Get the top autonomous systems (AS) by network traffic. Values
are a percentage out of the total network traffic.
operationId: radar_get_NetflowsTopASes
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
clientASN:
type: number
example: 16509
clientASName:
type: string
example: AMAZON-02
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/netflows/top/locations:
get:
tags:
- Radar Netflows
summary: Get top locations
description: Get the top locations by network traffic. Values are a percentage
out of the total network traffic.
operationId: radar_get_NetflowsTopLocations
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
top_0:
type: array
items:
type: object
properties:
clientCountryAlpha2:
type: string
example: US
clientCountryName:
type: string
example: United States
value:
type: string
example: "0.73996"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/ranking/timeseries:
get:
tags:
- Radar Ranking
summary: Get Domains Rank time series
description: Gets Domains Rank updates change over time. Raw values are returned.
operationId: radar_get_RankingTimeseries
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: location
in: query
description: Array of locations (alpha-2 country codes).
schema:
type: array
items:
type: string
description: Array of locations (alpha-2 country codes).
example: US
- name: domains
in: query
description: Array of comma separated list of domains names.
schema:
type: array
items:
type: string
description: Array of comma separated list of domains names.
example: google.com,facebook.com
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
description: Adjusted end of date range.
example: "2022-09-17T10:22:57.555Z"
startTime:
type: string
format: date-time
description: Adjusted start of date range.
example: "2022-09-16T10:22:57.555Z"
serie_0:
type: object
properties:
:
type: array
items:
type: integer
example: 2
timestamps:
type: array
items:
type: string
example: "2022-09-02"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/ranking/top:
get:
tags:
- Radar Ranking
summary: Get Domains Rank top
description: Gets Top Domains Rank globally or by country.
operationId: radar_get_RankingTop
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: location
in: query
description: Array of locations (alpha-2 country codes).
schema:
type: array
items:
type: string
description: Array of locations (alpha-2 country codes).
example: US
- name: date
in: query
description: Array of dates to filter the ranking.
schema:
type: array
items:
type: string
format: date
description: Array of dates to filter the ranking.
example: "2022-09-19"
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
top_0:
type: object
properties:
date:
type: string
example: "2022-09-19"
top_0:
type: array
items:
type: object
properties:
domain:
type: string
example: google.com
rank:
type: integer
example: 1
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/search/global:
get:
tags:
- Radar Search
summary: Search for locations, autonomous systems (AS) and reports
description: Lets you search for locations, autonomous systems (AS) and reports.
operationId: radar_get_SearchGlobal
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: query
in: query
description: Search for locations, AS and reports
required: true
schema:
type: string
description: Search for locations, AS and reports
example: United
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: array
items:
type: object
properties:
code:
type: string
example: "13335"
name:
type: string
example: Cloudflare
type:
type: string
example: asn
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/specialevents:
get:
tags:
- Radar Special Events
summary: List Special Events
description: Get a list of Special Events.
operationId: radar_get_SpecialEventsList
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: offset
in: query
description: Number of objects to skip before grabbing results.
schema:
type: integer
description: Number of objects to skip before grabbing results.
default: 0
example: 0
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
specialEvents:
type: array
items:
type: object
properties:
alias:
type: string
example: euro2020
categories:
type: array
items:
type: object
properties:
categoryAlias:
type: string
example: streaming
location:
type: string
example: GLOBAL
description:
type: string
example: The 2020 UEFA European Football Championship
id:
type: integer
example: 1
title:
type: string
example: Euro2020
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/specialevents/{eventAlias}:
get:
tags:
- Radar Special Events
summary: Get a Single Special Events
description: Get a single Special Event.
operationId: radar_get_SpecialEventsGet
parameters:
- name: eventAlias
in: path
description: Special Event alias
required: true
schema:
type: string
description: Special Event alias
example: eurovision-2022
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
specialEvent:
type: object
properties:
alias:
type: string
example: euro2020
categories:
type: array
items:
type: object
properties:
categoryAlias:
type: string
example: streaming
location:
type: string
example: GLOBAL
description:
type: string
example: The 2020 UEFA European Football Championship
id:
type: integer
example: 1
title:
type: string
example: Euro2020
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/specialevents/{eventAlias}/{categoryAlias}:
get:
tags:
- Radar Special Events
summary: Get Special Events time series
operationId: radar_get_TimeseriesSpecialEvents
parameters:
- name: aggInterval
in: query
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
schema:
type: string
description: Aggregation interval results should be returned in (for example,
in 15 minutes or 1 hour intervals).
enum:
- 15m
- 1h
- 1d
example: 1h
- name: name
in: query
description: Name that will be used to name the series in response.
schema:
type: string
description: Name that will be used to name the series in response.
example: main_series
- name: dateStart
in: query
description: Start of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: End of the date range (inclusive).
schema:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: location
in: query
description: Location Alpha2 code.
schema:
type: string
description: Location Alpha2 code.
example: US
- name: eventAlias
in: path
description: Special Event alias
required: true
schema:
type: string
description: Special Event alias
example: eurovision-2022
- name: categoryAlias
in: path
description: Special Event Category alias
required: true
schema:
type: string
description: Special Event Category alias
example: videos
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
serie_0:
type: object
properties:
timestamps:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
values:
type: array
items:
type: string
example: 0.56
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/verified_bots/top/bots:
get:
tags:
- Radar Verified Bots
summary: Get top verified bots by HTTP requests
description: Get top verified bots by HTTP requests, with owner and category.
operationId: radar_get_HttpTopVerifiedBots
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
botCategory:
type: string
example: Search Engine Crawler
botName:
type: string
example: GoogleBot
botOwner:
type: string
example: Google
value:
type: string
example: "29.034407"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/radar/verified_bots/top/categories:
get:
tags:
- Radar Verified Bots
summary: Get top verified bot categories by HTTP requests
description: Get top verified bot categories by HTTP requests, along with their
corresponding percentage, over the total verified bot HTTP requests.
operationId: radar_get_HttpTopVerifiedBotCategories
parameters:
- name: limit
in: query
description: Limit the number of objects in the response.
schema:
type: integer
description: Limit the number of objects in the response.
default: 5
example: 5
- name: name
in: query
description: Array of names that will be used to name the series in responses.
schema:
type: array
items:
type: string
description: Array of names that will be used to name the series in responses.
example: main_series
- name: dateRange
in: query
description: For example, use `7d` and `7dControl` to compare this week with
the previous week. Use this parameter or set specific start and end dates
(`dateStart` and `dateEnd` parameters).
schema:
type: array
items:
type: string
description: For example, use `7d` and `7dControl` to compare this week
with the previous week. Use this parameter or set specific start and
end dates (`dateStart` and `dateEnd` parameters).
enum:
- 1d
- 7d
- 14d
- 28d
- 1dControl
- 7dControl
- 14dControl
- 28dControl
- name: dateStart
in: query
description: Array of datetimes to filter the start of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: dateEnd
in: query
description: Array of datetimes to filter the end of a series.
schema:
type: array
items:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
- name: asn
in: query
description: Array of comma separated list of ASNs, start with `-` to exclude
from results. For example, `[-174, 3356]` excludes results from AS174, but
includes results from AS3356.
schema:
type: array
items:
type: string
description: Array of comma separated list of ASNs, start with `-` to
exclude from results. For example, `[-174, 3356]` excludes results from
AS174, but includes results from AS3356.
example: "15169"
- name: location
in: query
description: Array of comma separated list of locations (alpha-2 country codes).
Start with `-` to exclude from results. For example, `[-US, PT]` excludes
results from the US, but includes results from PT.
schema:
type: array
items:
type: string
description: Array of comma separated list of locations (alpha-2 country
codes). Start with `-` to exclude from results. For example, `[-US,
PT]` excludes results from the US, but includes results from PT.
example: US,CA
- name: format
in: query
description: Format results are returned in.
schema:
type: string
description: Format results are returned in.
enum:
- json
- csv
example: json
responses:
"200":
description: Successful Response
content:
application/json:
schema:
type: object
properties:
result:
type: object
properties:
meta:
type: object
properties:
confidenceInfo:
type: object
properties:
annotations:
type: array
items:
type: object
properties:
dataSource:
type: string
description:
type: string
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
eventType:
type: string
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
level:
type: integer
dateRange:
type: object
properties:
endTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
startTime:
type: string
format: date-time
example: "2022-09-15T00:00:00Z"
top_0:
type: array
items:
type: object
properties:
botCategory:
type: string
example: Search
value:
type: string
example: "65"
success:
type: boolean
example: true
security:
- api_email: []
api_key: []
- api_token: []
/railguns:
get:
tags:
- Railgun
summary: List Railguns
description: List, search, sort and filter your Railguns.
operationId: railgun-list-railguns
responses:
4xx:
description: List Railguns response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Railguns response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Railgun
summary: Create Railgun
operationId: railgun-create-railgun
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
$ref: '#/components/schemas/railgun_components-schemas-name'
responses:
4xx:
description: Create Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/railguns/{identifier}:
delete:
tags:
- Railgun
summary: Delete a Railgun
description: Disable and delete a Railgun. This will immediately disable that
Railgun for any connected zones.
operationId: railgun-delete-a-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single_id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Railgun
summary: Railgun details
operationId: railgun-railgun-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
responses:
4xx:
description: Railgun details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Railgun details response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Railgun
summary: Enable or disable a Railgun
description: Enable or disable a Railgun for all zones connected to it.
operationId: railgun-enable-or-disable-a-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- enabled
properties:
enabled:
$ref: '#/components/schemas/railgun_components-schemas-enabled'
responses:
4xx:
description: Enable or disable a Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable or disable a Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/railguns/{identifier}/zones:
get:
tags:
- Railgun
summary: List Railgun zones
description: List the zones that are currently using this Railgun.
operationId: railgun-list-railgun-zones
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier'
responses:
4xx:
description: List Railgun zones response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-zone'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Railgun zones response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/components-schemas-zone'
security:
- api_email: []
api_key: []
- api_token: []
/user:
get:
tags:
- User
summary: User Details
operationId: user-user-details
responses:
4xx:
description: User Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_user_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: User Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_user_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- User
summary: Edit User
description: Edit part of your user details.
operationId: user-edit-user
requestBody:
required: true
content:
application/json:
schema:
properties:
country:
$ref: '#/components/schemas/country'
first_name:
$ref: '#/components/schemas/first_name'
last_name:
$ref: '#/components/schemas/last_name'
telephone:
$ref: '#/components/schemas/telephone'
zipcode:
$ref: '#/components/schemas/zipcode'
responses:
4xx:
description: Edit User response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_user_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit User response
content:
application/json:
schema:
$ref: '#/components/schemas/single_user_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/audit_logs:
get:
tags:
- Audit Logs
summary: Get user audit logs
description: Gets a list of audit logs for a user account. The list can be filtered
by who made the change, which zone was the change made on, and the timeframe
of the change.
operationId: audit-logs-get-user-audit-logs
responses:
4xx:
description: Get user audit logs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/audit_logs_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get user audit logs response
content:
application/json:
schema:
$ref: '#/components/schemas/audit_logs_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/user/billing/history:
get:
tags:
- User Billing History
summary: Billing History Details
description: Accesses your billing history object.
operationId: user-billing-history-billing-history-details
responses:
4xx:
description: Billing History Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/billing_history_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Billing History Details response
content:
application/json:
schema:
$ref: '#/components/schemas/billing_history_collection'
security:
- api_email: []
api_key: []
- api_token: []
/user/billing/profile:
get:
tags:
- User Billing Profile
summary: Billing Profile Details
description: Accesses your billing profile object.
operationId: user-billing-profile-billing-profile-details
responses:
4xx:
description: Billing Profile Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/billing_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Billing Profile Details response
content:
application/json:
schema:
$ref: '#/components/schemas/billing_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/user/firewall/access_rules/rules:
get:
tags:
- IP Access rules for a user
summary: List IP Access rules
description: Fetches IP Access rules of the user. You can filter the results
using several optional parameters.
operationId: ip-access-rules-for-a-user-list-ip-access-rules
responses:
4xx:
description: List IP Access rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IP Access rules response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Access rules for a user
summary: Create an IP Access rule
description: |-
Creates a new IP Access rule for all zones owned by the current user.
Note: To create an IP Access rule that applies to a specific zone, refer to the [IP Access rules for a zone](#ip-access-rules-for-a-zone) endpoints.
operationId: ip-access-rules-for-a-user-create-an-ip-access-rule
requestBody:
required: true
content:
application/json:
schema:
required:
- mode
- configuration
properties:
configuration:
$ref: '#/components/schemas/schemas-configuration'
mode:
$ref: '#/components/schemas/schemas-mode'
notes:
$ref: '#/components/schemas/notes'
responses:
4xx:
description: Create an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/firewall/access_rules/rules/{identifier}:
delete:
tags:
- IP Access rules for a user
summary: Delete an IP Access rule
description: |-
Deletes an IP Access rule at the user level.
Note: Deleting a user-level rule will affect all zones owned by the user.
operationId: ip-access-rules-for-a-user-delete-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_id_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Access rules for a user
summary: Update an IP Access rule
description: Updates an IP Access rule defined at the user level. You can only
update the rule action (`mode` parameter) and notes.
operationId: ip-access-rules-for-a-user-update-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
mode:
$ref: '#/components/schemas/schemas-mode'
notes:
$ref: '#/components/schemas/notes'
responses:
4xx:
description: Update an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/invites:
get:
tags:
- User's Invites
summary: List Invitations
description: Lists all invitations associated with my user.
operationId: user'-s-invites-list-invitations
responses:
4xx:
description: List Invitations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-collection_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Invitations response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-collection_invite_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/invites/{identifier}:
get:
tags:
- User's Invites
summary: Invitation Details
description: Gets the details of an invitation.
operationId: user'-s-invites-invitation-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/invite_components-schemas-identifier'
responses:
4xx:
description: Invitation Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Invitation Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_invite_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- User's Invites
summary: Respond to Invitation
description: Responds to an invitation.
operationId: user'-s-invites-respond-to-invitation
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/invite_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- status
properties:
status:
description: Status of your response to the invitation (rejected
or accepted).
enum:
- accepted
- rejected
example: accepted
responses:
4xx:
description: Respond to Invitation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_invite_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Respond to Invitation response
content:
application/json:
schema:
$ref: '#/components/schemas/single_invite_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/monitors:
get:
tags:
- Load Balancer Monitors
summary: List Monitors
description: List configured monitors for a user.
operationId: load-balancer-monitors-list-monitors
responses:
4xx:
description: List Monitors response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Monitors response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Load Balancer Monitors
summary: Create Monitor
description: Create a configured monitor.
operationId: load-balancer-monitors-create-monitor
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Create Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/monitors/{identifier}:
delete:
tags:
- Load Balancer Monitors
summary: Delete Monitor
description: Delete a configured monitor.
operationId: load-balancer-monitors-delete-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Load Balancer Monitors
summary: Monitor Details
description: List a single configured monitor for a user.
operationId: load-balancer-monitors-monitor-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
responses:
4xx:
description: Monitor Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Monitor Details response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Load Balancer Monitors
summary: Patch Monitor
description: Apply changes to an existing monitor, overwriting the supplied
properties.
operationId: load-balancer-monitors-patch-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Patch Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Load Balancer Monitors
summary: Update Monitor
description: Modify a configured monitor.
operationId: load-balancer-monitors-update-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
description:
$ref: '#/components/schemas/monitor_components-schemas-description'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
interval:
$ref: '#/components/schemas/interval'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
probe_zone:
$ref: '#/components/schemas/probe_zone'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Update Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/monitor_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/monitor_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/monitors/{identifier}/preview:
post:
tags:
- Load Balancer Monitors
summary: Preview Monitor
description: Preview pools using the specified monitor with provided monitor
details. The returned preview_id can be used in the preview endpoint to retrieve
the results.
operationId: load-balancer-monitors-preview-monitor
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Preview Monitor response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Monitor response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/monitors/{identifier}/references:
get:
tags:
- Load Balancer Monitors
summary: List Monitor References
description: Get the list of resources that reference the provided monitor.
operationId: load-balancer-monitors-list-monitor-references
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/monitor_components-schemas-identifier'
responses:
4xx:
description: List Monitor References response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/references_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Monitor References response
content:
application/json:
schema:
$ref: '#/components/schemas/references_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/pools:
get:
tags:
- Load Balancer Pools
summary: List Pools
description: List configured pools.
operationId: load-balancer-pools-list-pools
responses:
4xx:
description: List Pools response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Pools response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Load Balancer Pools
summary: Patch Pools
description: Apply changes to a number of existing pools, overwriting the supplied
properties. Pools are ordered by ascending `name`. Returns the list of affected
pools. Supports the standard pagination query parameters, either `limit`/`offset`
or `per_page`/`page`.
operationId: load-balancer-pools-patch-pools
requestBody:
required: true
content:
application/json:
schema:
properties:
notification_email:
$ref: '#/components/schemas/patch_pools_notification_email'
responses:
4xx:
description: Patch Pools response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Pools response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Load Balancer Pools
summary: Create Pool
description: Create a new pool.
operationId: load-balancer-pools-create-pool
requestBody:
required: true
content:
application/json:
schema:
required:
- origins
- name
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Create Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/pools/{identifier}:
delete:
tags:
- Load Balancer Pools
summary: Delete Pool
description: Delete a configured pool.
operationId: load-balancer-pools-delete-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Load Balancer Pools
summary: Pool Details
description: Fetch a single configured pool.
operationId: load-balancer-pools-pool-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
responses:
4xx:
description: Pool Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Pool Details response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Load Balancer Pools
summary: Patch Pool
description: Apply changes to an existing pool, overwriting the supplied properties.
operationId: load-balancer-pools-patch-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
disabled_at:
$ref: '#/components/schemas/schemas-disabled_at'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Patch Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Load Balancer Pools
summary: Update Pool
description: Modify a configured pool.
operationId: load-balancer-pools-update-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- origins
- name
properties:
check_regions:
$ref: '#/components/schemas/check_regions'
description:
$ref: '#/components/schemas/pool_components-schemas-description'
disabled_at:
$ref: '#/components/schemas/schemas-disabled_at'
enabled:
$ref: '#/components/schemas/pool_components-schemas-enabled'
latitude:
$ref: '#/components/schemas/latitude'
load_shedding:
$ref: '#/components/schemas/load_shedding'
longitude:
$ref: '#/components/schemas/longitude'
minimum_origins:
$ref: '#/components/schemas/minimum_origins'
monitor:
$ref: '#/components/schemas/schemas-monitor'
name:
$ref: '#/components/schemas/pool_components-schemas-name'
notification_email:
$ref: '#/components/schemas/notification_email'
notification_filter:
$ref: '#/components/schemas/notification_filter'
origin_steering:
$ref: '#/components/schemas/origin_steering'
origins:
$ref: '#/components/schemas/origins'
responses:
4xx:
description: Update Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pool_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/pool_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/pools/{identifier}/health:
get:
tags:
- Load Balancer Pools
summary: Pool Health Details
description: Fetch the latest pool health status for a single pool.
operationId: load-balancer-pools-pool-health-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
responses:
4xx:
description: Pool Health Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/health_details'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Pool Health Details response
content:
application/json:
schema:
$ref: '#/components/schemas/health_details'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/pools/{identifier}/preview:
post:
tags:
- Load Balancer Pools
summary: Preview Pool
description: Preview pool health using provided monitor details. The returned
preview_id can be used in the preview endpoint to retrieve the results.
operationId: load-balancer-pools-preview-pool
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expected_codes
properties:
allow_insecure:
$ref: '#/components/schemas/allow_insecure'
expected_body:
$ref: '#/components/schemas/expected_body'
expected_codes:
$ref: '#/components/schemas/expected_codes'
follow_redirects:
$ref: '#/components/schemas/follow_redirects'
header:
$ref: '#/components/schemas/header'
method:
$ref: '#/components/schemas/schemas-method'
path:
$ref: '#/components/schemas/path'
port:
$ref: '#/components/schemas/components-schemas-port'
retries:
$ref: '#/components/schemas/retries'
timeout:
$ref: '#/components/schemas/schemas-timeout'
type:
$ref: '#/components/schemas/monitor_components-schemas-type'
responses:
4xx:
description: Preview Pool response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Pool response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/pools/{identifier}/references:
get:
tags:
- Load Balancer Pools
summary: List Pool References
description: Get the list of resources that reference the provided pool.
operationId: load-balancer-pools-list-pool-references
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/pool_components-schemas-identifier'
responses:
4xx:
description: List Pool References response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-references_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Pool References response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-references_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancers/preview/{preview_id}:
get:
tags:
- Load Balancer Monitors
summary: Preview Result
description: Get the result of a previous preview operation using the provided
preview_id.
operationId: load-balancer-monitors-preview-result
parameters:
- name: preview_id
in: path
required: true
schema:
$ref: '#/components/schemas/preview_id'
responses:
4xx:
description: Preview Result response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/preview_result_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview Result response
content:
application/json:
schema:
$ref: '#/components/schemas/preview_result_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/load_balancing_analytics/events:
get:
tags:
- Load Balancer Healthcheck Events
summary: List Healthcheck Events
description: List origin health changes.
operationId: load-balancer-healthcheck-events-list-healthcheck-events
responses:
4xx:
description: List Healthcheck Events response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/analytics_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Healthcheck Events response
content:
application/json:
schema:
$ref: '#/components/schemas/analytics_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/user/organizations:
get:
tags:
- User's Organizations
summary: List Organizations
description: Lists organizations the user is associated with.
operationId: user'-s-organizations-list-organizations
responses:
4xx:
description: List Organizations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_organization_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Organizations response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_organization_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/organizations/{identifier}:
delete:
tags:
- User's Organizations
summary: Leave Organization
description: Removes association to an organization.
operationId: user'-s-organizations-leave-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Leave Organization response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Leave Organization response
content:
application/json:
schema:
type: object
properties:
id:
$ref: '#/components/schemas/common_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- User's Organizations
summary: Organization Details
description: Gets a specific organization the user is associated with.
operationId: user'-s-organizations-organization-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Organization Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_organization_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Organization Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_organization_response'
security:
- api_email: []
api_key: []
- api_token: []
/user/subscriptions:
get:
tags:
- User Subscription
summary: Get User Subscriptions
description: Lists all of a user's subscriptions.
operationId: user-subscription-get-user-subscriptions
responses:
4xx:
description: Get User Subscriptions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_subscription_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get User Subscriptions response
content:
application/json:
schema:
$ref: '#/components/schemas/user_subscription_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/user/subscriptions/{identifier}:
delete:
tags:
- User Subscription
summary: Delete User Subscription
description: Deletes a user's subscription.
operationId: user-subscription-delete-user-subscription
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete User Subscription response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
subscription_id:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete User Subscription response
content:
application/json:
schema:
type: object
properties:
subscription_id:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- User Subscription
summary: Update User Subscription
description: Updates a user's subscriptions.
operationId: user-subscription-update-user-subscription
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/subscription-v2'
responses:
4xx:
description: Update User Subscription response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update User Subscription response
content:
application/json:
schema:
$ref: '#/components/schemas/user_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/user/tokens:
get:
tags:
- User API Tokens
summary: List Tokens
description: List all access tokens you created.
operationId: user-api-tokens-list-tokens
responses:
4xx:
description: List Tokens response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Tokens response
content:
application/json:
schema:
$ref: '#/components/schemas/response_collection'
security:
- api_token: []
post:
tags:
- User API Tokens
summary: Create Token
description: Create a new access token.
operationId: user-api-tokens-create-token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_payload'
responses:
4xx:
description: Create Token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_create'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Token response
content:
application/json:
schema:
$ref: '#/components/schemas/response_create'
security:
- api_token: []
/user/tokens/{identifier}:
delete:
tags:
- User API Tokens
summary: Delete Token
description: Destroy a token.
operationId: user-api-tokens-delete-token
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Token response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_token: []
get:
tags:
- User API Tokens
summary: Token Details
description: Get information about a specific token.
operationId: user-api-tokens-token-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
responses:
4xx:
description: Token Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Token Details response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_token: []
put:
tags:
- User API Tokens
summary: Update Token
description: Update an existing token.
operationId: user-api-tokens-update-token
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-token'
responses:
4xx:
description: Update Token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Token response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single'
security:
- api_token: []
/user/tokens/{identifier}/value:
put:
tags:
- User API Tokens
summary: Roll Token
description: Roll the token secret.
operationId: user-api-tokens-roll-token
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
4xx:
description: Roll Token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Roll Token response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single_value'
security:
- api_token: []
/user/tokens/permission_groups:
get:
tags:
- Permission Groups
summary: List Permission Groups
description: Find all available permission groups.
operationId: permission-groups-list-permission-groups
responses:
4xx:
description: List Permission Groups response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Permission Groups response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_collection'
security:
- api_token: []
/user/tokens/verify:
get:
tags:
- User API Tokens
summary: Verify Token
description: Test whether a token works.
operationId: user-api-tokens-verify-token
responses:
4xx:
description: Verify Token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single_segment'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Verify Token response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single_segment'
security:
- api_token: []
/zones:
get:
tags:
- Zone
summary: List Zones
description: Lists, searches, sorts, and filters your zones.
operationId: zone-list-zones
responses:
4xx:
description: List Zones response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Zones response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone
summary: Create Zone
operationId: zone-create-zone
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-create'
responses:
4xx:
description: Create Zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zone response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}:
delete:
tags:
- Zone
summary: Delete Zone
description: Deletes an existing zone.
operationId: zone-delete-zone
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Zone response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone
summary: Zone Details
operationId: zone-zone-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
responses:
4xx:
description: Zone Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zone Details response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone
summary: Edit Zone
description: Editz a zone. Only one zone property can be changed at a time.
operationId: zone-edit-zone
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-patch'
responses:
4xx:
description: Edit Zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Zone response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps:
get:
tags:
- Zone-Level Access applications
summary: List Access Applications
description: List all Access Applications in a zone.
operationId: zone-level-access-applications-list-access-applications
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: List Access Applications response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-response_collection-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access Applications response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-response_collection-2'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access applications
summary: Add a Bookmark application
description: Adds a custom link to the App Launcher. Bookmark applications are
not protected by Access.
operationId: zone-level-access-applications-add-a-bookmark-application
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- domain
responses:
4xx:
description: Add a Bookmark application response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response-2'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/schemas-bookmark_props'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add a Bookmark application response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response-2'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/schemas-bookmark_props'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{app_id}:
delete:
tags:
- Zone-Level Access applications
summary: Delete an Access application
description: Deletes an application from Access.
operationId: zone-level-access-applications-delete-an-access-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access application response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access applications
summary: Get an Access application
description: Fetches information about an Access application.
operationId: zone-level-access-applications-get-an-access-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: Get an Access application response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response-2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access application response
content:
application/json:
schema:
$ref: '#/components/schemas/apps_components-schemas-single_response-2'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access applications
summary: Update a Bookmark application
description: Updates a Bookmark application.
operationId: zone-level-access-applications-update-a-bookmark-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- domain
responses:
4xx:
description: Update a Bookmark application response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response-2'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/schemas-bookmark_props'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Bookmark application response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/apps_components-schemas-single_response-2'
- properties:
result:
allOf:
- $ref: '#/components/schemas/basic_app_response_props'
- $ref: '#/components/schemas/schemas-bookmark_props'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{app_id}/revoke_tokens:
post:
tags:
- Zone-Level Access applications
summary: Revoke service tokens
description: Revokes all service tokens used by an application.
operationId: zone-level-access-applications-revoke-service-tokens
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Revoke service tokens response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke service tokens response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{app_id}/user_policy_checks:
get:
tags:
- Zone-Level Access applications
summary: Test Access policies
description: Tests if a specific user has permission to access an application.
operationId: zone-level-access-applications-test-access-policies
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-app_id'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/apps_components-schemas-identifier'
responses:
4xx:
description: Test Access policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policy_check_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Test Access policies response
content:
application/json:
schema:
$ref: '#/components/schemas/policy_check_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{uuid}/ca:
delete:
tags:
- Zone-Level Access short-lived certificate CAs
summary: Delete a short-lived certificate CA
description: Deletes a short-lived certificate CA.
operationId: zone-level-access-short-lived-certificate-c-as-delete-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access short-lived certificate CAs
summary: Get a short-lived certificate CA
description: Fetches a short-lived certificate CA and its public key.
operationId: zone-level-access-short-lived-certificate-c-as-get-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access short-lived certificate CAs
summary: Create a short-lived certificate CA
description: Generates a new short-lived certificate CA and public key.
operationId: zone-level-access-short-lived-certificate-c-as-create-a-short-lived-certificate-ca
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Create a short-lived certificate CA response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a short-lived certificate CA response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{uuid}/policies:
get:
tags:
- Zone-Level Access policies
summary: List Access policies
description: Lists Access policies configured for an application.
operationId: zone-level-access-policies-list-access-policies
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
responses:
4xx:
description: List Access policies response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access policies response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access policies
summary: Create an Access policy
description: Create a new Access policy for an application.
operationId: zone-level-access-policies-create-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- decision
- include
properties:
approval_groups:
$ref: '#/components/schemas/approval_groups'
approval_required:
$ref: '#/components/schemas/approval_required'
decision:
$ref: '#/components/schemas/decision'
exclude:
$ref: '#/components/schemas/schemas-exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/policies_components-schemas-name'
precedence:
$ref: '#/components/schemas/precedence'
purpose_justification_prompt:
$ref: '#/components/schemas/purpose_justification_prompt'
purpose_justification_required:
$ref: '#/components/schemas/purpose_justification_required'
require:
$ref: '#/components/schemas/schemas-require'
responses:
4xx:
description: Create an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/{uuid1}/policies/{uuid}:
delete:
tags:
- Zone-Level Access policies
summary: Delete an Access policy
description: Delete an Access policy.
operationId: zone-level-access-policies-delete-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access policies
summary: Get an Access policy
description: Fetches a single Access policy.
operationId: zone-level-access-policies-get-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
responses:
4xx:
description: Get an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access policies
summary: Update an Access policy
description: Update a configured Access policy.
operationId: zone-level-access-policies-update-an-access-policy
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: uuid1
in: path
required: true
schema:
$ref: '#/components/schemas/components-schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/policies_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- decision
- include
properties:
approval_groups:
$ref: '#/components/schemas/approval_groups'
approval_required:
$ref: '#/components/schemas/approval_required'
decision:
$ref: '#/components/schemas/decision'
exclude:
$ref: '#/components/schemas/schemas-exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/policies_components-schemas-name'
precedence:
$ref: '#/components/schemas/precedence'
purpose_justification_prompt:
$ref: '#/components/schemas/purpose_justification_prompt'
purpose_justification_required:
$ref: '#/components/schemas/purpose_justification_required'
require:
$ref: '#/components/schemas/schemas-require'
responses:
4xx:
description: Update an Access policy response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/policies_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access policy response
content:
application/json:
schema:
$ref: '#/components/schemas/policies_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/apps/ca:
get:
tags:
- Zone-Level Access short-lived certificate CAs
summary: List short-lived certificate CAs
description: Lists short-lived certificate CAs and their public keys.
operationId: zone-level-access-short-lived-certificate-c-as-list-short-lived-certificate-c-as
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List short-lived certificate CAs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ca_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List short-lived certificate CAs response
content:
application/json:
schema:
$ref: '#/components/schemas/ca_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/certificates:
get:
tags:
- Zone-Level Access mTLS authentication
summary: List mTLS certificates
description: Lists all mTLS certificates.
operationId: zone-level-access-m-tls-authentication-list-m-tls-certificates
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List mTLS certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List mTLS certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access mTLS authentication
summary: Add an mTLS certificate
description: Adds a new mTLS root certificate to Access.
operationId: zone-level-access-m-tls-authentication-add-an-m-tls-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- certificate
properties:
associated_hostnames:
$ref: '#/components/schemas/associated_hostnames'
certificate:
type: string
description: The certificate content.
example: |-
-----BEGIN CERTIFICATE-----
MIIGAjCCA+qgAwIBAgIJAI7kymlF7CWT...N4RI7KKB7nikiuUf8vhULKy5IX10
DrUtmu/B
-----END CERTIFICATE-----
name:
$ref: '#/components/schemas/certificates_components-schemas-name'
responses:
4xx:
description: Add an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/certificates/{uuid}:
delete:
tags:
- Zone-Level Access mTLS authentication
summary: Delete an mTLS certificate
description: Deletes an mTLS certificate.
operationId: zone-level-access-m-tls-authentication-delete-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access mTLS authentication
summary: Get an mTLS certificate
description: Fetches a single mTLS certificate.
operationId: zone-level-access-m-tls-authentication-get-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access mTLS authentication
summary: Update an mTLS certificate
description: Updates a configured mTLS certificate.
operationId: zone-level-access-m-tls-authentication-update-an-m-tls-certificate
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- associated_hostnames
properties:
associated_hostnames:
$ref: '#/components/schemas/associated_hostnames'
name:
$ref: '#/components/schemas/certificates_components-schemas-name'
responses:
4xx:
description: Update an mTLS certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificates_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an mTLS certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificates_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/groups:
get:
tags:
- Zone-Level Access groups
summary: List Access groups
description: Lists all Access groups.
operationId: zone-level-access-groups-list-access-groups
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Access groups response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access groups response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access groups
summary: Create an Access group
description: Creates a new Access group.
operationId: zone-level-access-groups-create-an-access-group
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- include
properties:
exclude:
$ref: '#/components/schemas/exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/groups_components-schemas-name'
require:
$ref: '#/components/schemas/require'
responses:
4xx:
description: Create an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/groups/{uuid}:
delete:
tags:
- Zone-Level Access groups
summary: Delete an Access group
description: Deletes an Access group.
operationId: zone-level-access-groups-delete-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access groups
summary: Get an Access group
description: Fetches a single Access group.
operationId: zone-level-access-groups-get-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access groups
summary: Update an Access group
description: Updates a configured Access group.
operationId: zone-level-access-groups-update-an-access-group
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- include
properties:
exclude:
$ref: '#/components/schemas/exclude'
include:
$ref: '#/components/schemas/include'
name:
$ref: '#/components/schemas/groups_components-schemas-name'
require:
$ref: '#/components/schemas/require'
responses:
4xx:
description: Update an Access group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/groups_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access group response
content:
application/json:
schema:
$ref: '#/components/schemas/groups_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/identity_providers:
get:
tags:
- Zone-Level Access identity providers
summary: List Access identity providers
description: Lists all configured identity providers.
operationId: zone-level-access-identity-providers-list-access-identity-providers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
responses:
4xx:
description: List Access identity providers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Access identity providers response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access identity providers
summary: Add an Access identity provider
description: Adds a new identity provider to Access.
operationId: zone-level-access-identity-providers-add-an-access-identity-provider
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- config
properties:
config:
$ref: '#/components/schemas/schemas-config'
name:
$ref: '#/components/schemas/identity-providers_components-schemas-name'
type:
$ref: '#/components/schemas/identity-providers_components-schemas-type'
responses:
4xx:
description: Add an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/identity_providers/{uuid}:
delete:
tags:
- Zone-Level Access identity providers
summary: Delete an Access identity provider
description: Deletes an identity provider from Access.
operationId: zone-level-access-identity-providers-delete-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Access identity providers
summary: Get an Access identity provider
description: Fetches a configured identity provider.
operationId: zone-level-access-identity-providers-get-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
responses:
4xx:
description: Get an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access identity providers
summary: Update an Access identity provider
description: Updates a configured identity provider.
operationId: zone-level-access-identity-providers-update-an-access-identity-provider
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- type
- config
properties:
config:
$ref: '#/components/schemas/schemas-config'
name:
$ref: '#/components/schemas/identity-providers_components-schemas-name'
type:
$ref: '#/components/schemas/identity-providers_components-schemas-type'
responses:
4xx:
description: Update an Access identity provider response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/identity-providers_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an Access identity provider response
content:
application/json:
schema:
$ref: '#/components/schemas/identity-providers_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/organizations:
get:
tags:
- Zone-Level Zero Trust organization
summary: Get your Zero Trust organization
description: Returns the configuration for your Zero Trust organization.
operationId: zone-level-zero-trust-organization-get-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
responses:
4xx:
description: Get your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Zero Trust organization
summary: Create your Zero Trust organization
description: Sets up a Zero Trust organization for your account.
operationId: zone-level-zero-trust-organization-create-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- auth_domain
properties:
auth_domain:
$ref: '#/components/schemas/auth_domain'
is_ui_read_only:
$ref: '#/components/schemas/is_ui_read_only'
login_design:
$ref: '#/components/schemas/login_design'
name:
$ref: '#/components/schemas/organizations_components-schemas-name'
responses:
4xx:
description: Create your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Zero Trust organization
summary: Update your Zero Trust organization
description: Updates the configuration for your Zero Trust organization.
operationId: zone-level-zero-trust-organization-update-your-zero-trust-organization
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
auth_domain:
$ref: '#/components/schemas/auth_domain'
is_ui_read_only:
$ref: '#/components/schemas/is_ui_read_only'
login_design:
$ref: '#/components/schemas/login_design'
name:
$ref: '#/components/schemas/organizations_components-schemas-name'
responses:
4xx:
description: Update your Zero Trust organization response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/organizations_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update your Zero Trust organization response
content:
application/json:
schema:
$ref: '#/components/schemas/organizations_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/organizations/revoke_user:
post:
tags:
- Zone-Level Zero Trust organization
summary: Revoke all Access tokens for a user
description: Revokes a user's access across all applications.
operationId: zone-level-zero-trust-organization-revoke-all-access-tokens-for-a-user
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/organizations_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- email
properties:
email:
type: string
description: The email of the user to revoke.
example: test@example.com
responses:
4xx:
description: Revoke all Access tokens for a user response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Revoke all Access tokens for a user response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/service_tokens:
get:
tags:
- Zone-Level Access service tokens
summary: List service tokens
description: Lists all service tokens.
operationId: zone-level-access-service-tokens-list-service-tokens
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List service tokens response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List service tokens response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Access service tokens
summary: Create a service token
description: Generates a new service token. **Note:** This is the only time
you can get the Client Secret. If you lose the Client Secret, you will have
to create a new service token.
operationId: zone-level-access-service-tokens-create-a-service-token
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
properties:
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
responses:
4xx:
description: Create a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/create_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/create_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/access/service_tokens/{uuid}:
delete:
tags:
- Zone-Level Access service tokens
summary: Delete a service token
description: Deletes a service token.
operationId: zone-level-access-service-tokens-delete-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Access service tokens
summary: Update a service token
description: Updates a configured service token.
operationId: zone-level-access-service-tokens-update-a-service-token
parameters:
- name: uuid
in: path
required: true
schema:
$ref: '#/components/schemas/uuid'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
name:
$ref: '#/components/schemas/service-tokens_components-schemas-name'
responses:
4xx:
description: Update a service token response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service-tokens_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a service token response
content:
application/json:
schema:
$ref: '#/components/schemas/service-tokens_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/activation_check:
put:
tags:
- Zone
summary: Zone Activation Check
description: Initiates another zone activation check.
operationId: zone-zone-activation-check
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Zone Activation Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zone Activation Check response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/dns_analytics/report:
get:
tags:
- DNS Analytics
summary: Table
description: Retrieves a list of summarised aggregate metrics over a given time
period.
operationId: dns-analytics-table
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Table response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Table response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/dns_analytics/report/bytime:
get:
tags:
- DNS Analytics
summary: By Time
description: Retrieves a list of aggregate metrics grouped by time interval.
operationId: dns-analytics-by-time
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: By Time response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: By Time response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
$ref: '#/components/schemas/result'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/load_balancers:
get:
tags:
- Load Balancers
summary: List Load Balancers
description: List configured load balancers.
operationId: load-balancers-list-load-balancers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
responses:
4xx:
description: List Load Balancers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Load Balancers response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Load Balancers
summary: Create Load Balancer
description: Create a new load balancer.
operationId: load-balancers-create-load-balancer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- default_pools
- fallback_pool
properties:
adaptive_routing:
$ref: '#/components/schemas/adaptive_routing'
country_pools:
$ref: '#/components/schemas/country_pools'
default_pools:
$ref: '#/components/schemas/default_pools'
description:
$ref: '#/components/schemas/load-balancer_components-schemas-description'
fallback_pool:
$ref: '#/components/schemas/fallback_pool'
location_strategy:
$ref: '#/components/schemas/location_strategy'
name:
$ref: '#/components/schemas/load-balancer_components-schemas-name'
pop_pools:
$ref: '#/components/schemas/pop_pools'
proxied:
$ref: '#/components/schemas/schemas-proxied'
random_steering:
$ref: '#/components/schemas/random_steering'
region_pools:
$ref: '#/components/schemas/region_pools'
rules:
$ref: '#/components/schemas/load-balancer_components-schemas-rules'
session_affinity:
$ref: '#/components/schemas/session_affinity'
session_affinity_attributes:
$ref: '#/components/schemas/session_affinity_attributes'
session_affinity_ttl:
$ref: '#/components/schemas/session_affinity_ttl'
steering_policy:
$ref: '#/components/schemas/steering_policy'
ttl:
$ref: '#/components/schemas/schemas-ttl'
responses:
4xx:
description: Create Load Balancer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Load Balancer response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/purge_cache:
post:
tags:
- Zone
summary: Purge Files by Cache-Tags, Host, or Prefix
description: |-
Granularly removes one or more files from Cloudflare's cache either by specifying the host, the associated Cache-Tag, or a Prefix.
**NB:** Cache-Tag, host, and prefix purging each have a rate limit of 30,000 purge API calls in every 24 hour period. You may purge up to 30 tags, hosts, or prefixes in one API call. This rate limit can be raised for customers who need to purge at higher volume.
operationId: zone-purge-files-by-cache-tags,-host,-or-prefix
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/purge_by_cache_tags_or_hosts_or_prefixes'
responses:
4xx:
description: Purge Files by Cache-Tags, Host, or Prefix response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Purge Files by Cache-Tags, Host, or Prefix response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/force_axfr:
post:
tags:
- Secondary DNS (Secondary Zone)
summary: Force AXFR
description: Sends AXFR zone transfer request to primary nameserver(s).
operationId: secondary-dns-(-secondary-zone)-force-axfr
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Force AXFR response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/force_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Force AXFR response
content:
application/json:
schema:
$ref: '#/components/schemas/force_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/incoming:
delete:
tags:
- Secondary DNS (Secondary Zone)
summary: Delete Secondary Zone Configuration
description: Delete secondary zone configuration for incoming zone transfers.
operationId: secondary-dns-(-secondary-zone)-delete-secondary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Secondary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Secondary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Secondary DNS (Secondary Zone)
summary: Secondary Zone Configuration Details
description: Get secondary zone configuration for incoming zone transfers.
operationId: secondary-dns-(-secondary-zone)-secondary-zone-configuration-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
responses:
4xx:
description: Secondary Zone Configuration Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_incoming'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Secondary Zone Configuration Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_incoming'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Secondary DNS (Secondary Zone)
summary: Create Secondary Zone Configuration
description: Create secondary zone configuration for incoming zone transfers.
operationId: secondary-dns-(-secondary-zone)-create-secondary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone'
responses:
4xx:
description: Create Secondary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_incoming'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Secondary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_incoming'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Secondary DNS (Secondary Zone)
summary: Update Secondary Zone Configuration
description: Update secondary zone configuration for incoming zone transfers.
operationId: secondary-dns-(-secondary-zone)-update-secondary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/dns-secondary-secondary-zone'
responses:
4xx:
description: Update Secondary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_incoming'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Secondary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_incoming'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/outgoing:
delete:
tags:
- Secondary DNS (Primary Zone)
summary: Delete Primary Zone Configuration
description: Delete primary zone configuration for outgoing zone transfers.
operationId: secondary-dns-(-primary-zone)-delete-primary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Primary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Primary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Secondary DNS (Primary Zone)
summary: Primary Zone Configuration Details
description: Get primary zone configuration for outgoing zone transfers.
operationId: secondary-dns-(-primary-zone)-primary-zone-configuration-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
responses:
4xx:
description: Primary Zone Configuration Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_outgoing'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Primary Zone Configuration Details response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_outgoing'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Secondary DNS (Primary Zone)
summary: Create Primary Zone Configuration
description: Create primary zone configuration for outgoing zone transfers.
operationId: secondary-dns-(-primary-zone)-create-primary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/single_request_outgoing'
responses:
4xx:
description: Create Primary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_outgoing'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Primary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_outgoing'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Secondary DNS (Primary Zone)
summary: Update Primary Zone Configuration
description: Update primary zone configuration for outgoing zone transfers.
operationId: secondary-dns-(-primary-zone)-update-primary-zone-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/single_request_outgoing'
responses:
4xx:
description: Update Primary Zone Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response_outgoing'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Primary Zone Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response_outgoing'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/outgoing/disable:
post:
tags:
- Secondary DNS (Primary Zone)
summary: Disable Outgoing Zone Transfers
description: Disable outgoing zone transfers for primary zone and clears IXFR
backlog of primary zone.
operationId: secondary-dns-(-primary-zone)-disable-outgoing-zone-transfers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Disable Outgoing Zone Transfers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/disable_transfer_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Disable Outgoing Zone Transfers response
content:
application/json:
schema:
$ref: '#/components/schemas/disable_transfer_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/outgoing/enable:
post:
tags:
- Secondary DNS (Primary Zone)
summary: Enable Outgoing Zone Transfers
description: Enable outgoing zone transfers for primary zone.
operationId: secondary-dns-(-primary-zone)-enable-outgoing-zone-transfers
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Enable Outgoing Zone Transfers response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/enable_transfer_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable Outgoing Zone Transfers response
content:
application/json:
schema:
$ref: '#/components/schemas/enable_transfer_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/outgoing/force_notify:
post:
tags:
- Secondary DNS (Primary Zone)
summary: Force DNS NOTIFY
description: Notifies the secondary nameserver(s) and clears IXFR backlog of
primary zone.
operationId: secondary-dns-(-primary-zone)-force-dns-notify
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Force DNS NOTIFY response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-force_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Force DNS NOTIFY response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-force_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/secondary_dns/outgoing/status:
get:
tags:
- Secondary DNS (Primary Zone)
summary: Get Outgoing Zone Transfer Status
description: Get primary zone transfer status.
operationId: secondary-dns-(-primary-zone)-get-outgoing-zone-transfer-status
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-secondary-primary-zone_components-schemas-identifier'
responses:
4xx:
description: Get Outgoing Zone Transfer Status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/enable_transfer_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Outgoing Zone Transfer Status response
content:
application/json:
schema:
$ref: '#/components/schemas/enable_transfer_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/ssl/analyze:
post:
tags:
- Analyze Certificate
summary: Analyze Certificate
description: Returns the set of hostnames, the signature algorithm, and the
expiration date of the certificate.
operationId: analyze-certificate-analyze-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
bundle_method:
$ref: '#/components/schemas/bundle_method'
certificate:
$ref: '#/components/schemas/certificate'
responses:
4xx:
description: Analyze Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_analyze_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Analyze Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_analyze_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier}/subscription:
get:
tags:
- Zone Subscription
summary: Zone Subscription Details
description: Lists zone subscription details.
operationId: zone-subscription-zone-subscription-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
responses:
4xx:
description: Zone Subscription Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Zone Subscription Details response
content:
application/json:
schema:
$ref: '#/components/schemas/zone_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone Subscription
summary: Create Zone Subscription
description: Create a zone subscription, either plan or add-ons.
operationId: zone-subscription-create-zone-subscription
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/subscription-v2'
responses:
4xx:
description: Create Zone Subscription response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Zone Subscription response
content:
application/json:
schema:
$ref: '#/components/schemas/zone_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone Subscription
summary: Update Zone Subscription
description: Updates zone subscriptions, either plan or add-ons.
operationId: zone-subscription-update-zone-subscription
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/subscription-v2_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/subscription-v2'
responses:
4xx:
description: Update Zone Subscription response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_subscription_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Zone Subscription response
content:
application/json:
schema:
$ref: '#/components/schemas/zone_subscription_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{identifier1}/load_balancers/{identifier}:
delete:
tags:
- Load Balancers
summary: Delete Load Balancer
description: Delete a configured load balancer.
operationId: load-balancers-delete-load-balancer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
- name: identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Load Balancer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Load Balancer response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Load Balancers
summary: Load Balancer Details
description: Fetch a single configured load balancer.
operationId: load-balancers-load-balancer-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
- name: identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
responses:
4xx:
description: Load Balancer Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Load Balancer Details response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Load Balancers
summary: Patch Load Balancer
description: Apply changes to an existing load balancer, overwriting the supplied
properties.
operationId: load-balancers-patch-load-balancer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
- name: identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
adaptive_routing:
$ref: '#/components/schemas/adaptive_routing'
country_pools:
$ref: '#/components/schemas/country_pools'
default_pools:
$ref: '#/components/schemas/default_pools'
description:
$ref: '#/components/schemas/load-balancer_components-schemas-description'
enabled:
$ref: '#/components/schemas/load-balancer_components-schemas-enabled'
fallback_pool:
$ref: '#/components/schemas/fallback_pool'
location_strategy:
$ref: '#/components/schemas/location_strategy'
name:
$ref: '#/components/schemas/load-balancer_components-schemas-name'
pop_pools:
$ref: '#/components/schemas/pop_pools'
proxied:
$ref: '#/components/schemas/schemas-proxied'
random_steering:
$ref: '#/components/schemas/random_steering'
region_pools:
$ref: '#/components/schemas/region_pools'
rules:
$ref: '#/components/schemas/load-balancer_components-schemas-rules'
session_affinity:
$ref: '#/components/schemas/session_affinity'
session_affinity_attributes:
$ref: '#/components/schemas/session_affinity_attributes'
session_affinity_ttl:
$ref: '#/components/schemas/session_affinity_ttl'
steering_policy:
$ref: '#/components/schemas/steering_policy'
ttl:
$ref: '#/components/schemas/schemas-ttl'
responses:
4xx:
description: Patch Load Balancer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Load Balancer response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Load Balancers
summary: Update Load Balancer
description: Update a configured load balancer.
operationId: load-balancers-update-load-balancer
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
- name: identifier1
in: path
required: true
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- name
- default_pools
- fallback_pool
properties:
adaptive_routing:
$ref: '#/components/schemas/adaptive_routing'
country_pools:
$ref: '#/components/schemas/country_pools'
default_pools:
$ref: '#/components/schemas/default_pools'
description:
$ref: '#/components/schemas/load-balancer_components-schemas-description'
enabled:
$ref: '#/components/schemas/load-balancer_components-schemas-enabled'
fallback_pool:
$ref: '#/components/schemas/fallback_pool'
location_strategy:
$ref: '#/components/schemas/location_strategy'
name:
$ref: '#/components/schemas/load-balancer_components-schemas-name'
pop_pools:
$ref: '#/components/schemas/pop_pools'
proxied:
$ref: '#/components/schemas/schemas-proxied'
random_steering:
$ref: '#/components/schemas/random_steering'
region_pools:
$ref: '#/components/schemas/region_pools'
rules:
$ref: '#/components/schemas/load-balancer_components-schemas-rules'
session_affinity:
$ref: '#/components/schemas/session_affinity'
session_affinity_attributes:
$ref: '#/components/schemas/session_affinity_attributes'
session_affinity_ttl:
$ref: '#/components/schemas/session_affinity_ttl'
steering_policy:
$ref: '#/components/schemas/steering_policy'
ttl:
$ref: '#/components/schemas/schemas-ttl'
responses:
4xx:
description: Update Load Balancer response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/load-balancer_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Load Balancer response
content:
application/json:
schema:
$ref: '#/components/schemas/load-balancer_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/activation_check:
put:
tags:
- Client
summary: Rerun the Activation Check
description: |-
Triggeres a new activation check for a PENDING Zone. This can be
triggered every 5 min for paygo/ent customers, every hour for FREE
Zones.
operationId: put-zones-zone_id-activation_check
parameters:
- name: zone_id
in: path
description: Zone ID
required: true
schema:
$ref: '#/components/schemas/identifier'
responses:
4xx:
description: Client Error
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Successful Response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/identifier'
/zones/{zone_id}/api_gateway/configuration:
get:
tags:
- API Shield Settings
summary: Retrieve information about specific configuration properties
operationId: api-shield-settings-retrieve-information-about-specific-configuration-properties
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve information about specific configuration properties
response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve information about specific configuration properties
response
content:
application/json:
schema:
$ref: '#/components/schemas/single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- API Shield Settings
summary: Set configuration properties
operationId: api-shield-settings-set-configuration-properties
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/configuration'
responses:
4xx:
description: Set configuration properties response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/default_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set configuration properties response
content:
application/json:
schema:
$ref: '#/components/schemas/default_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/api_gateway/discovery:
get:
tags:
- API Shield Endpoint Management
summary: Retrieve API Discovery results for a zone
description: Retrieve the most up to date view of API Discovery on a zone.
operationId: api-shield-endpoint-management-retrieve-api-discovery-results-for-a-zone
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve API Discovery results for a zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schema_response_discovery'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve API Discovery results for a zone response
content:
application/json:
schema:
$ref: '#/components/schemas/schema_response_discovery'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/api_gateway/operations:
get:
tags:
- API Shield Endpoint Management
summary: Retrieve information about all operations on a zone
operationId: api-shield-endpoint-management-retrieve-information-about-all-operations-on-a-zone
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve information about all operations on a zone response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_response_paginated'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve information about all operations on a zone response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_response_paginated'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- API Shield Endpoint Management
summary: Add operations to a zone
description: Add one or more operations to a zone. Endpoints can contain path
variables. Host, method, endpoint will be normalized to a canoncial form when
creating an operation and must be unique on the zone. Inserting an operation
that matches an existing one will return the record of the already existing
operation and update its last_updated date.
operationId: api-shield-endpoint-management-add-operations-to-a-zone
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
endpoint:
$ref: '#/components/schemas/endpoint'
host:
$ref: '#/components/schemas/host'
method:
$ref: '#/components/schemas/method'
required:
- host
- method
- endpoint
responses:
4xx:
description: Add operations to a zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Add operations to a zone response
content:
application/json:
schema:
$ref: '#/components/schemas/collection_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/api_gateway/operations/{operation_id}:
delete:
tags:
- API Shield Endpoint Management
summary: Delete an operation
operationId: api-shield-endpoint-management-delete-an-operation
parameters:
- name: operation_id
in: path
required: true
schema:
$ref: '#/components/schemas/operation_id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete an operation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/default_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an operation response
content:
application/json:
schema:
$ref: '#/components/schemas/default_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- API Shield Endpoint Management
summary: Retrieve information about an operation
operationId: api-shield-endpoint-management-retrieve-information-about-an-operation
parameters:
- name: operation_id
in: path
required: true
schema:
$ref: '#/components/schemas/operation_id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve information about an operation response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve information about an operation response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/api_gateway/schemas:
get:
tags:
- API Shield Endpoint Management
summary: Retrieve operations and features as OpenAPI schemas
operationId: api-shield-endpoint-management-retrieve-operations-and-features-as-open-api-schemas
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Retrieve operations and features as OpenAPI schemas response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schema_response_with_thresholds'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Retrieve operations and features as OpenAPI schemas response
content:
application/json:
schema:
$ref: '#/components/schemas/schema_response_with_thresholds'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/firewall/access_rules/rules:
get:
tags:
- IP Access rules for a zone
summary: List IP Access rules
description: Fetches IP Access rules of a zone. You can filter the results using
several optional parameters.
operationId: ip-access-rules-for-a-zone-list-ip-access-rules
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List IP Access rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IP Access rules response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- IP Access rules for a zone
summary: Create an IP Access rule
description: |-
Creates a new IP Access rule for a zone.
Note: To create an IP Access rule that applies to multiple zones, refer to [IP Access rules for a user](#ip-access-rules-for-a-user) or [IP Access rules for an account](#ip-access-rules-for-an-account) as appropriate.
operationId: ip-access-rules-for-a-zone-create-an-ip-access-rule
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- mode
- configuration
- notes
properties:
configuration:
$ref: '#/components/schemas/schemas-configuration'
mode:
$ref: '#/components/schemas/schemas-mode'
notes:
$ref: '#/components/schemas/notes'
responses:
4xx:
description: Create an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/firewall/access_rules/rules/{identifier}:
delete:
tags:
- IP Access rules for a zone
summary: Delete an IP Access rule
description: |-
Deletes an IP Access rule defined at the zone level.
Optionally, you can use the `cascade` property to specify that you wish to delete similar rules in other zones managed by the same zone owner.
operationId: ip-access-rules-for-a-zone-delete-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
cascade:
type: string
description: The level to attempt to delete similar rules defined
for other zones with the same owner. The default value is `none`,
which will only delete the current rule. Using `basic` will delete
rules that match the same action (mode) and configuration, while
using `aggressive` will delete rules that match the same configuration.
enum:
- none
- basic
- aggressive
default: none
responses:
4xx:
description: Delete an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_id_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- IP Access rules for a zone
summary: Update an IP Access rule
description: Updates an IP Access rule defined at the zone level. You can only
update the rule action (`mode` parameter) and notes.
operationId: ip-access-rules-for-a-zone-update-an-ip-access-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
mode:
$ref: '#/components/schemas/schemas-mode'
notes:
$ref: '#/components/schemas/notes'
responses:
4xx:
description: Update an IP Access rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update an IP Access rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/firewall/waf/packages/{package_id}/rules:
get:
tags:
- WAF rules
summary: List WAF rules
description: Fetches WAF rules in a WAF package.
operationId: waf-rules-list-waf-rules
parameters:
- name: package_id
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List WAF rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List WAF rules response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/firewall/waf/packages/{package_id}/rules/{identifier}:
get:
tags:
- WAF rules
summary: Get a WAF rule
description: Fetches the details of a WAF rule in a WAF package.
operationId: waf-rules-get-a-waf-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier-2'
- name: package_id
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a WAF rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a WAF rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- WAF rules
summary: Update a WAF rule
description: Updates a WAF rule. You can only update the mode/action of the
rule.
operationId: waf-rules-update-a-waf-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_components-schemas-identifier-2'
- name: package_id
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
mode:
description: The mode/action of the rule when triggered. You must
use a value from the `allowed_modes` array of the current rule.
enum:
- default
- disable
- simulate
- block
- challenge
- "on"
- "off"
example: "on"
responses:
4xx:
description: Update a WAF rule response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/rule_response_single'
- properties:
result:
oneOf:
- $ref: '#/components/schemas/anomaly_rule'
- $ref: '#/components/schemas/traditional_deny_rule'
- $ref: '#/components/schemas/traditional_allow_rule'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a WAF rule response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- properties:
result:
oneOf:
- $ref: '#/components/schemas/anomaly_rule'
- $ref: '#/components/schemas/traditional_deny_rule'
- $ref: '#/components/schemas/traditional_allow_rule'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/managed_headers:
get:
tags:
- Managed Transforms
summary: List Managed Transforms
description: Fetches a list of all Managed Transforms.
operationId: managed-transforms-list-managed-transforms
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Managed Transforms response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
managed_request_headers:
$ref: '#/components/schemas/request_list'
managed_response_headers:
$ref: '#/components/schemas/request_list'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Managed Transforms response
content:
application/json:
schema:
type: object
properties:
managed_request_headers:
$ref: '#/components/schemas/request_list'
managed_response_headers:
$ref: '#/components/schemas/request_list'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Managed Transforms
summary: Update status of Managed Transforms
description: Updates the status of one or more Managed Transforms.
operationId: managed-transforms-update-status-of-managed-transforms
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- managed_request_headers
- managed_response_headers
properties:
managed_request_headers:
$ref: '#/components/schemas/request_list'
managed_response_headers:
$ref: '#/components/schemas/request_list'
responses:
4xx:
description: Update status of Managed Transforms response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
managed_request_headers:
$ref: '#/components/schemas/response_list'
managed_response_headers:
$ref: '#/components/schemas/response_list'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update status of Managed Transforms response
content:
application/json:
schema:
type: object
properties:
managed_request_headers:
$ref: '#/components/schemas/response_list'
managed_response_headers:
$ref: '#/components/schemas/response_list'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/page_shield:
get:
tags:
- Page Shield
summary: Get Page Shield settings
description: Fetches the Page Shield settings.
operationId: page-shield-get-page-shield-settings
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Page Shield settings response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/get-zone-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Page Shield settings response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/get-zone-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Page Shield
summary: Update Page Shield settings
description: Updates Page Shield settings.
operationId: page-shield-update-page-shield-settings
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
enabled:
$ref: '#/components/schemas/script-monitor_components-schemas-enabled'
use_cloudflare_reporting_endpoint:
$ref: '#/components/schemas/use_cloudflare_reporting_endpoint'
use_connection_url_path:
$ref: '#/components/schemas/use_connection_url_path'
responses:
4xx:
description: Update Page Shield settings response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/update-zone-settings-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Page Shield settings response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/update-zone-settings-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/page_shield/connections:
get:
tags:
- Page Shield
summary: List Page Shield connections
description: Lists all connections detected by Page Shield.
operationId: page-shield-list-page-shield-connections
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Page Shield connections response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-zone-connections-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Page Shield connections response
content:
application/json:
schema:
$ref: '#/components/schemas/list-zone-connections-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/page_shield/connections/{id}:
get:
tags:
- Page Shield
summary: Get a Page Shield connection
description: Fetches a connection detected by Page Shield by connection ID.
operationId: page-shield-get-a-page-shield-connection
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/script-monitor_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a Page Shield connection response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/get-zone-connection-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Page Shield connection response
content:
application/json:
schema:
$ref: '#/components/schemas/get-zone-connection-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/page_shield/scripts:
get:
tags:
- Page Shield
summary: List Page Shield scripts
description: Lists all scripts detected by Page Shield.
operationId: page-shield-list-page-shield-scripts
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Page Shield scripts response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/list-zone-scripts-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Page Shield scripts response
content:
application/json:
schema:
$ref: '#/components/schemas/list-zone-scripts-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/page_shield/scripts/{id}:
get:
tags:
- Page Shield
summary: Get a Page Shield script
description: Fetches a script detected by Page Shield by script ID.
operationId: page-shield-get-a-page-shield-script
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/script-monitor_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a Page Shield script response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/get-zone-script-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Page Shield script response
content:
application/json:
schema:
$ref: '#/components/schemas/get-zone-script-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets:
get:
tags:
- Zone Rulesets
summary: List zone rulesets
description: Fetches all rulesets at the zone level.
operationId: zone-rulesets-list-zone-rulesets
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List zone rulesets response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List zone rulesets response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone Rulesets
summary: Create a zone ruleset
description: Creates a ruleset at the zone level.
operationId: zone-rulesets-create-a-zone-ruleset
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_ruleset'
responses:
4xx:
description: Create a zone ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a zone ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/{ruleset_id}:
delete:
tags:
- Zone Rulesets
summary: Delete a zone ruleset
description: Deletes all versions of an existing zone ruleset.
operationId: zone-rulesets-delete-a-zone-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a zone ruleset response failure
content:
application/json: {}
"200":
description: Delete a zone ruleset response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone Rulesets
summary: Get a zone ruleset
description: Fetches the latest version of a zone ruleset.
operationId: zone-rulesets-get-a-zone-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a zone ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a zone ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone Rulesets
summary: Update a zone ruleset
description: Updates a zone ruleset, creating a new version.
operationId: zone-rulesets-update-a-zone-ruleset
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update a zone ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a zone ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/{ruleset_id}/rules:
post:
tags:
- Zone Rulesets
summary: Create a zone ruleset rule
description: Adds a new rule to a zone ruleset. The rule will be added to the
end of the existing list of rules in the ruleset.
operationId: zone-rulesets-create-a-zone-ruleset-rule
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_update_rule'
responses:
4xx:
description: Create a zone ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a zone ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/{ruleset_id}/rules/{rule_id}:
delete:
tags:
- Zone Rulesets
summary: Delete a zone ruleset rule
description: Deletes an existing rule from a zone ruleset.
operationId: zone-rulesets-delete-a-zone-ruleset-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-id'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a zone ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a zone ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Rulesets
summary: Update a zone ruleset rule
description: Updates an existing rule in a zone ruleset.
operationId: zone-rulesets-update-a-zone-ruleset-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rules_components-schemas-id'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_update_rule'
responses:
4xx:
description: Update a zone ruleset rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a zone ruleset rule response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/{ruleset_id}/versions:
get:
tags:
- Zone Rulesets
summary: List a zone ruleset's versions
description: Fetches the versions of a zone ruleset.
operationId: zone-rulesets-list-a-zone-ruleset'-s-versions
parameters:
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List a zone ruleset's versions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List a zone ruleset's versions response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/{ruleset_id}/versions/{ruleset_version}:
delete:
tags:
- Zone Rulesets
summary: Delete a zone ruleset version
description: Deletes an existing version of a zone ruleset.
operationId: zone-rulesets-delete-a-zone-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a zone ruleset version response failure
content:
application/json: {}
"200":
description: Delete a zone ruleset version response
content:
application/json: {}
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone Rulesets
summary: Get a zone ruleset version
description: Fetches a specific version of a zone ruleset.
operationId: zone-rulesets-get-a-zone-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_id
in: path
required: true
schema:
$ref: '#/components/schemas/rulesets_components-schemas-id'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a zone ruleset version response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a zone ruleset version response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/phases/{phase}/entrypoint:
get:
tags:
- Transform Rules
summary: List Transform Rules
description: Fetches all Transform Rules in a zone.
operationId: transform-rules-list-transform-rules
parameters:
- name: phase
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Transform Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-ruleset'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Transform Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-ruleset'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Transform Rules
summary: Update Transform Rules
description: Updates the Transform Rules of a zone.
operationId: transform-rules-update-transform-rules
parameters:
- name: phase
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update Transform Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Transform Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint:
get:
tags:
- Zone Rulesets
summary: Get a zone entry point ruleset
description: Fetches the latest version of the zone entry point ruleset for
a given phase.
operationId: zone-rulesets-get-a-zone-entry-point-ruleset
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a zone entry point ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a zone entry point ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone Rulesets
summary: Update a zone entry point ruleset
description: Updates a zone entry point ruleset, creating a new version.
operationId: zone-rulesets-update-a-zone-entry-point-ruleset
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update a zone entry point ruleset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a zone entry point ruleset response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint/versions:
get:
tags:
- Zone Rulesets
summary: List a zone entry point ruleset's versions
description: Fetches the versions of a zone entry point ruleset.
operationId: zone-rulesets-list-a-zone-entry-point-ruleset'-s-versions
parameters:
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List a zone entry point ruleset's versions response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rulesets_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List a zone entry point ruleset's versions response
content:
application/json:
schema:
$ref: '#/components/schemas/rulesets_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint/versions/{ruleset_version}:
get:
tags:
- Zone Rulesets
summary: Get a zone entry point ruleset version
description: Fetches a specific version of a zone entry point ruleset.
operationId: zone-rulesets-get-a-zone-entry-point-ruleset-version
parameters:
- name: ruleset_version
in: path
required: true
schema:
$ref: '#/components/schemas/version'
- name: ruleset_phase
in: path
required: true
schema:
$ref: '#/components/schemas/phase'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a zone entry point ruleset version response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ruleset_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a zone entry point ruleset version response
content:
application/json:
schema:
$ref: '#/components/schemas/ruleset_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/rulesets/phases/http_custom_errors/entrypoint:
get:
tags:
- Custom Error Responses
summary: Get Custom Error Responses
description: Fetches all Custom Error Responses in a zone.
operationId: custom-error-responses-get-custom-error-responses
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Custom Error Responses response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-ruleset'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Custom Error Responses response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-ruleset'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Custom Error Responses
summary: Update Custom Error Responses
description: Updates the Custom Error Responses of a zone.
operationId: custom-error-responses-update-custom-error-responses
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_ruleset'
responses:
4xx:
description: Update Custom Error Responses response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Custom Error Responses response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/url_normalization:
get:
tags:
- URL Normalization
summary: Get URL normalization settings
description: Fetches the current URL normalization settings.
operationId: url-normalization-get-url-normalization-settings
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get URL normalization settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_model'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get URL normalization settings response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_model'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- URL Normalization
summary: Update URL normalization settings
description: Updates the URL normalization settings.
operationId: url-normalization-update-url-normalization-settings
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-request_model'
responses:
4xx:
description: Update URL normalization settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_model'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update URL normalization settings response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_model'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/workers/filters:
get:
tags:
- Worker Filters (Deprecated)
summary: List Filters
operationId: worker-filters-(-deprecated)-list-filters
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Filters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Filters response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-response-collection'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Worker Filters (Deprecated)
summary: Create Filter
operationId: worker-filters-(-deprecated)-create-filter
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/filter-no-id'
responses:
4xx:
description: Create Filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Filter response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/workers/filters/{filter_id}:
delete:
tags:
- Worker Filters (Deprecated)
summary: Delete Filter
operationId: worker-filters-(-deprecated)-delete-filter
parameters:
- name: filter_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Filter response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Filters (Deprecated)
summary: Update Filter
operationId: worker-filters-(-deprecated)-update-filter
parameters:
- name: filter_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/filter-no-id'
responses:
4xx:
description: Update Filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Filter response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-response-single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/workers/routes:
get:
tags:
- Worker Routes
summary: List Routes
operationId: worker-routes-list-routes
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Routes response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Routes response
content:
application/json:
schema:
$ref: '#/components/schemas/route-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Worker Routes
summary: Create Route
operationId: worker-routes-create-route
parameters:
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/route-no-id'
responses:
4xx:
description: Create Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Route response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_id}/workers/routes/{route_id}:
delete:
tags:
- Worker Routes
summary: Delete Route
operationId: worker-routes-delete-route
parameters:
- name: route_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Route response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Worker Routes
summary: Get Route
operationId: worker-routes-get-route
parameters:
- name: route_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Route response
content:
application/json:
schema:
$ref: '#/components/schemas/route-response-single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Routes
summary: Update Route
operationId: worker-routes-update-route
parameters:
- name: route_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_id
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/route-no-id'
responses:
4xx:
description: Update Route response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/route-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Route response
content:
application/json:
schema:
$ref: '#/components/schemas/route-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/acm/total_tls:
get:
tags:
- Total TLS
summary: Total TLS Settings Details
description: Get Total TLS Settings for a Zone.
operationId: total-tls-total-tls-settings-details
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Total TLS Settings Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/total_tls_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Total TLS Settings Details response
content:
application/json:
schema:
$ref: '#/components/schemas/total_tls_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Total TLS
summary: Enable or Disable Total TLS
description: Set Total TLS Settings or disable the feature for a Zone.
operationId: total-tls-enable-or-disable-total-tls
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- enabled
properties:
certificate_authority:
$ref: '#/components/schemas/schemas-certificate_authority'
enabled:
$ref: '#/components/schemas/total-tls_components-schemas-enabled'
responses:
4xx:
description: Enable or Disable Total TLS response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/total_tls_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable or Disable Total TLS response
content:
application/json:
schema:
$ref: '#/components/schemas/total_tls_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/analytics/colos:
get:
tags:
- Zone Analytics (Deprecated)
summary: Get analytics by Co-locations
description: 'This view provides a breakdown of analytics data by datacenter.
Note: This is available to Enterprise customers only.'
operationId: zone-analytics-(-deprecated)-get-analytics-by-co-locations
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get analytics by Co-locations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/colo_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get analytics by Co-locations response
content:
application/json:
schema:
$ref: '#/components/schemas/colo_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/analytics/dashboard:
get:
tags:
- Zone Analytics (Deprecated)
summary: Get dashboard
description: The dashboard view provides both totals and timeseries data for
the given zone and time period across the entire Cloudflare network.
operationId: zone-analytics-(-deprecated)-get-dashboard
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get dashboard response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dashboard_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get dashboard response
content:
application/json:
schema:
$ref: '#/components/schemas/dashboard_response'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/analytics/latency:
get:
tags:
- Argo Analytics for Zone
summary: Argo Analytics for a zone
operationId: argo-analytics-for-zone-argo-analytics-for-a-zone
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Argo Analytics for a zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Argo Analytics for a zone response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/analytics/latency/colos:
get:
tags:
- Argo Analytics for Geolocation
summary: Argo Analytics for a zone at different PoPs
operationId: argo-analytics-for-geolocation-argo-analytics-for-a-zone-at-different-po-ps
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Argo Analytics for a zone at different PoPs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Argo Analytics for a zone at different PoPs response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/argo/smart_routing:
get:
tags:
- Argo Smart Routing
summary: Get Argo Smart Routing setting
operationId: argo-smart-routing-get-argo-smart-routing-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Argo Smart Routing setting response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Argo Smart Routing setting response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Argo Smart Routing
summary: Patch Argo Smart Routing setting
description: Updates enablement of Argo Smart Routing.
operationId: argo-smart-routing-patch-argo-smart-routing-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/patch'
responses:
4xx:
description: Patch Argo Smart Routing setting response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Argo Smart Routing setting response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/available_plans:
get:
tags:
- Zone Rate Plan
summary: List Available Plans
description: Lists available plans the zone can subscribe to.
operationId: zone-rate-plan-list-available-plans
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Available Plans response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/available-rate-plan'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Available Plans response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-collection'
- properties:
result:
type: array
items:
$ref: '#/components/schemas/available-rate-plan'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/available_plans/{plan_identifier}:
get:
tags:
- Zone Rate Plan
summary: Available Plan Details
description: Details of the available plan that the zone can subscribe to.
operationId: zone-rate-plan-available-plan-details
parameters:
- name: plan_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Available Plan Details response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/available-rate-plan'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Available Plan Details response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
$ref: '#/components/schemas/available-rate-plan'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/available_rate_plans:
get:
tags:
- Zone Rate Plan
summary: List Available Rate Plans
description: Lists all rate plans the zone can subscribe to.
operationId: zone-rate-plan-list-available-rate-plans
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Available Rate Plans response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/plan_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Available Rate Plans response
content:
application/json:
schema:
$ref: '#/components/schemas/plan_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/cache/cache_reserve:
get:
tags:
- Zone Cache Settings
summary: Get Cache Reserve setting
description: 'Increase cache lifetimes by automatically storing all cacheable
files into Cloudflare''s persistent object storage buckets. Requires Cache
Reserve subscription. Note: using Tiered Cache with Cache Reserve is highly
recommended to reduce Reserve operations costs. See the [developer docs](https://developers.cloudflare.com/cache/about/cache-reserve)
for more information.'
operationId: zone-cache-settings-get-cache-reserve-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Cache Reserve setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/cache_reserve_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Cache Reserve setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/cache_reserve_response_value'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Cache Settings
summary: Change Cache Reserve setting
description: 'Increase cache lifetimes by automatically storing all cacheable
files into Cloudflare''s persistent object storage buckets. Requires Cache
Reserve subscription. Note: using Tiered Cache with Cache Reserve is highly
recommended to reduce Reserve operations costs. See the [developer docs](https://developers.cloudflare.com/cache/about/cache-reserve)
for more information.'
operationId: zone-cache-settings-change-cache-reserve-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/cache_reserve_value'
responses:
4xx:
description: Change Cache Reserve setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/cache_reserve_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Cache Reserve setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/cache_reserve_response_value'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/cache/variants:
delete:
tags:
- Zone Cache Settings
summary: Delete variants setting
description: 'Variant support enables caching variants of images with certain
file extensions in addition to the original. This only applies when the origin
server sends the ''Vary: Accept'' response header. If the origin server sends
''Vary: Accept'' but does not serve the variant requested, the response will
not be cached. This will be indicated with BYPASS cache status in the response
headers.'
operationId: zone-cache-settings-delete-variants-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete variants setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/variants'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete variants setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/variants'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone Cache Settings
summary: Get variants setting
description: 'Variant support enables caching variants of images with certain
file extensions in addition to the original. This only applies when the origin
server sends the ''Vary: Accept'' response header. If the origin server sends
''Vary: Accept'' but does not serve the variant requested, the response will
not be cached. This will be indicated with BYPASS cache status in the response
headers.'
operationId: zone-cache-settings-get-variants-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get variants setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/variants_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get variants setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/variants_response_value'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Cache Settings
summary: Change variants setting
description: 'Variant support enables caching variants of images with certain
file extensions in addition to the original. This only applies when the origin
server sends the ''Vary: Accept'' response header. If the origin server sends
''Vary: Accept'' but does not serve the variant requested, the response will
not be cached. This will be indicated with BYPASS cache status in the response
headers.'
operationId: zone-cache-settings-change-variants-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/variants_value'
responses:
4xx:
description: Change variants setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/variants_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change variants setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_cache_settings_response_single'
- $ref: '#/components/schemas/variants_response_value'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_certificates:
get:
tags:
- Custom SSL for a Zone
summary: List SSL Configurations
description: List, search, and filter all of your custom SSL certificates. The
higher priority will break ties across overlapping 'legacy_custom' certificates,
but 'legacy_custom' certificates will always supercede 'sni_custom' certificates.
operationId: custom-ssl-for-a-zone-list-ssl-configurations
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List SSL Configurations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List SSL Configurations response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Custom SSL for a Zone
summary: Create SSL Configuration
description: Upload a new SSL certificate for a zone.
operationId: custom-ssl-for-a-zone-create-ssl-configuration
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- certificate
- private_key
properties:
bundle_method:
$ref: '#/components/schemas/bundle_method'
certificate:
$ref: '#/components/schemas/certificate'
geo_restrictions:
$ref: '#/components/schemas/geo_restrictions'
policy:
$ref: '#/components/schemas/policy'
private_key:
$ref: '#/components/schemas/private_key'
type:
$ref: '#/components/schemas/custom-certificate_components-schemas-type'
responses:
4xx:
description: Create SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_certificates/{identifier}:
delete:
tags:
- Custom SSL for a Zone
summary: Delete SSL Configuration
description: Remove a SSL certificate from a zone.
operationId: custom-ssl-for-a-zone-delete-ssl-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_id_only'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_id_only'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Custom SSL for a Zone
summary: SSL Configuration Details
operationId: custom-ssl-for-a-zone-ssl-configuration-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: SSL Configuration Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: SSL Configuration Details response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Custom SSL for a Zone
summary: Edit SSL Configuration
description: 'Upload a new private key and/or PEM/CRT for the SSL certificate.
Note: PATCHing a configuration for sni_custom certificates will result in
a new resource id being returned, and the previous one being deleted.'
operationId: custom-ssl-for-a-zone-edit-ssl-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
bundle_method:
$ref: '#/components/schemas/bundle_method'
certificate:
$ref: '#/components/schemas/certificate'
geo_restrictions:
$ref: '#/components/schemas/geo_restrictions'
policy:
$ref: '#/components/schemas/policy'
private_key:
$ref: '#/components/schemas/private_key'
responses:
4xx:
description: Edit SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_certificates/prioritize:
put:
tags:
- Custom SSL for a Zone
summary: Re-prioritize SSL Certificates
description: If a zone has multiple SSL certificates, you can set the order
in which they should be used during a request. The higher priority will break
ties across overlapping 'legacy_custom' certificates.
operationId: custom-ssl-for-a-zone-re-prioritize-ssl-certificates
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- certificates
properties:
certificates:
type: array
description: Array of ordered certificates.
example:
- id: 5a7805061c76ada191ed06f989cc3dac
priority: 2
- id: 9a7806061c88ada191ed06f989cc3dac
priority: 1
items:
type: object
properties:
id:
$ref: '#/components/schemas/custom-certificate_components-schemas-identifier'
priority:
$ref: '#/components/schemas/schemas-priority'
responses:
4xx:
description: Re-prioritize SSL Certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Re-prioritize SSL Certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_hostnames:
get:
tags:
- Custom Hostname for a Zone
summary: List Custom Hostnames
description: List, search, sort, and filter all of your custom hostnames.
operationId: custom-hostname-for-a-zone-list-custom-hostnames
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Custom Hostnames response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_hostname_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Custom Hostnames response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_hostname_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Custom Hostname for a Zone
summary: Create Custom Hostname
description: Add a new custom hostname and request that an SSL certificate be
issued for it. One of three validation methods—http, txt, email—should be
used, with 'http' recommended if the CNAME is already in place (or will be
soon). Specifying 'email' will send an email to the WHOIS contacts on file
for the base domain plus hostmaster, postmaster, webmaster, admin, administrator.
If http is used and the domain is not already pointing to the Managed CNAME
host, the PATCH method must be used once it is (to complete validation).
operationId: custom-hostname-for-a-zone-create-custom-hostname
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- hostname
- ssl
properties:
hostname:
$ref: '#/components/schemas/hostname'
ssl:
$ref: '#/components/schemas/sslpost'
responses:
4xx:
description: Create Custom Hostname response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_hostname_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Custom Hostname response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_hostname_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_hostnames/{identifier}:
delete:
tags:
- Custom Hostname for a Zone
summary: Delete Custom Hostname (and any issued SSL certificates)
operationId: custom-hostname-for-a-zone-delete-custom-hostname-(-and-any-issued-ssl-certificates)
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Custom Hostname (and any issued SSL certificates) response
failure
content:
application/json:
schema:
allOf:
- type: object
properties:
id:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Custom Hostname (and any issued SSL certificates) response
content:
application/json:
schema:
type: object
properties:
id:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Custom Hostname for a Zone
summary: Custom Hostname Details
operationId: custom-hostname-for-a-zone-custom-hostname-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Custom Hostname Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_hostname_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Custom Hostname Details response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_hostname_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Custom Hostname for a Zone
summary: Edit Custom Hostname
description: Modify SSL configuration for a custom hostname. When sent with
SSL config that matches existing config, used to indicate that hostname should
pass domain control validation (DCV). Can also be used to change validation
type, e.g., from 'http' to 'email'.
operationId: custom-hostname-for-a-zone-edit-custom-hostname
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-hostname_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
custom_metadata:
$ref: '#/components/schemas/custom_metadata'
custom_origin_server:
$ref: '#/components/schemas/custom_origin_server'
custom_origin_sni:
$ref: '#/components/schemas/custom_origin_sni'
ssl:
$ref: '#/components/schemas/sslpost'
responses:
4xx:
description: Edit Custom Hostname response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_hostname_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Custom Hostname response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_hostname_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_hostnames/fallback_origin:
delete:
tags:
- Custom Hostname Fallback Origin for a Zone
summary: Delete Fallback Origin for Custom Hostnames
operationId: custom-hostname-fallback-origin-for-a-zone-delete-fallback-origin-for-custom-hostnames
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Fallback Origin for Custom Hostnames response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_origin_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Fallback Origin for Custom Hostnames response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_origin_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Custom Hostname Fallback Origin for a Zone
summary: Get Fallback Origin for Custom Hostnames
operationId: custom-hostname-fallback-origin-for-a-zone-get-fallback-origin-for-custom-hostnames
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Fallback Origin for Custom Hostnames response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_origin_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Fallback Origin for Custom Hostnames response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_origin_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Custom Hostname Fallback Origin for a Zone
summary: Update Fallback Origin for Custom Hostnames
operationId: custom-hostname-fallback-origin-for-a-zone-update-fallback-origin-for-custom-hostnames
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- origin
properties:
origin:
$ref: '#/components/schemas/origin'
responses:
4xx:
description: Update Fallback Origin for Custom Hostnames response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fallback_origin_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Fallback Origin for Custom Hostnames response
content:
application/json:
schema:
$ref: '#/components/schemas/fallback_origin_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_ns:
get:
tags:
- Account-Level Custom Nameservers Usage for a Zone
summary: Get Account Custom Nameserver Related Zone Metadata
operationId: account-level-custom-nameservers-usage-for-a-zone-get-account-custom-nameserver-related-zone-metadata
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Account Custom Nameserver Related Zone Metadata response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/get_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Account Custom Nameserver Related Zone Metadata response
content:
application/json:
schema:
$ref: '#/components/schemas/get_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Account-Level Custom Nameservers Usage for a Zone
summary: Set Account Custom Nameserver Related Zone Metadata
operationId: account-level-custom-nameservers-usage-for-a-zone-set-account-custom-nameserver-related-zone-metadata
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/zone_metadata'
responses:
4xx:
description: Set Account Custom Nameserver Related Zone Metadata response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/empty_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Account Custom Nameserver Related Zone Metadata response
content:
application/json:
schema:
$ref: '#/components/schemas/empty_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_pages:
get:
tags:
- Custom pages for a zone
summary: List custom pages
description: Fetches all the custom pages at the zone level.
operationId: custom-pages-for-a-zone-list-custom-pages
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List custom pages response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List custom pages response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/custom_pages/{identifier}:
get:
tags:
- Custom pages for a zone
summary: Get a custom page
description: Fetches the details of a custom page.
operationId: custom-pages-for-a-zone-get-a-custom-page
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-pages_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a custom page response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a custom page response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Custom pages for a zone
summary: Update a custom page
description: Updates the configuration of an existing custom page.
operationId: custom-pages-for-a-zone-update-a-custom-page
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/custom-pages_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- url
- state
properties:
state:
$ref: '#/components/schemas/schemas-state'
url:
$ref: '#/components/schemas/url'
responses:
4xx:
description: Update a custom page response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/custom_pages_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a custom page response
content:
application/json:
schema:
$ref: '#/components/schemas/custom_pages_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dns_records:
get:
tags:
- DNS Records for a Zone
summary: List DNS Records
description: List, search, sort, and filter a zones' DNS records.
operationId: dns-records-for-a-zone-list-dns-records
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List DNS Records response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List DNS Records response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- DNS Records for a Zone
summary: Create DNS Record
description: Create a new DNS record for a zone. See the record object definitions
for required attributes for each record type.
operationId: dns-records-for-a-zone-create-dns-record
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- type
- name
- content
- ttl
properties:
content:
$ref: '#/components/schemas/content'
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
priority:
$ref: '#/components/schemas/priority'
proxied:
$ref: '#/components/schemas/proxied'
ttl:
$ref: '#/components/schemas/ttl'
type:
$ref: '#/components/schemas/dns-record_components-schemas-type'
responses:
4xx:
description: Create DNS Record response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create DNS Record response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dns_records/{identifier}:
delete:
tags:
- DNS Records for a Zone
summary: Delete DNS Record
operationId: dns-records-for-a-zone-delete-dns-record
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete DNS Record response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete DNS Record response
content:
application/json:
schema:
type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- DNS Records for a Zone
summary: DNS Record Details
operationId: dns-records-for-a-zone-dns-record-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: DNS Record Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: DNS Record Details response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- DNS Records for a Zone
summary: Patch DNS Record
operationId: dns-records-for-a-zone-patch-dns-record
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
content:
$ref: '#/components/schemas/content'
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
proxied:
$ref: '#/components/schemas/proxied'
ttl:
$ref: '#/components/schemas/ttl'
type:
$ref: '#/components/schemas/dns-record_components-schemas-type'
responses:
4xx:
description: Patch DNS Record response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch DNS Record response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- DNS Records for a Zone
summary: Update DNS Record
operationId: dns-records-for-a-zone-update-dns-record
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/dns-record_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- type
- name
- content
- ttl
properties:
content:
$ref: '#/components/schemas/content'
name:
$ref: '#/components/schemas/dns-record_components-schemas-name'
proxied:
$ref: '#/components/schemas/proxied'
ttl:
$ref: '#/components/schemas/ttl'
type:
$ref: '#/components/schemas/dns-record_components-schemas-type'
responses:
4xx:
description: Update DNS Record response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update DNS Record response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dns_records/export:
get:
tags:
- DNS Records for a Zone
summary: Export DNS Records
description: You can export your [BIND config](https://en.wikipedia.org/wiki/Zone_file
"Zone file") through this endpoint.
operationId: dns-records-for-a-zone-export-dns-records
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Export DNS Records response failure
content:
application/json:
schema:
allOf:
- {}
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Export DNS Records response
content:
application/json:
schema: {}
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dns_records/import:
post:
tags:
- DNS Records for a Zone
summary: Import DNS Records
description: You can upload your [BIND config](https://en.wikipedia.org/wiki/Zone_file
"Zone file") through this endpoint. It assumes that cURL is called from a
location with bind_config.txt (valid BIND config) present.
operationId: dns-records-for-a-zone-import-dns-records
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- file
properties:
file:
type: string
description: BIND config to upload.
example: '@bind_config.txt'
proxied:
type: boolean
description: Whether or not proxiable records should receive the
performance and security benefits of Cloudflare.
example: false
responses:
4xx:
description: Import DNS Records response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_import_scan'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Import DNS Records response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_import_scan'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dns_records/scan:
post:
tags:
- DNS Records for a Zone
summary: Scan DNS Records
description: Scan for common DNS records on your domain and automatically add
them to your zone. Useful if you haven't updated your nameservers yet.
operationId: dns-records-for-a-zone-scan-dns-records
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Scan DNS Records response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns_response_import_scan'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Scan DNS Records response
content:
application/json:
schema:
$ref: '#/components/schemas/dns_response_import_scan'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/dnssec:
delete:
tags:
- DNSSEC
summary: Delete DNSSEC records
description: Delete DNSSEC.
operationId: dnssec-delete-dnssec-records
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete DNSSEC records response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/delete_dnssec_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete DNSSEC records response
content:
application/json:
schema:
$ref: '#/components/schemas/delete_dnssec_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- DNSSEC
summary: DNSSEC Details
description: Details about DNSSEC status and configuration.
operationId: dnssec-dnssec-details
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: DNSSEC Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dnssec_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: DNSSEC Details response
content:
application/json:
schema:
$ref: '#/components/schemas/dnssec_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- DNSSEC
summary: Edit DNSSEC Status
description: Enable or disable DNSSEC.
operationId: dnssec-edit-dnssec-status
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- status
properties:
status:
description: Status of DNSSEC, based on user-desired state and presence
of necessary records.
enum:
- active
- disabled
example: active
responses:
4xx:
description: Edit DNSSEC Status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dnssec_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit DNSSEC Status response
content:
application/json:
schema:
$ref: '#/components/schemas/dnssec_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing:
get:
tags:
- Email Routing settings
summary: Get Email Routing settings
description: Get information about the settings for your Email Routing zone.
operationId: email-routing-settings-get-email-routing-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Email Routing settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email-settings_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Email Routing settings response
content:
application/json:
schema:
$ref: '#/components/schemas/email-settings_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/disable:
post:
tags:
- Email Routing settings
summary: Disable Email Routing
description: Disable your Email Routing zone. Also removes additional MX records
previously required for Email Routing to work.
operationId: email-routing-settings-disable-email-routing
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Disable Email Routing response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email-settings_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Disable Email Routing response
content:
application/json:
schema:
$ref: '#/components/schemas/email-settings_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/dns:
get:
tags:
- Email Routing settings
summary: Email Routing - DNS settings
description: Show the DNS records needed to configure your Email Routing zone.
operationId: email-routing-settings-email-routing-dns-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Email Routing - DNS settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/dns-settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Email Routing - DNS settings response
content:
application/json:
schema:
$ref: '#/components/schemas/dns-settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/enable:
post:
tags:
- Email Routing settings
summary: Enable Email Routing
description: Enable you Email Routing zone. Add and lock the necessary MX and
SPF records.
operationId: email-routing-settings-enable-email-routing
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Enable Email Routing response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email-settings_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable Email Routing response
content:
application/json:
schema:
$ref: '#/components/schemas/email-settings_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/rules:
get:
tags:
- Email Routing routing rules
summary: List routing rules
description: Lists existing routing rules.
operationId: email-routing-routing-rules-list-routing-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List routing rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List routing rules response
content:
application/json:
schema:
$ref: '#/components/schemas/rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Email Routing routing rules
summary: Create routing rule
description: Rules consist of a set of criteria for matching emails (such as
an email being sent to a specific custom email address) plus a set of actions
to take on the email (like forwarding it to a specific destination address).
operationId: email-routing-routing-rules-create-routing-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_rule_properties'
responses:
4xx:
description: Create routing rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create routing rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/rules/{rule_identifier}:
delete:
tags:
- Email Routing routing rules
summary: Delete routing rule
description: Delete a specific routing rule.
operationId: email-routing-routing-rules-delete-routing-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete routing rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete routing rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Email Routing routing rules
summary: Get routing rule
description: Get information for a specific routing rule already created.
operationId: email-routing-routing-rules-get-routing-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get routing rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get routing rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Email Routing routing rules
summary: Update routing rule
description: Update actions and matches, or enable/disable specific routing
rules.
operationId: email-routing-routing-rules-update-routing-rule
parameters:
- name: rule_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/rule_identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_rule_properties'
responses:
4xx:
description: Update routing rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update routing rule response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/email/routing/rules/catch_all:
get:
tags:
- Email Routing routing rules
summary: Get catch-all rule
description: Get information on the default catch-all routing rule.
operationId: email-routing-routing-rules-get-catch-all-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get catch-all rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/catch_all_rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get catch-all rule response
content:
application/json:
schema:
$ref: '#/components/schemas/catch_all_rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Email Routing routing rules
summary: Update catch-all rule
description: Enable or disable catch-all routing rule, or change action to forward
to specific destination address.
operationId: email-routing-routing-rules-update-catch-all-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_catch_all_rule_properties'
responses:
4xx:
description: Update catch-all rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/catch_all_rule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update catch-all rule response
content:
application/json:
schema:
$ref: '#/components/schemas/catch_all_rule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/filters:
delete:
tags:
- Filters
summary: Delete filters
description: Deletes one or more existing filters.
operationId: filters-delete-filters
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- id
properties:
id:
$ref: '#/components/schemas/filters_components-schemas-id'
responses:
4xx:
description: Delete filters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-delete-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete filters response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-delete-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Filters
summary: List filters
description: Fetches filters in a zone. You can filter the results using several
optional parameters.
operationId: filters-list-filters
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List filters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-filter-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List filters response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-filter-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Filters
summary: Create filters
description: Creates one or more filters.
operationId: filters-create-filters
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- expression
responses:
4xx:
description: Create filters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-filter-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create filters response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-filter-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Filters
summary: Update filters
description: Updates one or more existing filters.
operationId: filters-update-filters
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update filters response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-filter-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update filters response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-filter-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/filters/{id}:
delete:
tags:
- Filters
summary: Delete a filter
description: Deletes an existing filter.
operationId: filters-delete-a-filter
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/filters_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-delete-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a filter response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-delete-response-single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Filters
summary: Get a filter
description: Fetches the details of a filter.
operationId: filters-get-a-filter
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/filters_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-filter-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a filter response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-filter-response-single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Filters
summary: Update a filter
description: Updates an existing filter.
operationId: filters-update-a-filter
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/filters_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update a filter response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-filter-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a filter response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-filter-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/lockdowns:
get:
tags:
- Zone Lockdown
summary: List Zone Lockdown rules
description: Fetches Zone Lockdown rules. You can filter the results using several
optional parameters.
operationId: zone-lockdown-list-zone-lockdown-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Zone Lockdown rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zonelockdown_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Zone Lockdown rules response
content:
application/json:
schema:
$ref: '#/components/schemas/zonelockdown_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone Lockdown
summary: Create a Zone Lockdown rule
description: Creates a new Zone Lockdown rule.
operationId: zone-lockdown-create-a-zone-lockdown-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- urls
- configurations
responses:
4xx:
description: Create a Zone Lockdown rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zonelockdown_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Zone Lockdown rule response
content:
application/json:
schema:
$ref: '#/components/schemas/zonelockdown_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/lockdowns/{id}:
delete:
tags:
- Zone Lockdown
summary: Delete a Zone Lockdown rule
description: Deletes an existing Zone Lockdown rule.
operationId: zone-lockdown-delete-a-zone-lockdown-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Zone Lockdown rule response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Zone Lockdown rule response
content:
application/json:
schema:
type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone Lockdown
summary: Get a Zone Lockdown rule
description: Fetches the details of a Zone Lockdown rule.
operationId: zone-lockdown-get-a-zone-lockdown-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a Zone Lockdown rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zonelockdown_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Zone Lockdown rule response
content:
application/json:
schema:
$ref: '#/components/schemas/zonelockdown_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone Lockdown
summary: Update a Zone Lockdown rule
description: Updates an existing Zone Lockdown rule.
operationId: zone-lockdown-update-a-zone-lockdown-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/lockdowns_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- urls
- configurations
responses:
4xx:
description: Update a Zone Lockdown rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zonelockdown_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Zone Lockdown rule response
content:
application/json:
schema:
$ref: '#/components/schemas/zonelockdown_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/rules:
delete:
tags:
- Firewall rules
summary: Delete firewall rules
description: Deletes existing firewall rules.
operationId: firewall-rules-delete-firewall-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- id
properties:
id:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
responses:
4xx:
description: Delete firewall rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection-delete'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete firewall rules response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection-delete'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Firewall rules
summary: List firewall rules
description: Fetches firewall rules in a zone. You can filter the results using
several optional parameters.
operationId: firewall-rules-list-firewall-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List firewall rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List firewall rules response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Firewall rules
summary: Update priority of firewall rules
description: Updates the priority of existing firewall rules.
operationId: firewall-rules-update-priority-of-firewall-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update priority of firewall rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update priority of firewall rules response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Firewall rules
summary: Create firewall rules
description: Create one or more firewall rules.
operationId: firewall-rules-create-firewall-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- filter
- action
responses:
4xx:
description: Create firewall rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create firewall rules response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Firewall rules
summary: Update firewall rules
description: Updates one or more existing firewall rules.
operationId: firewall-rules-update-firewall-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update firewall rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update firewall rules response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/rules/{id}:
delete:
tags:
- Firewall rules
summary: Delete a firewall rule
description: Deletes an existing firewall rule.
operationId: firewall-rules-delete-a-firewall-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
delete_filter_if_unused:
$ref: '#/components/schemas/delete_filter_if_unused'
responses:
4xx:
description: Delete a firewall rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-single-response-delete'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a firewall rule response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-single-response-delete'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Firewall rules
summary: Get a firewall rule
description: Fetches the details of a firewall rule.
operationId: firewall-rules-get-a-firewall-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a firewall rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-single-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a firewall rule response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-single-response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Firewall rules
summary: Update priority of a firewall rule
description: Updates the priority of an existing firewall rule.
operationId: firewall-rules-update-priority-of-a-firewall-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
responses:
4xx:
description: Update priority of a firewall rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-response-collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update priority of a firewall rule response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-response-collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Firewall rules
summary: Update a firewall rule
description: Updates an existing firewall rule.
operationId: firewall-rules-update-a-firewall-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/firewall-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
- filter
- action
responses:
4xx:
description: Update a firewall rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/filter-rules-single-response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a firewall rule response
content:
application/json:
schema:
$ref: '#/components/schemas/filter-rules-single-response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/ua_rules:
get:
tags:
- User Agent Blocking rules
summary: List User Agent Blocking rules
description: Fetches User Agent Blocking rules in a zone. You can filter the
results using several optional parameters.
operationId: user-agent-blocking-rules-list-user-agent-blocking-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List User Agent Blocking rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/firewalluablock_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List User Agent Blocking rules response
content:
application/json:
schema:
$ref: '#/components/schemas/firewalluablock_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- User Agent Blocking rules
summary: Create a User Agent Blocking rule
description: Creates a new User Agent Blocking rule in a zone.
operationId: user-agent-blocking-rules-create-a-user-agent-blocking-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- mode
- configuration
responses:
4xx:
description: Create a User Agent Blocking rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/firewalluablock_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a User Agent Blocking rule response
content:
application/json:
schema:
$ref: '#/components/schemas/firewalluablock_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/ua_rules/{id}:
delete:
tags:
- User Agent Blocking rules
summary: Delete a User Agent Blocking rule
description: Deletes an existing User Agent Blocking rule.
operationId: user-agent-blocking-rules-delete-a-user-agent-blocking-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a User Agent Blocking rule response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/firewalluablock_response_single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a User Agent Blocking rule response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/firewalluablock_response_single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- User Agent Blocking rules
summary: Get a User Agent Blocking rule
description: Fetches the details of a User Agent Blocking rule.
operationId: user-agent-blocking-rules-get-a-user-agent-blocking-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a User Agent Blocking rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/firewalluablock_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a User Agent Blocking rule response
content:
application/json:
schema:
$ref: '#/components/schemas/firewalluablock_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- User Agent Blocking rules
summary: Update a User Agent Blocking rule
description: Updates an existing User Agent Blocking rule.
operationId: user-agent-blocking-rules-update-a-user-agent-blocking-rule
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/ua-rules_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
- mode
- configuration
responses:
4xx:
description: Update a User Agent Blocking rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/firewalluablock_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a User Agent Blocking rule response
content:
application/json:
schema:
$ref: '#/components/schemas/firewalluablock_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/overrides:
get:
tags:
- WAF overrides
summary: List WAF overrides
description: Fetches the URI-based WAF overrides in a zone.
operationId: waf-overrides-list-waf-overrides
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List WAF overrides response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/override_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List WAF overrides response
content:
application/json:
schema:
$ref: '#/components/schemas/override_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- WAF overrides
summary: Create a WAF override
description: Creates a URI-based WAF override for a zone.
operationId: waf-overrides-create-a-waf-override
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- urls
responses:
4xx:
description: Create a WAF override response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/override_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a WAF override response
content:
application/json:
schema:
$ref: '#/components/schemas/override_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/overrides/{id}:
delete:
tags:
- WAF overrides
summary: Delete a WAF override
description: Deletes an existing URI-based WAF override.
operationId: waf-overrides-delete-a-waf-override
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/overrides_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a WAF override response failure
content:
application/json:
schema:
allOf:
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/overrides_components-schemas-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a WAF override response
content:
application/json:
schema:
type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/overrides_components-schemas-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- WAF overrides
summary: Get a WAF override
description: Fetches the details of a URI-based WAF override.
operationId: waf-overrides-get-a-waf-override
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/overrides_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a WAF override response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/override_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a WAF override response
content:
application/json:
schema:
$ref: '#/components/schemas/override_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- WAF overrides
summary: Update WAF override
description: Updates an existing URI-based WAF override.
operationId: waf-overrides-update-waf-override
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/overrides_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
- urls
- rules
- rewrite_action
responses:
4xx:
description: Update WAF override response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/override_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update WAF override response
content:
application/json:
schema:
$ref: '#/components/schemas/override_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/packages:
get:
tags:
- WAF packages
summary: List WAF packages
description: Fetches WAF packages for a zone.
operationId: waf-packages-list-waf-packages
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List WAF packages response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/package_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List WAF packages response
content:
application/json:
schema:
$ref: '#/components/schemas/package_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/packages/{identifier}:
get:
tags:
- WAF packages
summary: Get a WAF package
description: Fetches the details of a WAF package.
operationId: waf-packages-get-a-waf-package
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a WAF package response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/package_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a WAF package response
content:
application/json:
schema:
$ref: '#/components/schemas/package_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- WAF packages
summary: Update a WAF package
description: Updates a WAF package. You can update the sensitivity and the action
of an anomaly detection WAF package.
operationId: waf-packages-update-a-waf-package
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action_mode:
$ref: '#/components/schemas/action_mode'
sensitivity:
$ref: '#/components/schemas/sensitivity'
responses:
4xx:
description: Update a WAF package response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/package_response_single'
- properties:
result:
$ref: '#/components/schemas/anomaly_package'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a WAF package response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/package_response_single'
- properties:
result:
$ref: '#/components/schemas/anomaly_package'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/packages/{package_identifier}/groups:
get:
tags:
- WAF rule groups
summary: List WAF rule groups
description: Fetches the WAF rule groups in a WAF package.
operationId: waf-rule-groups-list-waf-rule-groups
parameters:
- name: package_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List WAF rule groups response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_group_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List WAF rule groups response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_group_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/firewall/waf/packages/{package_identifier}/groups/{identifier}:
get:
tags:
- WAF rule groups
summary: Get a WAF rule group
description: Fetches the details of a WAF rule group.
operationId: waf-rule-groups-get-a-waf-rule-group
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/group_components-schemas-identifier'
- name: package_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a WAF rule group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_group_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a WAF rule group response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_group_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- WAF rule groups
summary: Update a WAF rule group
description: Updates a WAF rule group. You can update the state (`mode` parameter)
of a rule group.
operationId: waf-rule-groups-update-a-waf-rule-group
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/group_components-schemas-identifier'
- name: package_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/package_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
mode:
$ref: '#/components/schemas/components-schemas-mode'
responses:
4xx:
description: Update a WAF rule group response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rule_group_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a WAF rule group response
content:
application/json:
schema:
$ref: '#/components/schemas/rule_group_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/healthchecks:
get:
tags:
- Health Checks
summary: List Health Checks
description: List configured health checks.
operationId: health-checks-list-health-checks
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Health Checks response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Health Checks response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Health Checks
summary: Create Health Check
description: Create a new health check.
operationId: health-checks-create-health-check
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_healthcheck'
responses:
4xx:
description: Create Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/healthchecks/{identifier}:
delete:
tags:
- Health Checks
summary: Delete Health Check
description: Delete a health check.
operationId: health-checks-delete-health-check
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Health Checks
summary: Health Check Details
description: Fetch a single configured health check.
operationId: health-checks-health-check-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Health Check Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Health Check Details response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Health Checks
summary: Patch Health Check
description: Patch a configured health check.
operationId: health-checks-patch-health-check
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_healthcheck'
responses:
4xx:
description: Patch Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Health Checks
summary: Update Health Check
description: Update a configured health check.
operationId: health-checks-update-health-check
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_healthcheck'
responses:
4xx:
description: Update Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/healthchecks/preview:
post:
tags:
- Health Checks
summary: Create Preview Health Check
description: Create a new preview health check.
operationId: health-checks-create-preview-health-check
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_healthcheck'
responses:
4xx:
description: Create Preview Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Preview Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/healthchecks/preview/{identifier}:
delete:
tags:
- Health Checks
summary: Delete Preview Health Check
description: Delete a health check.
operationId: health-checks-delete-preview-health-check
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Preview Health Check response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Preview Health Check response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Health Checks
summary: Health Check Preview Details
description: Fetch a single configured health check preview.
operationId: health-checks-health-check-preview-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Health Check Preview Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/healthchecks_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Health Check Preview Details response
content:
application/json:
schema:
$ref: '#/components/schemas/healthchecks_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/keyless_certificates:
get:
tags:
- Keyless SSL for a Zone
summary: List Keyless SSL Configurations
description: List all Keyless SSL configurations for a given zone.
operationId: keyless-ssl-for-a-zone-list-keyless-ssl-configurations
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Keyless SSL Configurations response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keyless_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Keyless SSL Configurations response
content:
application/json:
schema:
$ref: '#/components/schemas/keyless_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Keyless SSL for a Zone
summary: Create Keyless SSL Configuration
operationId: keyless-ssl-for-a-zone-create-keyless-ssl-configuration
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- host
- port
- certificate
properties:
bundle_method:
$ref: '#/components/schemas/bundle_method'
certificate:
$ref: '#/components/schemas/schemas-certificate'
host:
$ref: '#/components/schemas/schemas-host'
name:
$ref: '#/components/schemas/keyless-certificate_components-schemas-name'
port:
$ref: '#/components/schemas/schemas-port'
responses:
4xx:
description: Create Keyless SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keyless_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Keyless SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keyless_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/keyless_certificates/{identifier}:
delete:
tags:
- Keyless SSL for a Zone
summary: Delete Keyless SSL Configuration
operationId: keyless-ssl-for-a-zone-delete-keyless-ssl-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keyless-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Keyless SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keyless_response_single_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Keyless SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keyless_response_single_id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Keyless SSL for a Zone
summary: Get Keyless SSL Configuration
description: Get details for one Keyless SSL configuration.
operationId: keyless-ssl-for-a-zone-get-keyless-ssl-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keyless-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Keyless SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keyless_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Keyless SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keyless_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Keyless SSL for a Zone
summary: Edit Keyless SSL Configuration
description: 'This will update attributes of a Keyless SSL. Consists of one
or more of the following: host,name,port,certificate,enabled.'
operationId: keyless-ssl-for-a-zone-edit-keyless-ssl-configuration
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/keyless-certificate_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
enabled:
$ref: '#/components/schemas/schemas-enabled'
host:
$ref: '#/components/schemas/schemas-host'
name:
$ref: '#/components/schemas/keyless-certificate_components-schemas-name'
port:
$ref: '#/components/schemas/schemas-port'
responses:
4xx:
description: Edit Keyless SSL Configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/keyless_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Keyless SSL Configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/keyless_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/datasets/{dataset}/fields:
get:
tags:
- Logpush Jobs
summary: List fields
description: Lists all fields available for a dataset. The response result is
an object with key-value pairs, where keys are field names, and values are
descriptions.
operationId: logpush-jobs-list-fields
parameters:
- name: dataset
in: path
required: true
schema:
$ref: '#/components/schemas/dataset'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List fields response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_field_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List fields response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_field_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/datasets/{dataset}/jobs:
get:
tags:
- Logpush Jobs
summary: List Logpush jobs for a dataset
description: Lists Logpush jobs for a zone for a dataset.
operationId: logpush-jobs-list-logpush-jobs-for-a-dataset
parameters:
- name: dataset
in: path
required: true
schema:
$ref: '#/components/schemas/dataset'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Logpush jobs for a dataset response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_job_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Logpush jobs for a dataset response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_job_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/jobs:
get:
tags:
- Logpush Jobs
summary: List Logpush jobs
description: Lists Logpush jobs for a zone.
operationId: logpush-jobs-list-logpush-jobs
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Logpush jobs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_job_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Logpush jobs response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_job_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Logpush Jobs
summary: Create Logpush job
description: Creates a new Logpush job for a zone.
operationId: logpush-jobs-create-logpush-job
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- destination_conf
properties:
dataset:
$ref: '#/components/schemas/dataset'
destination_conf:
$ref: '#/components/schemas/destination_conf'
enabled:
$ref: '#/components/schemas/enabled'
frequency:
$ref: '#/components/schemas/components-schemas-frequency'
logpull_options:
$ref: '#/components/schemas/logpull_options'
name:
$ref: '#/components/schemas/logpush_components-schemas-name'
ownership_challenge:
$ref: '#/components/schemas/ownership_challenge'
responses:
4xx:
description: Create Logpush job response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_job_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Logpush job response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_job_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/jobs/{job_identifier}:
delete:
tags:
- Logpush Jobs
summary: Delete Logpush job
description: Deletes a Logpush job.
operationId: logpush-jobs-delete-logpush-job
parameters:
- name: job_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Logpush job response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
example: {}
nullable: true
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Logpush job response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-common'
- properties:
result:
type: object
example: {}
nullable: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Logpush Jobs
summary: Get Logpush job details
description: Gets the details of a Logpush job.
operationId: logpush-jobs-get-logpush-job-details
parameters:
- name: job_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Logpush job details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_job_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Logpush job details response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_job_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Logpush Jobs
summary: Update Logpush job
description: Updates a Logpush job.
operationId: logpush-jobs-update-logpush-job
parameters:
- name: job_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
properties:
destination_conf:
$ref: '#/components/schemas/destination_conf'
enabled:
$ref: '#/components/schemas/enabled'
frequency:
$ref: '#/components/schemas/components-schemas-frequency'
logpull_options:
$ref: '#/components/schemas/logpull_options'
ownership_challenge:
$ref: '#/components/schemas/ownership_challenge'
responses:
4xx:
description: Update Logpush job response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logpush_job_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Logpush job response
content:
application/json:
schema:
$ref: '#/components/schemas/logpush_job_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/ownership:
post:
tags:
- Logpush Jobs
summary: Get ownership challenge
description: Gets a new ownership challenge sent to your destination.
operationId: logpush-jobs-get-ownership-challenge
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- destination_conf
properties:
destination_conf:
$ref: '#/components/schemas/destination_conf'
responses:
4xx:
description: Get ownership challenge response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/get_ownership_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get ownership challenge response
content:
application/json:
schema:
$ref: '#/components/schemas/get_ownership_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/ownership/validate:
post:
tags:
- Logpush Jobs
summary: Validate ownership challenge
description: Validates ownership challenge of the destination.
operationId: logpush-jobs-validate-ownership-challenge
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- destination_conf
- ownership_challenge
properties:
destination_conf:
$ref: '#/components/schemas/destination_conf'
ownership_challenge:
$ref: '#/components/schemas/ownership_challenge'
responses:
4xx:
description: Validate ownership challenge response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/validate_ownership_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Validate ownership challenge response
content:
application/json:
schema:
$ref: '#/components/schemas/validate_ownership_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/validate/destination/exists:
post:
tags:
- Logpush Jobs
summary: Check destination exists
description: Checks if there is an existing job with a destination.
operationId: logpush-jobs-check-destination-exists
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- destination_conf
properties:
destination_conf:
$ref: '#/components/schemas/destination_conf'
responses:
4xx:
description: Check destination exists response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/destination_exists_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Check destination exists response
content:
application/json:
schema:
$ref: '#/components/schemas/destination_exists_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logpush/validate/origin:
post:
tags:
- Logpush Jobs
summary: Validate origin
description: Validates logpull origin with logpull_options.
operationId: logpush-jobs-validate-origin
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- logpull_options
properties:
logpull_options:
$ref: '#/components/schemas/logpull_options'
responses:
4xx:
description: Validate origin response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/validate_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Validate origin response
content:
application/json:
schema:
$ref: '#/components/schemas/validate_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logs/control/retention/flag:
get:
tags:
- Logs Received
summary: Get log retention flag
description: Gets log retention flag for Logpull API.
operationId: logs-received-get-log-retention-flag
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get log retention flag response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/flag_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get log retention flag response
content:
application/json:
schema:
$ref: '#/components/schemas/flag_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Logs Received
summary: Update log retention flag
description: Updates log retention flag for Logpull API.
operationId: logs-received-update-log-retention-flag
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- flag
properties:
flag:
$ref: '#/components/schemas/flag'
responses:
4xx:
description: Update log retention flag response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/flag_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update log retention flag response
content:
application/json:
schema:
$ref: '#/components/schemas/flag_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logs/rayids/{ray_identifier}:
get:
tags:
- Logs Received
summary: Get logs RayIDs
description: The `/rayids` api route allows lookups by specific rayid. The rayids
route will return zero, one, or more records (ray ids are not unique).
operationId: logs-received-get-logs-ray-i-ds
parameters:
- name: ray_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/ray_identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get logs RayIDs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logs'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get logs RayIDs response
content:
application/json:
schema:
$ref: '#/components/schemas/logs'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logs/received:
get:
tags:
- Logs Received
summary: Get logs received
description: 'The `/received` api route allows customers to retrieve their edge
HTTP logs. The basic access pattern is "give me all the logs for zone Z for
minute M", where the minute M refers to the time records were received at
Cloudflare''s central data center. `start` is inclusive, and `end` is exclusive.
Because of that, to get all data, at minutely cadence, starting at 10AM, the
proper values are: `start=2018-05-20T10:00:00Z&end=2018-05-20T10:01:00Z`,
then `start=2018-05-20T10:01:00Z&end=2018-05-20T10:02:00Z` and so on; the
overlap will be handled properly.'
operationId: logs-received-get-logs-received
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get logs received response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/logs'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get logs received response
content:
application/json:
schema:
$ref: '#/components/schemas/logs'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/logs/received/fields:
get:
tags:
- Logs Received
summary: List fields
description: Lists all fields available. The response is json object with key-value
pairs, where keys are field names, and values are descriptions.
operationId: logs-received-list-fields
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List fields response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fields_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List fields response
content:
application/json:
schema:
$ref: '#/components/schemas/fields_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth:
get:
tags:
- Zone-Level Authenticated Origin Pulls
summary: List Certificates
operationId: zone-level-authenticated-origin-pulls-list-certificates
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-certificate_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-certificate_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Zone-Level Authenticated Origin Pulls
summary: Upload Certificate
description: Upload your own certificate you want Cloudflare to use for edge-to-origin
communication to override the shared certificate. Please note that it is important
to keep only one certificate active. Also, make sure to enable zone-level
authenticated origin pulls by making a PUT call to settings endpoint to see
the uploaded certificate in use.
operationId: zone-level-authenticated-origin-pulls-upload-certificate
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- certificate
- private_key
properties:
certificate:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-certificate'
private_key:
$ref: '#/components/schemas/private_key'
responses:
4xx:
description: Upload Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/{identifier}:
delete:
tags:
- Zone-Level Authenticated Origin Pulls
summary: Delete Certificate
operationId: zone-level-authenticated-origin-pulls-delete-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Zone-Level Authenticated Origin Pulls
summary: Get Certificate Details
operationId: zone-level-authenticated-origin-pulls-get-certificate-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Certificate Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Certificate Details response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/hostnames:
put:
tags:
- Per-hostname Authenticated Origin Pull
summary: Enable or Disable a Hostname for Client Authentication
description: 'Associate a hostname to a certificate and enable, disable or invalidate
the association. If disabled, client certificate will not be sent to the hostname
even if activated at the zone level. 100 maximum associations on a single
certificate are allowed. Note: Use a null value for parameter *enabled* to
invalidate the association.'
operationId: per-hostname-authenticated-origin-pull-enable-or-disable-a-hostname-for-client-authentication
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- config
properties:
config:
$ref: '#/components/schemas/config'
responses:
4xx:
description: Enable or Disable a Hostname for Client Authentication response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/hostname_aop_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Enable or Disable a Hostname for Client Authentication response
content:
application/json:
schema:
$ref: '#/components/schemas/hostname_aop_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/hostnames/{hostname}:
get:
tags:
- Per-hostname Authenticated Origin Pull
summary: Get the Hostname Status for Client Authentication
operationId: per-hostname-authenticated-origin-pull-get-the-hostname-status-for-client-authentication
parameters:
- name: hostname
in: path
required: true
schema:
$ref: '#/components/schemas/schemas-hostname'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get the Hostname Status for Client Authentication response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/hostname_aop_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get the Hostname Status for Client Authentication response
content:
application/json:
schema:
$ref: '#/components/schemas/hostname_aop_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/hostnames/certificates:
get:
tags:
- Per-hostname Authenticated Origin Pull
summary: List Certificates
operationId: per-hostname-authenticated-origin-pull-list-certificates
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Certificates response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Certificates response
content:
application/json:
schema:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Per-hostname Authenticated Origin Pull
summary: Upload a Hostname Client Certificate
description: Upload a certificate to be used for client authentication on a
hostname. 10 hostname certificates per zone are allowed.
operationId: per-hostname-authenticated-origin-pull-upload-a-hostname-client-certificate
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- certificate
- private_key
properties:
certificate:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-certificate'
private_key:
$ref: '#/components/schemas/schemas-private_key'
responses:
4xx:
description: Upload a Hostname Client Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload a Hostname Client Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/hostnames/certificates/{identifier}:
delete:
tags:
- Per-hostname Authenticated Origin Pull
summary: Delete Hostname Client Certificate
operationId: per-hostname-authenticated-origin-pull-delete-hostname-client-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Hostname Client Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Hostname Client Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Per-hostname Authenticated Origin Pull
summary: Get the Hostname Client Certificate
description: Get the certificate by ID to be used for client authentication
on a hostname.
operationId: per-hostname-authenticated-origin-pull-get-the-hostname-client-certificate
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/hostname-authenticated-origin-pull_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get the Hostname Client Certificate response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-certificate_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get the Hostname Client Certificate response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-certificate_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/origin_tls_client_auth/settings:
get:
tags:
- Zone-Level Authenticated Origin Pulls
summary: Get Enablement Setting for Zone
description: Get whether zone-level authenticated origin pulls is enabled or
not. It is false by default.
operationId: zone-level-authenticated-origin-pulls-get-enablement-setting-for-zone
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Enablement Setting for Zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/enabled_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Enablement Setting for Zone response
content:
application/json:
schema:
$ref: '#/components/schemas/enabled_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Zone-Level Authenticated Origin Pulls
summary: Set Enablement for Zone
description: Enable or disable zone-level authenticated origin pulls. 'enabled'
should be set true either before/after the certificate is uploaded to see
the certificate in use.
operationId: zone-level-authenticated-origin-pulls-set-enablement-for-zone
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- enabled
properties:
enabled:
$ref: '#/components/schemas/zone-authenticated-origin-pull_components-schemas-enabled'
responses:
4xx:
description: Set Enablement for Zone response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/enabled_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Set Enablement for Zone response
content:
application/json:
schema:
$ref: '#/components/schemas/enabled_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/pagerules:
get:
tags:
- Page Rules
summary: List Page Rules
description: Fetches Page Rules in a zone.
operationId: page-rules-list-page-rules
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Page Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Page Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Page Rules
summary: Create a Page Rule
description: Creates a new Page Rule.
operationId: page-rules-create-a-page-rule
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- targets
- actions
properties:
actions:
$ref: '#/components/schemas/schemas-actions'
priority:
$ref: '#/components/schemas/page-rule_components-schemas-priority'
status:
$ref: '#/components/schemas/page-rule_components-schemas-status'
targets:
$ref: '#/components/schemas/targets'
responses:
4xx:
description: Create a Page Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a Page Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/pagerules/{identifier}:
delete:
tags:
- Page Rules
summary: Delete a Page Rule
description: Deletes an existing Page Rule.
operationId: page-rules-delete-a-page-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a Page Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a Page Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Page Rules
summary: Get a Page Rule
description: Fetches the details of a Page Rule.
operationId: page-rules-get-a-page-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a Page Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a Page Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Page Rules
summary: Edit a Page Rule
description: Updates one or more fields of an existing Page Rule.
operationId: page-rules-edit-a-page-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
actions:
$ref: '#/components/schemas/schemas-actions'
priority:
$ref: '#/components/schemas/page-rule_components-schemas-priority'
status:
$ref: '#/components/schemas/page-rule_components-schemas-status'
targets:
$ref: '#/components/schemas/targets'
responses:
4xx:
description: Edit a Page Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit a Page Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Page Rules
summary: Update a Page Rule
description: Replaces the configuration of an existing Page Rule. The configuration
of the updated Page Rule will exactly match the data passed in the API request.
operationId: page-rules-update-a-page-rule
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- targets
- actions
properties:
actions:
$ref: '#/components/schemas/schemas-actions'
priority:
$ref: '#/components/schemas/page-rule_components-schemas-priority'
status:
$ref: '#/components/schemas/page-rule_components-schemas-status'
targets:
$ref: '#/components/schemas/targets'
responses:
4xx:
description: Update a Page Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a Page Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/pagerules/settings:
get:
tags:
- Available Page Rules settings
summary: List available Page Rules settings
description: Returns a list of settings (and their details) that Page Rules
can apply to matching requests.
operationId: available-page-rules-settings-list-available-page-rules-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List available Page Rules settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pagerule_settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List available Page Rules settings response
content:
application/json:
schema:
$ref: '#/components/schemas/pagerule_settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/railguns:
get:
tags:
- Railgun Connections for a Zone
summary: List available Railguns
description: A list of available Railguns the zone can use.
operationId: railgun-connections-for-a-zone-list-available-railguns
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List available Railguns response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-railgun_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List available Railguns response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-railgun_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/railguns/{identifier}:
get:
tags:
- Railgun Connections for a Zone
summary: Railgun details
description: Lists details about a specific Railgun.
operationId: railgun-connections-for-a-zone-railgun-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier-2'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Railgun details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Railgun details response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Railgun Connections for a Zone
summary: Connect or disconnect a Railgun
description: Connect or disconnect a Railgun.
operationId: railgun-connections-for-a-zone-connect-or-disconnect-a-railgun
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier-2'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- connected
properties:
connected:
$ref: '#/components/schemas/connected'
responses:
4xx:
description: Connect or disconnect a Railgun response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/railgun_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Connect or disconnect a Railgun response
content:
application/json:
schema:
$ref: '#/components/schemas/railgun_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/railguns/{identifier}/diagnose:
get:
tags:
- Railgun Connections for a Zone
summary: Test Railgun connection
description: Tests the Railgun connection to the zone.
operationId: railgun-connections-for-a-zone-test-railgun-connection
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/railgun_components-schemas-identifier-2'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Test Railgun connection response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/test_connection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Test Railgun connection response
content:
application/json:
schema:
$ref: '#/components/schemas/test_connection_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/rate_limits:
get:
tags:
- Rate limits for a zone
summary: List rate limits
description: Fetches the rate limits for a zone.
operationId: rate-limits-for-a-zone-list-rate-limits
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List rate limits response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ratelimit_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List rate limits response
content:
application/json:
schema:
$ref: '#/components/schemas/ratelimit_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Rate limits for a zone
summary: Create a rate limit
description: Creates a new rate limit for a zone. Refer to the object definition
for a list of required attributes.
operationId: rate-limits-for-a-zone-create-a-rate-limit
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- match
- threshold
- period
- action
responses:
4xx:
description: Create a rate limit response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ratelimit_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a rate limit response
content:
application/json:
schema:
$ref: '#/components/schemas/ratelimit_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/rate_limits/{id}:
delete:
tags:
- Rate limits for a zone
summary: Delete a rate limit
description: Deletes an existing rate limit.
operationId: rate-limits-for-a-zone-delete-a-rate-limit
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete a rate limit response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/ratelimit_response_single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete a rate limit response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ratelimit_response_single'
- type: object
properties:
result:
properties:
id:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Rate limits for a zone
summary: Get a rate limit
description: Fetches the details of a rate limit.
operationId: rate-limits-for-a-zone-get-a-rate-limit
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get a rate limit response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ratelimit_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get a rate limit response
content:
application/json:
schema:
$ref: '#/components/schemas/ratelimit_response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Rate limits for a zone
summary: Update a rate limit
description: Updates an existing rate limit.
operationId: rate-limits-for-a-zone-update-a-rate-limit
parameters:
- name: id
in: path
required: true
schema:
$ref: '#/components/schemas/rate-limits_components-schemas-id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- id
- match
- threshold
- period
- action
responses:
4xx:
description: Update a rate limit response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ratelimit_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update a rate limit response
content:
application/json:
schema:
$ref: '#/components/schemas/ratelimit_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings:
get:
tags:
- Zone Settings
summary: Get all Zone settings
description: Available settings for your user in relation to a zone.
operationId: zone-settings-get-all-zone-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get all Zone settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get all Zone settings response
content:
application/json:
schema:
$ref: '#/components/schemas/zone_settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Edit zone settings info
description: Edit settings for a zone.
operationId: zone-settings-edit-zone-settings-info
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- items
properties:
items:
type: array
description: One or more zone setting objects. Must contain an ID
and a value.
example:
- id: always_online
value: "on"
- id: browser_cache_ttl
value: 18000
- id: ip_geolocation
value: "off"
minItems: 1
items:
$ref: '#/components/schemas/setting'
responses:
4xx:
description: Edit zone settings info response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit zone settings info response
content:
application/json:
schema:
$ref: '#/components/schemas/zone_settings_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/0rtt:
get:
tags:
- Zone Settings
summary: Get 0-RTT session resumption setting
description: Gets 0-RTT session resumption setting.
operationId: zone-settings-get-0-rtt-session-resumption-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get 0-RTT session resumption setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/0rtt'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get 0-RTT session resumption setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/0rtt'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change 0-RTT session resumption setting
description: Changes the 0-RTT session resumption setting.
operationId: zone-settings-change-0-rtt-session-resumption-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/0rtt_value'
responses:
4xx:
description: Change 0-RTT session resumption setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/0rtt'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change 0-RTT session resumption setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/0rtt'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/advanced_ddos:
get:
tags:
- Zone Settings
summary: Get Advanced DDOS setting
description: Advanced protection from Distributed Denial of Service (DDoS) attacks
on your website. This is an uneditable value that is 'on' in the case of Business
and Enterprise zones.
operationId: zone-settings-get-advanced-ddos-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Advanced DDOS setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/advanced_ddos'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Advanced DDOS setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/advanced_ddos'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/always_online:
get:
tags:
- Zone Settings
summary: Get Always Online setting
description: When enabled, Cloudflare serves limited copies of web pages available
from the [Internet Archive's Wayback Machine](https://archive.org/web/) if
your server is offline. Refer to [Always Online](https://developers.cloudflare.com/cache/about/always-online)
for more information.
operationId: zone-settings-get-always-online-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Always Online setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_online'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Always Online setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_online'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Always Online setting
description: When enabled, Cloudflare serves limited copies of web pages available
from the [Internet Archive's Wayback Machine](https://archive.org/web/) if
your server is offline. Refer to [Always Online](https://developers.cloudflare.com/cache/about/always-online)
for more information.
operationId: zone-settings-change-always-online-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/always_online_value'
responses:
4xx:
description: Change Always Online setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_online'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Always Online setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_online'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/always_use_https:
get:
tags:
- Zone Settings
summary: Get Always Use HTTPS setting
description: Reply to all requests for URLs that use "http" with a 301 redirect
to the equivalent "https" URL. If you only want to redirect for a subset of
requests, consider creating an "Always use HTTPS" page rule.
operationId: zone-settings-get-always-use-https-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Always Use HTTPS setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_use_https'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Always Use HTTPS setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_use_https'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Always Use HTTPS setting
description: Reply to all requests for URLs that use "http" with a 301 redirect
to the equivalent "https" URL. If you only want to redirect for a subset of
requests, consider creating an "Always use HTTPS" page rule.
operationId: zone-settings-change-always-use-https-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/always_use_https_value'
responses:
4xx:
description: Change Always Use HTTPS setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_use_https'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Always Use HTTPS setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/always_use_https'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/automatic_https_rewrites:
get:
tags:
- Zone Settings
summary: Get Automatic HTTPS Rewrites setting
description: Enable the Automatic HTTPS Rewrites feature for this zone.
operationId: zone-settings-get-automatic-https-rewrites-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Automatic HTTPS Rewrites setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_https_rewrites'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Automatic HTTPS Rewrites setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_https_rewrites'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Automatic HTTPS Rewrites setting
description: Enable the Automatic HTTPS Rewrites feature for this zone.
operationId: zone-settings-change-automatic-https-rewrites-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/automatic_https_rewrites_value'
responses:
4xx:
description: Change Automatic HTTPS Rewrites setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_https_rewrites'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Automatic HTTPS Rewrites setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_https_rewrites'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/automatic_platform_optimization:
get:
tags:
- Zone Settings
summary: Get Automatic Platform Optimization for WordPress settings
description: '[Automatic Platform Optimization for WordPress](https://developers.cloudflare.com/automatic-platform-optimization/)
serves your WordPress site from Cloudflare''s edge network and caches third-party
fonts.'
operationId: zone-settings-get-automatic-platform-optimization-for-word-press-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Automatic Platform Optimization for WordPress settings
response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_platform_optimization'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Automatic Platform Optimization for WordPress settings
response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_platform_optimization'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Automatic Platform Optimization for WordPress settings
description: '[Automatic Platform Optimization for WordPress](https://developers.cloudflare.com/automatic-platform-optimization/)
serves your WordPress site from Cloudflare''s edge network and caches third-party
fonts.'
operationId: zone-settings-change-automatic-platform-optimization-for-word-press-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/automatic_platform_optimization'
responses:
4xx:
description: Change Automatic Platform Optimization for WordPress settings
response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_platform_optimization'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Automatic Platform Optimization for WordPress settings
response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/automatic_platform_optimization'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/brotli:
get:
tags:
- Zone Settings
summary: Get Brotli setting
description: When the client requesting an asset supports the Brotli compression
algorithm, Cloudflare will serve a Brotli compressed version of the asset.
operationId: zone-settings-get-brotli-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Brotli setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/brotli'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Brotli setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/brotli'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Brotli setting
description: When the client requesting an asset supports the Brotli compression
algorithm, Cloudflare will serve a Brotli compressed version of the asset.
operationId: zone-settings-change-brotli-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/brotli_value'
responses:
4xx:
description: Change Brotli setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/brotli'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Brotli setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/brotli'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/browser_cache_ttl:
get:
tags:
- Zone Settings
summary: Get Browser Cache TTL setting
description: Browser Cache TTL (in seconds) specifies how long Cloudflare-cached
resources will remain on your visitors' computers. Cloudflare will honor any
larger times specified by your server. (https://support.cloudflare.com/hc/en-us/articles/200168276).
operationId: zone-settings-get-browser-cache-ttl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Browser Cache TTL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_cache_ttl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Browser Cache TTL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_cache_ttl'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Browser Cache TTL setting
description: Browser Cache TTL (in seconds) specifies how long Cloudflare-cached
resources will remain on your visitors' computers. Cloudflare will honor any
larger times specified by your server. (https://support.cloudflare.com/hc/en-us/articles/200168276).
operationId: zone-settings-change-browser-cache-ttl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/browser_cache_ttl_value'
responses:
4xx:
description: Change Browser Cache TTL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_cache_ttl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Browser Cache TTL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_cache_ttl'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/browser_check:
get:
tags:
- Zone Settings
summary: Get Browser Check setting
description: Browser Integrity Check is similar to Bad Behavior and looks for
common HTTP headers abused most commonly by spammers and denies access to
your page. It will also challenge visitors that do not have a user agent
or a non standard user agent (also commonly used by abuse bots, crawlers or
visitors). (https://support.cloudflare.com/hc/en-us/articles/200170086).
operationId: zone-settings-get-browser-check-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Browser Check setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_check'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Browser Check setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_check'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Browser Check setting
description: Browser Integrity Check is similar to Bad Behavior and looks for
common HTTP headers abused most commonly by spammers and denies access to
your page. It will also challenge visitors that do not have a user agent
or a non standard user agent (also commonly used by abuse bots, crawlers or
visitors). (https://support.cloudflare.com/hc/en-us/articles/200170086).
operationId: zone-settings-change-browser-check-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/browser_check_value'
responses:
4xx:
description: Change Browser Check setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_check'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Browser Check setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/browser_check'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/cache_level:
get:
tags:
- Zone Settings
summary: Get Cache Level setting
description: Cache Level functions based off the setting level. The basic setting
will cache most static resources (i.e., css, images, and JavaScript). The
simplified setting will ignore the query string when delivering a cached resource.
The aggressive setting will cache all static resources, including ones with
a query string. (https://support.cloudflare.com/hc/en-us/articles/200168256).
operationId: zone-settings-get-cache-level-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Cache Level setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/cache_level'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Cache Level setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/cache_level'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Cache Level setting
description: Cache Level functions based off the setting level. The basic setting
will cache most static resources (i.e., css, images, and JavaScript). The
simplified setting will ignore the query string when delivering a cached resource.
The aggressive setting will cache all static resources, including ones with
a query string. (https://support.cloudflare.com/hc/en-us/articles/200168256).
operationId: zone-settings-change-cache-level-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/cache_level_value'
responses:
4xx:
description: Change Cache Level setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/cache_level'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Cache Level setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/cache_level'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/challenge_ttl:
get:
tags:
- Zone Settings
summary: Get Challenge TTL setting
description: Specify how long a visitor is allowed access to your site after
successfully completing a challenge (such as a CAPTCHA). After the TTL has
expired the visitor will have to complete a new challenge. We recommend a
15 - 45 minute setting and will attempt to honor any setting above 45 minutes.
(https://support.cloudflare.com/hc/en-us/articles/200170136).
operationId: zone-settings-get-challenge-ttl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Challenge TTL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/challenge_ttl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Challenge TTL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/challenge_ttl'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Challenge TTL setting
description: Specify how long a visitor is allowed access to your site after
successfully completing a challenge (such as a CAPTCHA). After the TTL has
expired the visitor will have to complete a new challenge. We recommend a
15 - 45 minute setting and will attempt to honor any setting above 45 minutes.
(https://support.cloudflare.com/hc/en-us/articles/200170136).
operationId: zone-settings-change-challenge-ttl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/challenge_ttl_value'
responses:
4xx:
description: Change Challenge TTL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/challenge_ttl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Challenge TTL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/challenge_ttl'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/ciphers:
get:
tags:
- Zone Settings
summary: Get ciphers setting
description: Gets ciphers setting.
operationId: zone-settings-get-ciphers-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get ciphers setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ciphers'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get ciphers setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ciphers'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change ciphers setting
description: Changes ciphers setting.
operationId: zone-settings-change-ciphers-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/ciphers_value'
responses:
4xx:
description: Change ciphers setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ciphers'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change ciphers setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ciphers'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/development_mode:
get:
tags:
- Zone Settings
summary: Get Development Mode setting
description: Development Mode temporarily allows you to enter development mode
for your websites if you need to make changes to your site. This will bypass
Cloudflare's accelerated cache and slow down your site, but is useful if you
are making changes to cacheable content (like images, css, or JavaScript)
and would like to see those changes right away. Once entered, development
mode will last for 3 hours and then automatically toggle off.
operationId: zone-settings-get-development-mode-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Development Mode setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/development_mode'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Development Mode setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/development_mode'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Development Mode setting
description: Development Mode temporarily allows you to enter development mode
for your websites if you need to make changes to your site. This will bypass
Cloudflare's accelerated cache and slow down your site, but is useful if you
are making changes to cacheable content (like images, css, or JavaScript)
and would like to see those changes right away. Once entered, development
mode will last for 3 hours and then automatically toggle off.
operationId: zone-settings-change-development-mode-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/development_mode_value'
responses:
4xx:
description: Change Development Mode setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/development_mode'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Development Mode setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/development_mode'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/early_hints:
get:
tags:
- Zone Settings
summary: Get Early Hints setting
description: When enabled, Cloudflare will attempt to speed up overall page
loads by serving `103` responses with `Link` headers from the final response.
Refer to [Early Hints](https://developers.cloudflare.com/cache/about/early-hints)
for more information.
operationId: zone-settings-get-early-hints-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Early Hints setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/early_hints'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Early Hints setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/early_hints'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Early Hints setting
description: When enabled, Cloudflare will attempt to speed up overall page
loads by serving `103` responses with `Link` headers from the final response.
Refer to [Early Hints](https://developers.cloudflare.com/cache/about/early-hints)
for more information.
operationId: zone-settings-change-early-hints-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/early_hints_value'
responses:
4xx:
description: Change Early Hints setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/early_hints'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Early Hints setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/early_hints'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/email_obfuscation:
get:
tags:
- Zone Settings
summary: Get Email Obfuscation setting
description: Encrypt email adresses on your web page from bots, while keeping
them visible to humans. (https://support.cloudflare.com/hc/en-us/articles/200170016).
operationId: zone-settings-get-email-obfuscation-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Email Obfuscation setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/email_obfuscation'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Email Obfuscation setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/email_obfuscation'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Email Obfuscation setting
description: Encrypt email adresses on your web page from bots, while keeping
them visible to humans. (https://support.cloudflare.com/hc/en-us/articles/200170016).
operationId: zone-settings-change-email-obfuscation-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/email_obfuscation_value'
responses:
4xx:
description: Change Email Obfuscation setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/email_obfuscation'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Email Obfuscation setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/email_obfuscation'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/h2_prioritization:
get:
tags:
- Zone Settings
summary: Get HTTP/2 Edge Prioritization setting
description: Gets HTTP/2 Edge Prioritization setting.
operationId: zone-settings-get-http/-2-edge-prioritization-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get HTTP/2 Edge Prioritization setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/h2_prioritization'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get HTTP/2 Edge Prioritization setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/h2_prioritization'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change HTTP/2 Edge Prioritization setting
description: Changes HTTP/2 Edge Prioritization setting.
operationId: zone-settings-change-http/-2-edge-prioritization-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/h2_prioritization_value'
responses:
4xx:
description: Change HTTP/2 Edge Prioritization setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/h2_prioritization'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change HTTP/2 Edge Prioritization setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/h2_prioritization'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/hotlink_protection:
get:
tags:
- Zone Settings
summary: Get Hotlink Protection setting
description: When enabled, the Hotlink Protection option ensures that other
sites cannot suck up your bandwidth by building pages that use images hosted
on your site. Anytime a request for an image on your site hits Cloudflare,
we check to ensure that it's not another site requesting them. People will
still be able to download and view images from your page, but other sites
won't be able to steal them for use on their own pages. (https://support.cloudflare.com/hc/en-us/articles/200170026).
operationId: zone-settings-get-hotlink-protection-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Hotlink Protection setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/hotlink_protection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Hotlink Protection setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/hotlink_protection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Hotlink Protection setting
description: When enabled, the Hotlink Protection option ensures that other
sites cannot suck up your bandwidth by building pages that use images hosted
on your site. Anytime a request for an image on your site hits Cloudflare,
we check to ensure that it's not another site requesting them. People will
still be able to download and view images from your page, but other sites
won't be able to steal them for use on their own pages. (https://support.cloudflare.com/hc/en-us/articles/200170026).
operationId: zone-settings-change-hotlink-protection-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/hotlink_protection_value'
responses:
4xx:
description: Change Hotlink Protection setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/hotlink_protection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Hotlink Protection setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/hotlink_protection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/http2:
get:
tags:
- Zone Settings
summary: Get HTTP2 setting
description: Value of the HTTP2 setting.
operationId: zone-settings-get-h-t-t-p-2-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get HTTP2 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get HTTP2 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http2'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change HTTP2 setting
description: Value of the HTTP2 setting.
operationId: zone-settings-change-h-t-t-p-2-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/http2_value'
responses:
4xx:
description: Change HTTP2 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http2'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change HTTP2 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http2'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/http3:
get:
tags:
- Zone Settings
summary: Get HTTP3 setting
description: Value of the HTTP3 setting.
operationId: zone-settings-get-h-t-t-p-3-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get HTTP3 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http3'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get HTTP3 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http3'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change HTTP3 setting
description: Value of the HTTP3 setting.
operationId: zone-settings-change-h-t-t-p-3-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/http3_value'
responses:
4xx:
description: Change HTTP3 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http3'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change HTTP3 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/http3'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/image_resizing:
get:
tags:
- Zone Settings
summary: Get Image Resizing setting
description: Image Resizing provides on-demand resizing, conversion and optimisation
for images served through Cloudflare's network. Refer to the [Image Resizing
documentation](https://developers.cloudflare.com/images/) for more information.
operationId: zone-settings-get-image-resizing-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Image Resizing setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/image_resizing'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Image Resizing setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/image_resizing'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Image Resizing setting
description: Image Resizing provides on-demand resizing, conversion and optimisation
for images served through Cloudflare's network. Refer to the [Image Resizing
documentation](https://developers.cloudflare.com/images/) for more information.
operationId: zone-settings-change-image-resizing-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/image_resizing_value'
responses:
4xx:
description: Change Image Resizing setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/image_resizing'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Image Resizing setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/image_resizing'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/ip_geolocation:
get:
tags:
- Zone Settings
summary: Get IP Geolocation setting
description: Enable IP Geolocation to have Cloudflare geolocate visitors to
your website and pass the country code to you. (https://support.cloudflare.com/hc/en-us/articles/200168236).
operationId: zone-settings-get-ip-geolocation-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get IP Geolocation setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ip_geolocation'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get IP Geolocation setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ip_geolocation'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change IP Geolocation setting
description: Enable IP Geolocation to have Cloudflare geolocate visitors to
your website and pass the country code to you. (https://support.cloudflare.com/hc/en-us/articles/200168236).
operationId: zone-settings-change-ip-geolocation-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/ip_geolocation_value'
responses:
4xx:
description: Change IP Geolocation setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ip_geolocation'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change IP Geolocation setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ip_geolocation'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/ipv6:
get:
tags:
- Zone Settings
summary: Get IPv6 setting
description: Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).
operationId: zone-settings-get-i-pv6-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get IPv6 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ipv6'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get IPv6 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ipv6'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change IPv6 setting
description: Enable IPv6 on all subdomains that are Cloudflare enabled. (https://support.cloudflare.com/hc/en-us/articles/200168586).
operationId: zone-settings-change-i-pv6-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/ipv6_value'
responses:
4xx:
description: Change IPv6 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ipv6'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change IPv6 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ipv6'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/min_tls_version:
get:
tags:
- Zone Settings
summary: Get Minimum TLS Version setting
description: Gets Minimum TLS Version setting.
operationId: zone-settings-get-minimum-tls-version-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Minimum TLS Version setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/min_tls_version'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Minimum TLS Version setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/min_tls_version'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Minimum TLS Version setting
description: Changes Minimum TLS Version setting.
operationId: zone-settings-change-minimum-tls-version-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/min_tls_version_value'
responses:
4xx:
description: Change Minimum TLS Version setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/min_tls_version'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Minimum TLS Version setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/min_tls_version'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/minify:
get:
tags:
- Zone Settings
summary: Get Minify setting
description: Automatically minify certain assets for your website. Refer to
[Using Cloudflare Auto Minify](https://support.cloudflare.com/hc/en-us/articles/200168196)
for more information.
operationId: zone-settings-get-minify-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Minify setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/minify'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Minify setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/minify'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Minify setting
description: Automatically minify certain assets for your website. Refer to
[Using Cloudflare Auto Minify](https://support.cloudflare.com/hc/en-us/articles/200168196)
for more information.
operationId: zone-settings-change-minify-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/minify_value'
responses:
4xx:
description: Change Minify setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/minify'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Minify setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/minify'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/mirage:
get:
tags:
- Zone Settings
summary: Get Mirage setting
description: Automatically optimize image loading for website visitors on mobile
devices. Refer to [our blog post](http://blog.cloudflare.com/mirage2-solving-mobile-speed)
for more information.
operationId: zone-settings-get-mirage-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Mirage setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mirage'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Mirage setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mirage'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Mirage setting
description: Automatically optimize image loading for website visitors on mobile
devices. Refer to [our blog post](http://blog.cloudflare.com/mirage2-solving-mobile-speed)
for more information.
operationId: zone-settings-change-mirage-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/mirage_value'
responses:
4xx:
description: Change Mirage setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mirage'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Mirage setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mirage'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/mobile_redirect:
get:
tags:
- Zone Settings
summary: Get Mobile Redirect setting
description: Automatically redirect visitors on mobile devices to a mobile-optimized
subdomain. Refer to [Understanding Cloudflare Mobile Redirect](https://support.cloudflare.com/hc/articles/200168336)
for more information.
operationId: zone-settings-get-mobile-redirect-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Mobile Redirect setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mobile_redirect'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Mobile Redirect setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mobile_redirect'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Mobile Redirect setting
description: Automatically redirect visitors on mobile devices to a mobile-optimized
subdomain. Refer to [Understanding Cloudflare Mobile Redirect](https://support.cloudflare.com/hc/articles/200168336)
for more information.
operationId: zone-settings-change-mobile-redirect-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/mobile_redirect_value'
responses:
4xx:
description: Change Mobile Redirect setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mobile_redirect'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Mobile Redirect setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/mobile_redirect'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/nel:
get:
tags:
- Zone Settings
summary: Get Network Error Logging setting
description: 'Enable Network Error Logging reporting on your zone. (Beta) '
operationId: zone-settings-get-network-error-logging-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Network Error Logging setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/nel'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Network Error Logging setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/nel'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Network Error Logging setting
description: 'Enable Network Error Logging reporting on your zone. (Beta) '
operationId: zone-settings-change-network-error-logging-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/nel_value'
responses:
4xx:
description: Change Network Error Logging setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/nel'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Network Error Logging setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/nel'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/opportunistic_encryption:
get:
tags:
- Zone Settings
summary: Get Opportunistic Encryption setting
description: Gets Opportunistic Encryption setting.
operationId: zone-settings-get-opportunistic-encryption-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Opportunistic Encryption setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_encryption'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Opportunistic Encryption setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_encryption'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Opportunistic Encryption setting
description: Changes Opportunistic Encryption setting.
operationId: zone-settings-change-opportunistic-encryption-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/opportunistic_encryption_value'
responses:
4xx:
description: Change Opportunistic Encryption setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_encryption'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Opportunistic Encryption setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_encryption'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/opportunistic_onion:
get:
tags:
- Zone Settings
summary: Get Opportunistic Onion setting
description: Add an Alt-Svc header to all legitimate requests from Tor, allowing
the connection to use our onion services instead of exit nodes.
operationId: zone-settings-get-opportunistic-onion-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Opportunistic Onion setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_onion'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Opportunistic Onion setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_onion'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Opportunistic Onion setting
description: Add an Alt-Svc header to all legitimate requests from Tor, allowing
the connection to use our onion services instead of exit nodes.
operationId: zone-settings-change-opportunistic-onion-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/opportunistic_onion_value'
responses:
4xx:
description: Change Opportunistic Onion setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_onion'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Opportunistic Onion setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/opportunistic_onion'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/orange_to_orange:
get:
tags:
- Zone Settings
summary: Get Orange to Orange (O2O)
description: Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other
zones also on Cloudflare.
operationId: zone-settings-get-orange-to-orange-(-o-2-o)
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Orange to Orange (O2O) response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/orange_to_orange'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Orange to Orange (O2O) response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/orange_to_orange'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Orange to Orange (O2O)
description: Orange to Orange (O2O) allows zones on Cloudflare to CNAME to other
zones also on Cloudflare.
operationId: zone-settings-change-orange-to-orange-(-o-2-o)
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/orange_to_orange_value'
responses:
4xx:
description: Change Orange to Orange (O2O) response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/orange_to_orange'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Orange to Orange (O2O) response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/orange_to_orange'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/origin_error_page_pass_thru:
get:
tags:
- Zone Settings
summary: Get Enable Error Pages On setting
description: Cloudflare will proxy customer error pages on any 502,504 errors
on origin server instead of showing a default Cloudflare error page. This
does not apply to 522 errors and is limited to Enterprise Zones.
operationId: zone-settings-get-enable-error-pages-on-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Enable Error Pages On setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/origin_error_page_pass_thru'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Enable Error Pages On setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/origin_error_page_pass_thru'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Enable Error Pages On setting
description: Cloudflare will proxy customer error pages on any 502,504 errors
on origin server instead of showing a default Cloudflare error page. This
does not apply to 522 errors and is limited to Enterprise Zones.
operationId: zone-settings-change-enable-error-pages-on-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/origin_error_page_pass_thru_value'
responses:
4xx:
description: Change Enable Error Pages On setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/origin_error_page_pass_thru'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Enable Error Pages On setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/origin_error_page_pass_thru'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/origin_max_http_version:
get:
tags:
- Zone Settings
summary: Get Origin Max HTTP version setting
description: Value of the Origin Max HTTP version setting (Note that the default
value for Enterprise is "1").
operationId: zone-settings-get-origin-max-http-version-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Origin Max HTTP version setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- $ref: '#/components/schemas/origin_max_http_version_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Origin Max HTTP version setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- $ref: '#/components/schemas/origin_max_http_version_response_value'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Origin Max HTTP version setting
description: The highest HTTP version Cloudflare will attempt to use with your
origin. This setting allows Cloudflare to make HTTP/2 requests to your origin.
(Refer to [Enable HTTP/2 to Origin](https://developers.cloudflare.com/cache/how-to/enable-http2-to-origin/),
for more information.).
operationId: zone-settings-change-origin-max-http-version-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/origin_max_http_version_value'
responses:
4xx:
description: Change Origin Max HTTP version setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- $ref: '#/components/schemas/origin_max_http_version_response_value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Origin Max HTTP version setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- $ref: '#/components/schemas/origin_max_http_version_response_value'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/polish:
get:
tags:
- Zone Settings
summary: Get Polish setting
description: 'Removes metadata and compresses your images for faster page load
times. Basic (Lossless): Reduce the size of PNG, JPEG, and GIF files - no
impact on visual quality. Basic + JPEG (Lossy): Further reduce the size of
JPEG files for faster image loading. Larger JPEGs are converted to progressive
images, loading a lower-resolution image first and ending in a higher-resolution
version. Not recommended for hi-res photography sites.'
operationId: zone-settings-get-polish-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Polish setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/polish'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Polish setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/polish'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Polish setting
description: 'Removes metadata and compresses your images for faster page load
times. Basic (Lossless): Reduce the size of PNG, JPEG, and GIF files - no
impact on visual quality. Basic + JPEG (Lossy): Further reduce the size of
JPEG files for faster image loading. Larger JPEGs are converted to progressive
images, loading a lower-resolution image first and ending in a higher-resolution
version. Not recommended for hi-res photography sites.'
operationId: zone-settings-change-polish-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/polish_value'
responses:
4xx:
description: Change Polish setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/polish'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Polish setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/polish'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/prefetch_preload:
get:
tags:
- Zone Settings
summary: Get prefetch preload setting
description: Cloudflare will prefetch any URLs that are included in the response
headers. This is limited to Enterprise Zones.
operationId: zone-settings-get-prefetch-preload-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get prefetch preload setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/prefetch_preload'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get prefetch preload setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/prefetch_preload'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change prefetch preload setting
description: Cloudflare will prefetch any URLs that are included in the response
headers. This is limited to Enterprise Zones.
operationId: zone-settings-change-prefetch-preload-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/prefetch_preload_value'
responses:
4xx:
description: Change prefetch preload setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/prefetch_preload'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change prefetch preload setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/prefetch_preload'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/privacy_pass:
get:
tags:
- Zone Settings
summary: Get Privacy Pass setting
description: Privacy Pass is a browser extension developed by the Privacy Pass
Team to improve the browsing experience for your visitors. Enabling Privacy
Pass will reduce the number of CAPTCHAs shown to your visitors. (https://support.cloudflare.com/hc/en-us/articles/115001992652-Privacy-Pass).
operationId: zone-settings-get-privacy-pass-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Privacy Pass setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/privacy_pass'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Privacy Pass setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/privacy_pass'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Privacy Pass setting
description: Privacy Pass is a browser extension developed by the Privacy Pass
Team to improve the browsing experience for your visitors. Enabling Privacy
Pass will reduce the number of CAPTCHAs shown to your visitors. (https://support.cloudflare.com/hc/en-us/articles/115001992652-Privacy-Pass).
operationId: zone-settings-change-privacy-pass-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/privacy_pass_value'
responses:
4xx:
description: Change Privacy Pass setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/privacy_pass'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Privacy Pass setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/privacy_pass'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/proxy_read_timeout:
get:
tags:
- Zone Settings
summary: Get Proxy Read Timeout setting
description: Maximum time between two read operations from origin.
operationId: zone-settings-get-proxy-read-timeout-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Proxy Read Timeout setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/proxy_read_timeout'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Proxy Read Timeout setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/proxy_read_timeout'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Proxy Read Timeout setting
description: Maximum time between two read operations from origin.
operationId: zone-settings-change-proxy-read-timeout-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/proxy_read_timeout_value'
responses:
4xx:
description: Change Proxy Read Timeout setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/proxy_read_timeout'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Proxy Read Timeout setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/proxy_read_timeout'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/pseudo_ipv4:
get:
tags:
- Zone Settings
summary: Get Pseudo IPv4 setting
description: Value of the Pseudo IPv4 setting.
operationId: zone-settings-get-pseudo-i-pv4-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Pseudo IPv4 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/pseudo_ipv4'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Pseudo IPv4 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/pseudo_ipv4'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Pseudo IPv4 setting
description: Value of the Pseudo IPv4 setting.
operationId: zone-settings-change-pseudo-i-pv4-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/pseudo_ipv4_value'
responses:
4xx:
description: Change Pseudo IPv4 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/pseudo_ipv4'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Pseudo IPv4 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/pseudo_ipv4'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/response_buffering:
get:
tags:
- Zone Settings
summary: Get Response Buffering setting
description: Enables or disables buffering of responses from the proxied server.
Cloudflare may buffer the whole payload to deliver it at once to the client
versus allowing it to be delivered in chunks. By default, the proxied server
streams directly and is not buffered by Cloudflare. This is limited to Enterprise
Zones.
operationId: zone-settings-get-response-buffering-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Response Buffering setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/response_buffering'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Response Buffering setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/response_buffering'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Response Buffering setting
description: Enables or disables buffering of responses from the proxied server.
Cloudflare may buffer the whole payload to deliver it at once to the client
versus allowing it to be delivered in chunks. By default, the proxied server
streams directly and is not buffered by Cloudflare. This is limited to Enterprise
Zones.
operationId: zone-settings-change-response-buffering-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/response_buffering_value'
responses:
4xx:
description: Change Response Buffering setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/response_buffering'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Response Buffering setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/response_buffering'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/rocket_loader:
get:
tags:
- Zone Settings
summary: Get Rocket Loader setting
description: Rocket Loader is a general-purpose asynchronous JavaScript optimisation
that prioritises rendering your content while loading your site's Javascript
asynchronously. Turning on Rocket Loader will immediately improve a web page's
rendering time sometimes measured as Time to First Paint (TTFP), and also
the `window.onload` time (assuming there is JavaScript on the page). This
can have a positive impact on your Google search ranking. When turned on,
Rocket Loader will automatically defer the loading of all Javascript referenced
in your HTML, with no configuration required. Refer to [Understanding Rocket
Loader](https://support.cloudflare.com/hc/articles/200168056) for more information.
operationId: zone-settings-get-rocket-loader-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Rocket Loader setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/rocket_loader'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Rocket Loader setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/rocket_loader'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Rocket Loader setting
description: Rocket Loader is a general-purpose asynchronous JavaScript optimisation
that prioritises rendering your content while loading your site's Javascript
asynchronously. Turning on Rocket Loader will immediately improve a web page's
rendering time sometimes measured as Time to First Paint (TTFP), and also
the `window.onload` time (assuming there is JavaScript on the page). This
can have a positive impact on your Google search ranking. When turned on,
Rocket Loader will automatically defer the loading of all Javascript referenced
in your HTML, with no configuration required. Refer to [Understanding Rocket
Loader](https://support.cloudflare.com/hc/articles/200168056) for more information.
operationId: zone-settings-change-rocket-loader-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/rocket_loader_value'
responses:
4xx:
description: Change Rocket Loader setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/rocket_loader'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Rocket Loader setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/rocket_loader'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/security_header:
get:
tags:
- Zone Settings
summary: Get Security Header (HSTS) setting
description: Cloudflare security header for a zone.
operationId: zone-settings-get-security-header-(-hsts)-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Security Header (HSTS) setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_header'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Security Header (HSTS) setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_header'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Security Header (HSTS) setting
description: Cloudflare security header for a zone.
operationId: zone-settings-change-security-header-(-hsts)-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/security_header_value'
responses:
4xx:
description: Change Security Header (HSTS) setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_header'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Security Header (HSTS) setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_header'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/security_level:
get:
tags:
- Zone Settings
summary: Get Security Level setting
description: Choose the appropriate security profile for your website, which
will automatically adjust each of the security settings. If you choose to
customize an individual security setting, the profile will become Custom.
(https://support.cloudflare.com/hc/en-us/articles/200170056).
operationId: zone-settings-get-security-level-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Security Level setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_level'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Security Level setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_level'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Security Level setting
description: Choose the appropriate security profile for your website, which
will automatically adjust each of the security settings. If you choose to
customize an individual security setting, the profile will become Custom.
(https://support.cloudflare.com/hc/en-us/articles/200170056).
operationId: zone-settings-change-security-level-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/security_level_value'
responses:
4xx:
description: Change Security Level setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_level'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Security Level setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/security_level'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/server_side_exclude:
get:
tags:
- Zone Settings
summary: Get Server Side Exclude setting
description: 'If there is sensitive content on your website that you want visible
to real visitors, but that you want to hide from suspicious visitors, all
you have to do is wrap the content with Cloudflare SSE tags. Wrap any content
that you want to be excluded from suspicious visitors in the following SSE
tags: . For example: Bad visitors won''t
see my phone number, 555-555-5555 . Note: SSE only will work with
HTML. If you have HTML minification enabled, you won''t see the SSE tags in
your HTML source when it''s served through Cloudflare. SSE will still function
in this case, as Cloudflare''s HTML minification and SSE functionality occur
on-the-fly as the resource moves through our network to the visitor''s computer.
(https://support.cloudflare.com/hc/en-us/articles/200170036).'
operationId: zone-settings-get-server-side-exclude-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Server Side Exclude setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/server_side_exclude'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Server Side Exclude setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/server_side_exclude'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Server Side Exclude setting
description: 'If there is sensitive content on your website that you want visible
to real visitors, but that you want to hide from suspicious visitors, all
you have to do is wrap the content with Cloudflare SSE tags. Wrap any content
that you want to be excluded from suspicious visitors in the following SSE
tags: . For example: Bad visitors won''t
see my phone number, 555-555-5555 . Note: SSE only will work with
HTML. If you have HTML minification enabled, you won''t see the SSE tags in
your HTML source when it''s served through Cloudflare. SSE will still function
in this case, as Cloudflare''s HTML minification and SSE functionality occur
on-the-fly as the resource moves through our network to the visitor''s computer.
(https://support.cloudflare.com/hc/en-us/articles/200170036).'
operationId: zone-settings-change-server-side-exclude-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/server_side_exclude_value'
responses:
4xx:
description: Change Server Side Exclude setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/server_side_exclude'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Server Side Exclude setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/server_side_exclude'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/sort_query_string_for_cache:
get:
tags:
- Zone Settings
summary: Get Enable Query String Sort setting
description: Cloudflare will treat files with the same query strings as the
same file in cache, regardless of the order of the query strings. This is
limited to Enterprise Zones.
operationId: zone-settings-get-enable-query-string-sort-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Enable Query String Sort setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/sort_query_string_for_cache'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Enable Query String Sort setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/sort_query_string_for_cache'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Enable Query String Sort setting
description: Cloudflare will treat files with the same query strings as the
same file in cache, regardless of the order of the query strings. This is
limited to Enterprise Zones.
operationId: zone-settings-change-enable-query-string-sort-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/sort_query_string_for_cache_value'
responses:
4xx:
description: Change Enable Query String Sort setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/sort_query_string_for_cache'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Enable Query String Sort setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/sort_query_string_for_cache'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/ssl:
get:
tags:
- Zone Settings
summary: Get SSL setting
description: 'SSL encrypts your visitor''s connection and safeguards credit
card numbers and other personal data to and from your website. SSL can take
up to 5 minutes to fully activate. Requires Cloudflare active on your root
domain or www domain. Off: no SSL between the visitor and Cloudflare, and
no SSL between Cloudflare and your web server (all HTTP traffic). Flexible:
SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site,
but no SSL between Cloudflare and your web server. You don''t need to have
an SSL cert on your web server, but your vistors will still see the site as
being HTTPS enabled. Full: SSL between the visitor and Cloudflare -- visitor
sees HTTPS on your site, and SSL between Cloudflare and your web server. You''ll
need to have your own SSL cert or self-signed cert at the very least. Full
(Strict): SSL between the visitor and Cloudflare -- visitor sees HTTPS on
your site, and SSL between Cloudflare and your web server. You''ll need to
have a valid SSL certificate installed on your web server. This certificate
must be signed by a certificate authority, have an expiration date in the
future, and respond for the request domain name (hostname). (https://support.cloudflare.com/hc/en-us/articles/200170416).'
operationId: zone-settings-get-ssl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get SSL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get SSL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change SSL setting
description: 'SSL encrypts your visitor''s connection and safeguards credit
card numbers and other personal data to and from your website. SSL can take
up to 5 minutes to fully activate. Requires Cloudflare active on your root
domain or www domain. Off: no SSL between the visitor and Cloudflare, and
no SSL between Cloudflare and your web server (all HTTP traffic). Flexible:
SSL between the visitor and Cloudflare -- visitor sees HTTPS on your site,
but no SSL between Cloudflare and your web server. You don''t need to have
an SSL cert on your web server, but your vistors will still see the site as
being HTTPS enabled. Full: SSL between the visitor and Cloudflare -- visitor
sees HTTPS on your site, and SSL between Cloudflare and your web server. You''ll
need to have your own SSL cert or self-signed cert at the very least. Full
(Strict): SSL between the visitor and Cloudflare -- visitor sees HTTPS on
your site, and SSL between Cloudflare and your web server. You''ll need to
have a valid SSL certificate installed on your web server. This certificate
must be signed by a certificate authority, have an expiration date in the
future, and respond for the request domain name (hostname). (https://support.cloudflare.com/hc/en-us/articles/200170416).'
operationId: zone-settings-change-ssl-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/ssl_value'
responses:
4xx:
description: Change SSL setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change SSL setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/ssl_recommender:
get:
tags:
- Zone Settings
summary: Get SSL/TLS Recommender enrollment
description: Enrollment in the SSL/TLS Recommender service which tries to detect
and recommend (by sending periodic emails) the most secure SSL/TLS setting
your origin servers support.
operationId: zone-settings-get-ssl/-tls-recommender-enrollment
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get SSL/TLS Recommender enrollment response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl_recommender'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get SSL/TLS Recommender enrollment response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl_recommender'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change SSL/TLS Recommender enrollment
description: Enrollment in the SSL/TLS Recommender service which tries to detect
and recommend (by sending periodic emails) the most secure SSL/TLS setting
your origin servers support.
operationId: zone-settings-change-ssl/-tls-recommender-enrollment
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- enabled
properties:
enabled:
$ref: '#/components/schemas/ssl_recommender_enabled'
responses:
4xx:
description: Change SSL/TLS Recommender enrollment response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl_recommender'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change SSL/TLS Recommender enrollment response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/ssl_recommender'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/tls_1_3:
get:
tags:
- Zone Settings
summary: Get TLS 1.3 setting enabled for a zone
description: Gets TLS 1.3 setting enabled for a zone.
operationId: zone-settings-get-tls-1.-3-setting-enabled-for-a-zone
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get TLS 1.3 setting enabled for a zone response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_1_3'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get TLS 1.3 setting enabled for a zone response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_1_3'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change TLS 1.3 setting
description: Changes TLS 1.3 setting.
operationId: zone-settings-change-tls-1.-3-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/tls_1_3_value'
responses:
4xx:
description: Change TLS 1.3 setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_1_3'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change TLS 1.3 setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_1_3'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/tls_client_auth:
get:
tags:
- Zone Settings
summary: Get TLS Client Auth setting
description: TLS Client Auth requires Cloudflare to connect to your origin server
using a client certificate (Enterprise Only).
operationId: zone-settings-get-tls-client-auth-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get TLS Client Auth setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_client_auth'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get TLS Client Auth setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_client_auth'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change TLS Client Auth setting
description: TLS Client Auth requires Cloudflare to connect to your origin server
using a client certificate (Enterprise Only).
operationId: zone-settings-change-tls-client-auth-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/tls_client_auth_value'
responses:
4xx:
description: Change TLS Client Auth setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_client_auth'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change TLS Client Auth setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/tls_client_auth'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/true_client_ip_header:
get:
tags:
- Zone Settings
summary: Get True Client IP setting
description: Allows customer to continue to use True Client IP (Akamai feature)
in the headers we send to the origin. This is limited to Enterprise Zones.
operationId: zone-settings-get-true-client-ip-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get True Client IP setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/true_client_ip_header'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get True Client IP setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/true_client_ip_header'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change True Client IP setting
description: Allows customer to continue to use True Client IP (Akamai feature)
in the headers we send to the origin. This is limited to Enterprise Zones.
operationId: zone-settings-change-true-client-ip-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/true_client_ip_header_value'
responses:
4xx:
description: Change True Client IP setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/true_client_ip_header'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change True Client IP setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/true_client_ip_header'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/waf:
get:
tags:
- Zone Settings
summary: Get Web Application Firewall (WAF) setting
description: The WAF examines HTTP requests to your website. It inspects both
GET and POST requests and applies rules to help filter out illegitimate traffic
from legitimate website visitors. The Cloudflare WAF inspects website addresses
or URLs to detect anything out of the ordinary. If the Cloudflare WAF determines
suspicious user behavior, then the WAF will 'challenge' the web visitor with
a page that asks them to submit a CAPTCHA successfully to continue their
action. If the challenge is failed, the action will be stopped. What this
means is that Cloudflare's WAF will block any traffic identified as illegitimate
before it reaches your origin web server. (https://support.cloudflare.com/hc/en-us/articles/200172016).
operationId: zone-settings-get-web-application-firewall-(-waf)-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Web Application Firewall (WAF) setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/waf'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Web Application Firewall (WAF) setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/waf'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change Web Application Firewall (WAF) setting
description: The WAF examines HTTP requests to your website. It inspects both
GET and POST requests and applies rules to help filter out illegitimate traffic
from legitimate website visitors. The Cloudflare WAF inspects website addresses
or URLs to detect anything out of the ordinary. If the Cloudflare WAF determines
suspicious user behavior, then the WAF will 'challenge' the web visitor with
a page that asks them to submit a CAPTCHA successfully to continue their
action. If the challenge is failed, the action will be stopped. What this
means is that Cloudflare's WAF will block any traffic identified as illegitimate
before it reaches your origin web server. (https://support.cloudflare.com/hc/en-us/articles/200172016).
operationId: zone-settings-change-web-application-firewall-(-waf)-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/waf_value'
responses:
4xx:
description: Change Web Application Firewall (WAF) setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/waf'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change Web Application Firewall (WAF) setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/waf'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/webp:
get:
tags:
- Zone Settings
summary: Get WebP setting
description: When the client requesting the image supports the WebP image codec,
and WebP offers a performance advantage over the original image format, Cloudflare
will serve a WebP version of the original image.
operationId: zone-settings-get-web-p-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get WebP setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/webp'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get WebP setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/webp'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change WebP setting
description: When the client requesting the image supports the WebP image codec,
and WebP offers a performance advantage over the original image format, Cloudflare
will serve a WebP version of the original image.
operationId: zone-settings-change-web-p-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/webp_value'
responses:
4xx:
description: Change WebP setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/webp'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change WebP setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/webp'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/settings/websockets:
get:
tags:
- Zone Settings
summary: Get WebSockets setting
description: Gets Websockets setting. For more information about Websockets,
please refer to [Using Cloudflare with WebSockets](https://support.cloudflare.com/hc/en-us/articles/200169466-Using-Cloudflare-with-WebSockets).
operationId: zone-settings-get-web-sockets-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get WebSockets setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/websockets'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get WebSockets setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/websockets'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Zone Settings
summary: Change WebSockets setting
description: Changes Websockets setting. For more information about Websockets,
please refer to [Using Cloudflare with WebSockets](https://support.cloudflare.com/hc/en-us/articles/200169466-Using-Cloudflare-with-WebSockets).
operationId: zone-settings-change-web-sockets-setting
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
required:
- value
properties:
value:
$ref: '#/components/schemas/websockets_value'
responses:
4xx:
description: Change WebSockets setting response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/websockets'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Change WebSockets setting response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone_settings_response_single'
- properties:
result:
$ref: '#/components/schemas/websockets'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/certificate_packs:
get:
tags:
- Certificate Packs
summary: List Certificate Packs
description: For a given zone, list all active certificate packs.
operationId: certificate-packs-list-certificate-packs
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Certificate Packs response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_pack_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Certificate Packs response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_pack_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Certificate Packs
summary: Order Certificate Pack
description: For a given zone, order a certificate pack with a list of hostnames.
operationId: certificate-packs-order-certificate-pack
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
hosts:
$ref: '#/components/schemas/schemas-hosts'
responses:
4xx:
description: Order Certificate Pack response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_pack_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Order Certificate Pack response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_pack_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/certificate_packs/{identifier}:
delete:
tags:
- Certificate Packs
summary: Delete Advanced Certificate Manager Certificate Pack
description: For a given zone, delete an advanced certificate pack.
operationId: certificate-packs-delete-advanced-certificate-manager-certificate-pack
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/certificate-packs_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Advanced Certificate Manager Certificate Pack response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/delete_advanced_certificate_pack_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Advanced Certificate Manager Certificate Pack response
content:
application/json:
schema:
$ref: '#/components/schemas/delete_advanced_certificate_pack_response_single'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Certificate Packs
summary: Get Certificate Pack
description: For a given zone, get a certificate pack.
operationId: certificate-packs-get-certificate-pack
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/certificate-packs_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Certificate Pack response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_pack_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Certificate Pack response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_pack_response_single'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Certificate Packs
summary: Restart Validation for Advanced Certificate Manager Certificate Pack
description: For a given zone, restart validation for an advanced certificate
pack. This is only a validation operation for a Certificate Pack in a validation_timed_out
status.
operationId: certificate-packs-restart-validation-for-advanced-certificate-manager-certificate-pack
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/certificate-packs_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Restart Validation for Advanced Certificate Manager Certificate
Pack response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/advanced_certificate_pack_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Restart Validation for Advanced Certificate Manager Certificate
Pack response
content:
application/json:
schema:
$ref: '#/components/schemas/advanced_certificate_pack_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/certificate_packs/order:
post:
tags:
- Certificate Packs
summary: Order Advanced Certificate Manager Certificate Pack
description: For a given zone, order an advanced certificate pack.
operationId: certificate-packs-order-advanced-certificate-manager-certificate-pack
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- type
- hosts
- validation_method
- validity_days
- certificate_authority
properties:
certificate_authority:
$ref: '#/components/schemas/certificate_authority'
cloudflare_branding:
$ref: '#/components/schemas/cloudflare_branding'
hosts:
$ref: '#/components/schemas/schemas-hosts'
type:
$ref: '#/components/schemas/advanced_type'
validation_method:
$ref: '#/components/schemas/validation_method'
validity_days:
$ref: '#/components/schemas/validity_days'
responses:
4xx:
description: Order Advanced Certificate Manager Certificate Pack response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/advanced_certificate_pack_response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Order Advanced Certificate Manager Certificate Pack response
content:
application/json:
schema:
$ref: '#/components/schemas/advanced_certificate_pack_response_single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/certificate_packs/quota:
get:
tags:
- Certificate Packs
summary: Get Certificate Pack Quotas
description: For a given zone, list certificate pack quotas.
operationId: certificate-packs-get-certificate-pack-quotas
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Certificate Pack Quotas response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/certificate_pack_quota_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Certificate Pack Quotas response
content:
application/json:
schema:
$ref: '#/components/schemas/certificate_pack_quota_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/recommendation:
get:
tags:
- SSL/TLS Mode Recommendation
summary: SSL/TLS Recommendation
description: Retrieve the SSL/TLS Recommender's recommendation for a zone.
operationId: ssl/-tls-mode-recommendation-ssl/-tls-recommendation
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: SSL/TLS Recommendation response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/schemas-id'
modified_on:
$ref: '#/components/schemas/timestamp'
value:
$ref: '#/components/schemas/components-schemas-value'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: SSL/TLS Recommendation response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- properties:
result:
properties:
id:
$ref: '#/components/schemas/schemas-id'
modified_on:
$ref: '#/components/schemas/timestamp'
value:
$ref: '#/components/schemas/components-schemas-value'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/universal/settings:
get:
tags:
- Universal SSL Settings for a Zone
summary: Universal SSL Settings Details
description: Get Universal SSL Settings for a Zone.
operationId: universal-ssl-settings-for-a-zone-universal-ssl-settings-details
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Universal SSL Settings Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssl_universal_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Universal SSL Settings Details response
content:
application/json:
schema:
$ref: '#/components/schemas/ssl_universal_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Universal SSL Settings for a Zone
summary: Edit Universal SSL Settings
description: Patch Universal SSL Settings for a Zone.
operationId: universal-ssl-settings-for-a-zone-edit-universal-ssl-settings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/universal'
responses:
4xx:
description: Edit Universal SSL Settings response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssl_universal_settings_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Universal SSL Settings response
content:
application/json:
schema:
$ref: '#/components/schemas/ssl_universal_settings_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/verification:
get:
tags:
- SSL Verification
summary: SSL Verification Details
description: Get SSL Verification Info for a Zone.
operationId: ssl-verification-ssl-verification-details
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: SSL Verification Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssl_verification_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: SSL Verification Details response
content:
application/json:
schema:
$ref: '#/components/schemas/ssl_verification_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/ssl/verification/{cert_pack_uuid}:
patch:
tags:
- SSL Verification
summary: Edit SSL Certificate Pack Validation Method
description: Edit SSL validation method for a certificate pack. A PATCH request
will request an immediate validation check on any certificate, and return
the updated status. If a validation method is provided, the validation will
be immediately attempted using that method.
operationId: ssl-verification-edit-ssl-certificate-pack-validation-method
parameters:
- name: cert_pack_uuid
in: path
required: true
schema:
$ref: '#/components/schemas/cert_pack_uuid'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-validation_method'
responses:
4xx:
description: Edit SSL Certificate Pack Validation Method response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssl_validation_method_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit SSL Certificate Pack Validation Method response
content:
application/json:
schema:
$ref: '#/components/schemas/ssl_validation_method_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms:
get:
tags:
- Waiting Room
summary: List waiting rooms
description: Lists waiting rooms.
operationId: waiting-room-list-waiting-rooms
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List waiting rooms response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waitingroom_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List waiting rooms response
content:
application/json:
schema:
$ref: '#/components/schemas/waitingroom_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Waiting Room
summary: Create waiting room
description: Creates a new waiting room.
operationId: waiting-room-create-waiting-room
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_waitingroom'
responses:
4xx:
description: Create waiting room response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waitingroom_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create waiting room response
content:
application/json:
schema:
$ref: '#/components/schemas/waitingroom_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}:
delete:
tags:
- Waiting Room
summary: Delete waiting room
description: Deletes a waiting room.
operationId: waiting-room-delete-waiting-room
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete waiting room response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waiting_room_id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete waiting room response
content:
application/json:
schema:
$ref: '#/components/schemas/waiting_room_id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Waiting Room
summary: Waiting room details
description: Fetches a single configured waiting room.
operationId: waiting-room-waiting-room-details
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Waiting room details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waitingroom_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Waiting room details response
content:
application/json:
schema:
$ref: '#/components/schemas/waitingroom_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Waiting Room
summary: Patch waiting room
description: Patches a configured waiting room.
operationId: waiting-room-patch-waiting-room
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_waitingroom'
responses:
4xx:
description: Patch waiting room response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waitingroom_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch waiting room response
content:
application/json:
schema:
$ref: '#/components/schemas/waitingroom_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Waiting Room
summary: Update waiting room
description: Updates a configured waiting room.
operationId: waiting-room-update-waiting-room
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_waitingroom'
responses:
4xx:
description: Update waiting room response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/waitingroom_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update waiting room response
content:
application/json:
schema:
$ref: '#/components/schemas/waitingroom_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/events:
get:
tags:
- Waiting Room
summary: List events
description: Lists events for a waiting room.
operationId: waiting-room-list-events
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List events response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List events response
content:
application/json:
schema:
$ref: '#/components/schemas/event_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Waiting Room
summary: Create event
description: Only available for the Waiting Room Advanced subscription. Creates
an event for a waiting room. An event takes place during a specified period
of time, temporarily changing the behavior of a waiting room. While the event
is active, some of the properties in the event's configuration may either
override or inherit from the waiting room's configuration. Note that events
cannot overlap with each other, so only one event can be active at a time.
operationId: waiting-room-create-event
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_event'
responses:
4xx:
description: Create event response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create event response
content:
application/json:
schema:
$ref: '#/components/schemas/event_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/events/{event_id}:
delete:
tags:
- Waiting Room
summary: Delete event
description: Deletes an event for a waiting room.
operationId: waiting-room-delete-event
parameters:
- name: event_id
in: path
required: true
schema:
$ref: '#/components/schemas/event_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete event response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_id_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete event response
content:
application/json:
schema:
$ref: '#/components/schemas/event_id_response'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Waiting Room
summary: Event details
description: Fetches a single configured event for a waiting room.
operationId: waiting-room-event-details
parameters:
- name: event_id
in: path
required: true
schema:
$ref: '#/components/schemas/event_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Event details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Event details response
content:
application/json:
schema:
$ref: '#/components/schemas/event_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Waiting Room
summary: Patch event
description: Patches a configured event for a waiting room.
operationId: waiting-room-patch-event
parameters:
- name: event_id
in: path
required: true
schema:
$ref: '#/components/schemas/event_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_event'
responses:
4xx:
description: Patch event response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch event response
content:
application/json:
schema:
$ref: '#/components/schemas/event_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Waiting Room
summary: Update event
description: Updates a configured event for a waiting room.
operationId: waiting-room-update-event
parameters:
- name: event_id
in: path
required: true
schema:
$ref: '#/components/schemas/event_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_event'
responses:
4xx:
description: Update event response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update event response
content:
application/json:
schema:
$ref: '#/components/schemas/event_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/events/{event_id}/details:
get:
tags:
- Waiting Room
summary: Preview active event details
description: Previews an event's configuration as if it was active. Inherited
fields from the waiting room will be displayed with their current values.
operationId: waiting-room-preview-active-event-details
parameters:
- name: event_id
in: path
required: true
schema:
$ref: '#/components/schemas/event_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Preview active event details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/event_details_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Preview active event details response
content:
application/json:
schema:
$ref: '#/components/schemas/event_details_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/rules:
get:
tags:
- Waiting Room
summary: List Waiting Room Rules
description: Lists rules for a waiting room.
operationId: waiting-room-list-waiting-room-rules
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Waiting Room Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Waiting Room Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Waiting Room
summary: Create Waiting Room Rule
description: Only available for the Waiting Room Advanced subscription. Creates
a rule for a waiting room.
operationId: waiting-room-create-waiting-room-rule
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_rule'
responses:
4xx:
description: Create Waiting Room Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Waiting Room Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Waiting Room
summary: Replace Waiting Room Rules
description: Only available for the Waiting Room Advanced subscription. Replaces
all rules for a waiting room.
operationId: waiting-room-replace-waiting-room-rules
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/update_rules'
responses:
4xx:
description: Replace Waiting Room Rules response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Replace Waiting Room Rules response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/rules/{rule_id}:
delete:
tags:
- Waiting Room
summary: Delete Waiting Room Rule
description: Deletes a rule for a waiting room.
operationId: waiting-room-delete-waiting-room-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rule_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Waiting Room Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Waiting Room Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Waiting Room
summary: Patch Waiting Room Rule
description: Patches a rule for a waiting room.
operationId: waiting-room-patch-waiting-room-rule
parameters:
- name: rule_id
in: path
required: true
schema:
$ref: '#/components/schemas/rule_id'
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/patch_rule'
responses:
4xx:
description: Patch Waiting Room Rule response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-rules_response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Patch Waiting Room Rule response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-rules_response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/{waiting_room_id}/status:
get:
tags:
- Waiting Room
summary: Get waiting room status
description: "Fetches the status of a configured waiting room. Response fields
include:\n1. `status`: String indicating the status of the waiting room. The
possible status are:\n\t- **not_queueing** indicates that the configured thresholds
have not been met and all users are going through to the origin.\n\t- **queueing**
indicates that the thresholds have been met and some users are held in the
waiting room.\n\t- **event_prequeueing** indicates that an event is active
and is currently prequeueing users before it starts.\n2. `event_id`: String
of the current event's `id` if an event is active, otherwise an empty string.\n3.
`estimated_queued_users`: Integer of the estimated number of users currently
waiting in the queue.\n4. `estimated_total_active_users`: Integer of the estimated
number of users currently active on the origin.\n5. `max_estimated_time_minutes`:
Integer of the maximum estimated time currently presented to the users."
operationId: waiting-room-get-waiting-room-status
parameters:
- name: waiting_room_id
in: path
required: true
schema:
$ref: '#/components/schemas/waiting_room_id'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get waiting room status response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/status_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get waiting room status response
content:
application/json:
schema:
$ref: '#/components/schemas/status_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/waiting_rooms/preview:
post:
tags:
- Waiting Room
summary: Create a custom waiting room page preview
description: "Creates a waiting room page preview. Upload a custom waiting room
page for preview. You will receive a preview URL in the form `http://waitingrooms.dev/preview/`.
You can use the following query parameters to change the state of the preview:\n1.
`force_queue`: Boolean indicating if all users will be queued in the waiting
room and no one will be let into the origin website (also known as queueAll).\n2.
`queue_is_full`: Boolean indicating if the waiting room's queue is currently
full and not accepting new users at the moment.\n3. `queueing_method`: The
queueing method currently used by the waiting room.\n\t- **fifo** indicates
a FIFO queue.\n\t- **random** indicates a Random queue.\n\t- **passthrough**
indicates a Passthrough queue. Keep in mind that the waiting room page will
only be displayed if `force_queue=true` or `event=prequeueing` — for other
cases the request will pass through to the origin. For our preview, this will
be a fake origin website returning \"Welcome\". \n\t- **reject** indicates
a Reject queue.\n4. `event`: Used to preview a waiting room event.\n\t- **none**
indicates no event is occurring.\n\t- **prequeueing** indicates that an event
is prequeueing (between `prequeue_start_time` and `event_start_time`).\n\t-
**started** indicates that an event has started (between `event_start_time`
and `event_end_time`).\n5. `shuffle_at_event_start`: Boolean indicating if
the event will shuffle users in the prequeue when it starts. This can only
be set to **true** if an event is active (`event` is not **none**).\n\nFor
example, you can make a request to `http://waitingrooms.dev/preview/?force_queue=false&queue_is_full=false&queueing_method=random&event=started&shuffle_at_event_start=true`\n6.
`waitTime`: Non-zero, positive integer indicating the estimated wait time
in minutes. The default value is 10 minutes.\n\nFor example, you can make
a request to `http://waitingrooms.dev/preview/?waitTime=50` to configure
the estimated wait time as 50 minutes."
operationId: waiting-room-create-a-custom-waiting-room-page-preview
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/query_preview'
responses:
4xx:
description: Create a custom waiting room page preview response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-preview_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create a custom waiting room page preview response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-preview_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/web3/hostnames:
get:
tags:
- Web3 Hostname
summary: List Web3 Hostnames
operationId: web3-hostname-list-web3-hostnames
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Web3 Hostnames response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/components-schemas-collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Web3 Hostnames response
content:
application/json:
schema:
$ref: '#/components/schemas/components-schemas-collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Web3 Hostname
summary: Create Web3 Hostname
operationId: web3-hostname-create-web3-hostname
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/create_request'
responses:
4xx:
description: Create Web3 Hostname response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Web3 Hostname response
content:
application/json:
schema:
$ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/web3/hostnames/{identifier}:
delete:
tags:
- Web3 Hostname
summary: Delete Web3 Hostname
operationId: web3-hostname-delete-web3-hostname
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Web3 Hostname response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Web3 Hostname response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Web3 Hostname
summary: Web3 Hostname Details
operationId: web3-hostname-web3-hostname-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Web3 Hostname Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Web3 Hostname Details response
content:
application/json:
schema:
$ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
patch:
tags:
- Web3 Hostname
summary: Edit Web3 Hostname
operationId: web3-hostname-edit-web3-hostname
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/modify_request'
responses:
4xx:
description: Edit Web3 Hostname response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit Web3 Hostname response
content:
application/json:
schema:
$ref: '#/components/schemas/web3-hostname_components-schemas-single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/web3/hostnames/{identifier}/ipfs_universal_path/content_list:
get:
tags:
- Web3 Hostname
summary: IPFS Universal Path Gateway Content List Details
operationId: web3-hostname-ipfs-universal-path-gateway-content-list-details
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: IPFS Universal Path Gateway Content List Details response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_details_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: IPFS Universal Path Gateway Content List Details response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_details_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Web3 Hostname
summary: Update IPFS Universal Path Gateway Content List
operationId: web3-hostname-update-ipfs-universal-path-gateway-content-list
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_update_request'
responses:
4xx:
description: Update IPFS Universal Path Gateway Content List response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_details_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update IPFS Universal Path Gateway Content List response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_details_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/web3/hostnames/{identifier}/ipfs_universal_path/content_list/entries:
get:
tags:
- Web3 Hostname
summary: List IPFS Universal Path Gateway Content List Entries
operationId: web3-hostname-list-ipfs-universal-path-gateway-content-list-entries
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List IPFS Universal Path Gateway Content List Entries response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_entry_collection_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List IPFS Universal Path Gateway Content List Entries response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_collection_response'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Web3 Hostname
summary: Create IPFS Universal Path Gateway Content List Entry
operationId: web3-hostname-create-ipfs-universal-path-gateway-content-list-entry
parameters:
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_create_request'
responses:
4xx:
description: Create IPFS Universal Path Gateway Content List Entry response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_entry_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create IPFS Universal Path Gateway Content List Entry response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/web3/hostnames/{identifier}/ipfs_universal_path/content_list/entries/{content_list_entry_identifier}:
delete:
tags:
- Web3 Hostname
summary: Delete IPFS Universal Path Gateway Content List Entry
operationId: web3-hostname-delete-ipfs-universal-path-gateway-content-list-entry
parameters:
- name: content_list_entry_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete IPFS Universal Path Gateway Content List Entry response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single-id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete IPFS Universal Path Gateway Content List Entry response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single-id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Web3 Hostname
summary: IPFS Universal Path Gateway Content List Entry Details
operationId: web3-hostname-ipfs-universal-path-gateway-content-list-entry-details
parameters:
- name: content_list_entry_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: IPFS Universal Path Gateway Content List Entry Details response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_entry_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: IPFS Universal Path Gateway Content List Entry Details response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_single_response'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Web3 Hostname
summary: Edit IPFS Universal Path Gateway Content List Entry
operationId: web3-hostname-edit-ipfs-universal-path-gateway-content-list-entry
parameters:
- name: content_list_entry_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_create_request'
responses:
4xx:
description: Edit IPFS Universal Path Gateway Content List Entry response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/content_list_entry_single_response'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Edit IPFS Universal Path Gateway Content List Entry response
content:
application/json:
schema:
$ref: '#/components/schemas/content_list_entry_single_response'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/workers/script:
delete:
tags:
- Worker Script (Deprecated)
summary: Delete Worker
description: Delete your worker. This call has no response body on a successful
delete.
operationId: worker-script-(-deprecated)-delete-worker
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Worker response failure
content:
application/json: {}
"200":
description: Delete Worker response
content:
application/json: {}
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Worker Script (Deprecated)
summary: Download Worker
description: Fetch raw script content for your worker. Note this is the original
script content, not JSON encoded.
operationId: worker-script-(-deprecated)-download-worker
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Download Worker response failure
content:
undefined:
schema:
example: addEventListener('fetch', event => { event.respondWith(fetch(event.request))
})
"200":
description: Download Worker response
content:
undefined:
schema:
example: addEventListener('fetch', event => { event.respondWith(fetch(event.request))
})
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Worker Script (Deprecated)
summary: Upload Worker
description: Upload a worker, or a new version of a worker.
operationId: worker-script-(-deprecated)-upload-worker
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/javascript:
schema:
example: addEventListener('fetch', event => { event.respondWith(fetch(event.request))
})
responses:
4xx:
description: Upload Worker response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/script-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Upload Worker response
content:
application/json:
schema:
$ref: '#/components/schemas/script-response-single'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone_identifier}/workers/script/bindings:
get:
tags:
- Worker Binding (Deprecated)
summary: List Bindings
description: List the bindings for a Workers script.
operationId: worker-binding-(-deprecated)-list-bindings
parameters:
- name: zone_identifier
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Bindings response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/binding'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Bindings response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-common'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/binding'
deprecated: true
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone}/spectrum/analytics/aggregate/current:
get:
tags:
- Spectrum Aggregate Analytics
summary: Get current aggregated analytics
description: Retrieves analytics aggregated from the last minute of usage on
Spectrum applications underneath a given zone.
operationId: spectrum-aggregate-analytics-get-current-aggregated-analytics
parameters:
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get current aggregated analytics response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/analytics-aggregate_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get current aggregated analytics response
content:
application/json:
schema:
$ref: '#/components/schemas/analytics-aggregate_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone}/spectrum/analytics/events/bytime:
get:
tags:
- Spectrum Analytics (By Time)
summary: Get analytics by time
description: Retrieves a list of aggregate metrics grouped by time interval.
operationId: spectrum-analytics-(-by-time)-get-analytics-by-time
parameters:
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get analytics by time response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get analytics by time response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone}/spectrum/analytics/events/summary:
get:
tags:
- Spectrum Analytics (Summary)
summary: Get analytics summary
description: Retrieves a list of summarised aggregate metrics over a given time
period.
operationId: spectrum-analytics-(-summary)-get-analytics-summary
parameters:
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get analytics summary response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get analytics summary response
content:
application/json:
schema:
$ref: '#/components/schemas/api-response-single'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone}/spectrum/apps:
get:
tags:
- Spectrum Applications
summary: List Spectrum applications
description: Retrieves a list of currently existing Spectrum applications inside
a zone.
operationId: spectrum-applications-list-spectrum-applications
parameters:
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: List Spectrum applications response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/app_components-schemas-response_collection'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: List Spectrum applications response
content:
application/json:
schema:
$ref: '#/components/schemas/app_components-schemas-response_collection'
security:
- api_email: []
api_key: []
- api_token: []
post:
tags:
- Spectrum Applications
summary: Create Spectrum application using a name for the origin
description: Creates a new Spectrum application from a configuration using a
name for the origin.
operationId: spectrum-applications-create-spectrum-application-using-a-name-for-the-origin
parameters:
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- protocol
- dns
- origin_dns
- origin_port
properties:
argo_smart_routing:
$ref: '#/components/schemas/argo_smart_routing'
dns:
$ref: '#/components/schemas/dns'
edge_ips:
$ref: '#/components/schemas/edge_ips'
ip_firewall:
$ref: '#/components/schemas/ip_firewall'
origin_dns:
$ref: '#/components/schemas/origin_dns'
origin_port:
$ref: '#/components/schemas/origin_port'
protocol:
$ref: '#/components/schemas/protocol'
proxy_protocol:
$ref: '#/components/schemas/proxy_protocol'
tls:
$ref: '#/components/schemas/tls'
traffic_type:
$ref: '#/components/schemas/traffic_type'
responses:
4xx:
description: Create Spectrum application using a name for the origin response
failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single_origin_dns'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Create Spectrum application using a name for the origin response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single_origin_dns'
security:
- api_email: []
api_key: []
- api_token: []
/zones/{zone}/spectrum/apps/{app_id}:
delete:
tags:
- Spectrum Applications
summary: Delete Spectrum application
description: Deletes a previously existing application.
operationId: spectrum-applications-delete-spectrum-application
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/app_id'
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json: {}
responses:
4xx:
description: Delete Spectrum application response failure
content:
application/json:
schema:
allOf:
- allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/app_id'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Delete Spectrum application response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api-response-single'
- type: object
properties:
result:
type: object
properties:
id:
$ref: '#/components/schemas/app_id'
security:
- api_email: []
api_key: []
- api_token: []
get:
tags:
- Spectrum Applications
summary: Get Spectrum application configuration
description: Gets the application configuration of a specific application inside
a zone.
operationId: spectrum-applications-get-spectrum-application-configuration
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/app_id'
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
responses:
4xx:
description: Get Spectrum application configuration response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/schemas-response_single'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Get Spectrum application configuration response
content:
application/json:
schema:
$ref: '#/components/schemas/schemas-response_single'
security:
- api_email: []
api_key: []
- api_token: []
put:
tags:
- Spectrum Applications
summary: Update Spectrum application configuration using a name for the origin
description: Updates a previously existing application's configuration that
uses a name for the origin.
operationId: spectrum-applications-update-spectrum-application-configuration-using-a-name-for-the-origin
parameters:
- name: app_id
in: path
required: true
schema:
$ref: '#/components/schemas/app_id'
- name: zone
in: path
required: true
schema:
$ref: '#/components/schemas/common_components-schemas-identifier'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- protocol
- dns
- origin_dns
- origin_port
properties:
argo_smart_routing:
$ref: '#/components/schemas/argo_smart_routing'
dns:
$ref: '#/components/schemas/dns'
edge_ips:
$ref: '#/components/schemas/edge_ips'
ip_firewall:
$ref: '#/components/schemas/ip_firewall'
origin_dns:
$ref: '#/components/schemas/origin_dns'
origin_port:
$ref: '#/components/schemas/origin_port'
protocol:
$ref: '#/components/schemas/protocol'
proxy_protocol:
$ref: '#/components/schemas/proxy_protocol'
tls:
$ref: '#/components/schemas/tls'
traffic_type:
$ref: '#/components/schemas/traffic_type'
responses:
4xx:
description: Update Spectrum application configuration using a name for
the origin response failure
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_single_origin_dns'
- $ref: '#/components/schemas/api-response-common-failure'
"200":
description: Update Spectrum application configuration using a name for
the origin response
content:
application/json:
schema:
$ref: '#/components/schemas/response_single_origin_dns'
security:
- api_email: []
api_key: []
- api_token: []
servers:
- url: https://api.cloudflare.com/client/v4
description: Client API