Developers

REST API reference

This reference tracks customer routes that actually exist.

#Overview

This reference tracks customer routes that actually exist.

#Read a reference operation

Each entry identifies method, path, authentication, role, parameters, body, response, and errors. Path identifiers come from list responses; never derive an ID from a display name.

Collections use a data field and can include metadata. Uploads use multipart/form-data while common mutations use JSON. Examples use placeholders and must not put a real secret in shell history.

#Before automation

Call /api/auth/me to verify token and organization.
List the resource and obtain its identifier.
Test the mutation on a non-critical resource.
Handle 401, 403, 404, 422, 429, and timeouts explicitly.

#Customer REST operations

Base URL: https://api.cdn.pizzaDownload OpenAPI 3.1

Authentication 3

POST /api/auth/login

With 2FA, create a personal token in the dashboard and use it directly.

Authentication: None
Roles: None
Success: 200

Request fields

Field	Type	Required	Description
`email`	string	yes	Verified email address.format: email
`password`	string	yes	Account password. Not accepted when 2FA is enabled.format: password
`device_name`	string	no	Human-readable token name.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/auth/login' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"email":"dev@example.com","password":"PASSWORD"}'

GET /api/auth/me

#Read the current profile

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/auth/me' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/auth/logout

#Revoke the current token

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/auth/logout' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Zones 3

GET /api/zones

#List zones

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/zones' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/zones

#Create, register, or transfer a zone

Registration and transfer are asynchronous and may return 202 with task_id.

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201 202

Request fields

Field	Type	Required	Description
`domain`	string	yes	Fully qualified domain name.
`name`	string	no	Dashboard display name.length: 0…255
`type`	string	no	cname or ns mode; defaults to ns.enum: cname \| ns
`registrar_action`	string	no	connect, register, or transfer.enum: connect \| register \| transfer
`transfer_auth_code`	string	no	Required for a transfer.length: 4…255
`registrant_name`	string	no	Required for registration/transfer.length: 0…255
`registrant_email`	string	no	Registrant email.format: email · length: 0…255
`registrant_phone`	string	no	Registrant international phone number.length: 0…40
`registrant_organization`	string	no	Registrant organization.length: 0…255
`registrant_street`	string	no	Registrant street address.length: 0…255
`registrant_city`	string	no	Registrant city.length: 0…120
`registrant_postal_code`	string	no	Registrant postal code.length: 0…30
`registrant_country_code`	string	no	Two-letter ISO country code.length: 2…2
`private_whois`	string	no	WHOIS privacy level.enum: FULL \| PARTIAL \| DISABLED

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/zones' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"domain":"assets.example.com"}'

GET /api/zones/{id}

#Read a zone

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Zone identifier.

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/zones/ZONE_ID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Cache 2

POST /api/zones/{id}/purge

#Purge a path

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Zone identifier.
`path`	string	no	Path to purge; when omitted, /* is used.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/zones/ZONE_ID/purge' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

POST /api/zones/{id}/purge-all

#Purge an entire zone

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Zone identifier.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/zones/ZONE_ID/purge-all' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Analytics 1

GET /api/zones/{id}/stats

#Read zone statistics

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Zone identifier.
`period`	string	no	24h, 7d, or 30d window; defaults to 24h.enum: 24h \| 7d \| 30d · default: "24h"

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/zones/ZONE_ID/stats?period=24h' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Files 4

GET /api/files

#List files

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`zone_id`	integer	no	Filter by zone.
`per_page`	integer	no	Page size; defaults to 25.range: 1…∞
`page`	integer	no	Page number.range: 1…∞

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/files?zone_id=42&per_page=25&page=1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/files

#Upload a file

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`file`	string	yes	File, up to 100 MB.format: binary
`zone_id`	integer	yes	Publishing zone.
`storage_nodes`	array<integer>	no	Up to three storage-node IDs.
`cache_ttl`	integer	no	Cache TTL in seconds; 0 is allowed.range: 0…∞
`direct_public_link`	boolean	no	Enable the direct storage link.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/files' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --form 'file=@./asset.png' \
  --form 'zone_id=42' \
  --form 'cache_ttl=3600' \
  --form 'direct_public_link=false'

GET /api/files/{uuid}

#Read a file

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`uuid`	string	yes	Public file UUID.format: uuid

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/files/FILE_UUID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

DELETE /api/files/{uuid}

#Delete a file

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 200

Request fields

Field	Type	Required	Description
`uuid`	string	yes	Public file UUID.format: uuid

Example

curl --request DELETE \
  --url 'https://api.cdn.pizza/api/files/FILE_UUID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Nodes 5

GET /api/nodes

#List available nodes

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/nodes' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/nodes

#Create a customer node

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`node_id`	string	yes	Unique node identifier.
`hostname`	string	yes	Node DNS hostname.
`ip_address`	string	yes	Node IPv4 or IPv6 address.
`region_id`	integer	yes	Existing region identifier.
`country`	string	yes	Two-letter ISO country code.length: 2…2

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/nodes' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"node_id":"edge-zurich-01","hostname":"edge-zurich-01.example.net","ip_address":"203.0.113.42","region_id":1,"country":"CH"}'

GET /api/nodes/tokens

#List BYOC tokens

Authentication: Personal Bearer token
Roles: owner, admin
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/nodes/tokens' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/nodes/tokens

#Create a BYOC token

Authentication: Personal Bearer token
Roles: owner, admin
Success: 201

Request fields

Field	Type	Required	Description
`name`	string	no	Token name.length: 0…100
`max_nodes`	integer	no	Maximum number of nodes; defaults to 1.default: 1 · range: 1…10
`expires_days`	integer	no	Validity in days; defaults to 30.default: 30 · range: 1…365

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/nodes/tokens' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

DELETE /api/nodes/tokens/{id}

#Revoke a BYOC token

Authentication: Personal Bearer token
Roles: owner, admin
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Token identifier.

Example

curl --request DELETE \
  --url 'https://api.cdn.pizza/api/nodes/tokens/TOKEN_ID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Private networks 5

GET /api/networks

#List private networks

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/networks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/networks

#Create a private network

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`name`	string	yes	Network name.length: 0…120
`private_cidr`	string	yes	Private IPv4 range.length: 0…32
`description`	string	no	Operational description.length: 0…1000
`routes`	array<string>	no	Advertised private routes.items: 0…50
`vpn_type`	string	no	wireguard.enum: wireguard

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/networks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"name":"backoffice","private_cidr":"10.42.0.0/24"}'

GET /api/networks/{network}

#Read a private network

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`network`	integer	yes	Network identifier.

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/networks/NETWORK_ID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/networks/{network}/enrollment-keys

#Create a network enrollment key

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`network`	integer	yes	Network identifier.
`name`	string	yes	Key name.length: 0…120
`max_uses`	integer	no	Maximum number of uses.default: 1 · range: 1…10
`expires_in_hours`	integer	no	Validity duration.default: 24 · range: 1…168

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/networks/NETWORK_ID/enrollment-keys' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"name":"first-device"}'

POST /api/networks/enroll

#Enroll a WireGuard peer

Authentication: Enrollment key in request body
Roles: None
Success: 201

Request fields

Field	Type	Required	Description
`enrollment_token`	string	yes	Short-lived cpn_… network key.length: 0…128
`name`	string	yes	Peer name.length: 0…120
`peer_type`	string	no	connector, admin_device, or origin.enum: connector \| admin_device \| origin
`public_key`	string	yes	WireGuard public key.length: 0…120
`endpoint`	string	no	Peer public endpoint.length: 0…255

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/networks/enroll' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"enrollment_token":"ENROLLMENT_TOKEN","name":"origin-geneva","public_key":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="}'

Status agents 5

POST /api/status-agents/enrollment-keys

#Create an agent enrollment key

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`status_page_id`	integer	yes	Target status page.
`name`	string	yes	Key or agent name.length: 0…120
`max_uses`	integer	no	Maximum number of uses.default: 1 · range: 1…10
`expires_in_hours`	integer	no	Validity duration.default: 24 · range: 1…168

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/status-agents/enrollment-keys' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"status_page_id":1,"name":"branch-geneva"}'

POST /api/status-agents/enroll

#Enroll a status agent

Authentication: Enrollment key in request body
Roles: None
Success: 201

Request fields

Field	Type	Required	Description
`enrollment_token`	string	yes	Short-lived cps_… key.length: 0…128
`name`	string	yes	Agent name.length: 0…120
`hostname`	string	no	Machine hostname.length: 0…255
`version`	string	no	Agent version.length: 0…80
`capabilities`	array<string>	no	Supported check types.items: 0…20

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/status-agents/enroll' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"enrollment_token":"STATUS_ENROLLMENT_TOKEN","name":"branch-geneva"}'

GET /api/status-agents/config

#Read agent configuration

Authentication: Agent Bearer token
Roles: None
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/status-agents/config' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer STATUS_AGENT_TOKEN'

POST /api/status-agents/heartbeat

#Send an agent heartbeat

Authentication: Agent Bearer token
Roles: None
Success: 200

Request fields

Field	Type	Required	Description
`hostname`	string	no	Current hostname.length: 0…255
`version`	string	no	Current version.length: 0…80
`capabilities`	array<string>	no	Supported capabilities, up to twenty.items: 0…20
`metrics`	object	no	Safe local metrics such as load and used memory.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/status-agents/heartbeat' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer STATUS_AGENT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

POST /api/status-agents/results

#Submit check results

Authentication: Agent Bearer token
Roles: None
Success: 200

Request fields

Field	Type	Required	Description
`results`	array<object>	yes	One to one hundred results with monitor_id and healthy; configuration_version, latency_ms, checked_at, details, and error_message are optional.items: 1…100

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/status-agents/results' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer STATUS_AGENT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"results":[{"monitor_id":17,"configuration_version":2,"healthy":true,"latency_ms":42.5}]}'

Partner POPs 3

GET /api/partner-pops

#List partner POPs

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/partner-pops' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/partner-pops

#Create a partner POP

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`company_name`	string	yes	Operator legal or trading name.length: 0…160
`display_name`	string	yes	Proposed public POP name.length: 0…180
`contact_email`	string	yes	Partner operational email.format: email · length: 0…180
`website_url`	string	no	Operator public website.format: uri · length: 0…255
`logo_url`	string	no	HTTPS URL of the public logo.format: uri · length: 0…2048
`provider_name`	string	no	Infrastructure provider name.length: 0…160
`city`	string	yes	POP city.length: 0…120
`country`	string	yes	Two-letter ISO country code.length: 2…2
`submitted_ipv4`	string	no	Proposed IPv4 address.format: ipv4
`submitted_ipv6`	string	no	Proposed IPv6 address.format: ipv6
`capacity_mbps`	integer	yes	Network capacity in Mbit/s.range: 100…1000000
`notes`	string	no	Technical or operational notes.length: 0…5000
`requirements_accepted`	boolean	yes	Confirms acceptance of the Partner POP requirements.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/partner-pops' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"company_name":"Example Networks AG","display_name":"Zurich IX","contact_email":"noc@example.net","city":"Zürich","country":"CH","capacity_mbps":10000,"requirements_accepted":true}'

POST /api/partner-pops/{partnerPop}/enrollment-token

#Create a POP installation token

The POP must belong to the organization. The application creator may also create the token.

Authentication: Personal Bearer token
Roles: owner, admin, member
Success: 201

Request fields

Field	Type	Required	Description
`partnerPop`	integer	yes	POP identifier.
`name`	string	no	Installation token name.length: 0…120

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/partner-pops/PARTNER_POP_ID/enrollment-token' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

Privacy 4

GET /api/gdpr/export

#Export account data

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/gdpr/export' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

DELETE /api/gdpr/account

#Delete the account

Authentication: Personal Bearer token
Roles: owner, admin
Success: 200

Request fields

Field	Type	Required	Description
`password`	string	yes	Current password, required for confirmation.format: password

Example

curl --request DELETE \
  --url 'https://api.cdn.pizza/api/gdpr/account' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"password":"ACCOUNT_PASSWORD"}'

GET /api/gdpr/consent

#Read consent settings

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/gdpr/consent' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

PUT /api/gdpr/consent

#Update consent settings

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`analytics`	boolean	no	Allow non-essential analytics.
`marketing`	boolean	no	Allow marketing communications.

Example

curl --request PUT \
  --url 'https://api.cdn.pizza/api/gdpr/consent' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

Billing 3

GET /api/billing/plans

#List plans

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/billing/plans' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

GET /api/billing

#Read the current subscription

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/billing' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/billing/checkout

#Create a checkout session

Authentication: Personal Bearer token
Roles: owner, admin
Success: 200

Request fields

Field	Type	Required	Description
`plan`	string	yes	Public plan code.enum: starter \| pro \| enterprise

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/billing/checkout' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"plan":"pro"}'

Webhooks 3

GET /api/webhooks

#List webhooks

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Example

curl --request GET \
  --url 'https://api.cdn.pizza/api/webhooks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

POST /api/webhooks

#Create a webhook

Authentication: Personal Bearer token
Roles: owner, admin
Success: 201

Request fields

Field	Type	Required	Description
`url`	string	yes	Public HTTP(S) receiver URL; HTTPS is recommended.format: uri · length: 0…500
`events`	array<string>	yes	Subscribed events.items: file.uploaded \| file.deleted \| domain.created \| zone.created \| zone.updated \| zone.deleted \| cache.purged \| node.online \| node.offline \| node.deployed \| billing.updated \| invoice.paid \| mail.accepted \| mail.rejected \| mail.deferred
`secret`	string	no	Customer-selected signing secret.length: 0…255

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/webhooks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://hooks.example.com/cdn-pizza","events":["file.uploaded","file.deleted"]}'

DELETE /api/webhooks/{id}

#Delete a webhook

Authentication: Personal Bearer token
Roles: owner, admin
Success: 200

Request fields

Field	Type	Required	Description
`id`	integer	yes	Webhook identifier.

Example

curl --request DELETE \
  --url 'https://api.cdn.pizza/api/webhooks/WEBHOOK_ID' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

GraphQL 1

POST /api/graphql

#Execute a GraphQL query

Authentication: Personal Bearer token
Roles: owner, admin, member, viewer
Success: 200

Request fields

Field	Type	Required	Description
`query`	string	yes	Query document; only four root fields are available.
`variables`	object	no	Query variables.

Example

curl --request POST \
  --url 'https://api.cdn.pizza/api/graphql' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"query":"query { zones { id domain } }"}'

#Overview

#Read a reference operation

#Before automation

#Customer REST operations

Authentication 3

#Create an API session token

Request fields

#Read the current profile

#Revoke the current token

Zones 3

#List zones

#Create, register, or transfer a zone

Request fields

#Read a zone

Request fields

Cache 2

#Purge a path

Request fields

#Purge an entire zone

Request fields

Analytics 1

#Read zone statistics

Request fields

Files 4

#List files

Request fields

#Upload a file

Request fields

#Read a file

Request fields

#Delete a file

Request fields

Nodes 5

#List available nodes

#Create a customer node

Request fields

#List BYOC tokens

#Create a BYOC token

Request fields

#Revoke a BYOC token

Request fields

Private networks 5

#List private networks

#Create a private network

Request fields

#Read a private network

Request fields

#Create a network enrollment key

Request fields

#Enroll a WireGuard peer

Request fields

Status agents 5

#Create an agent enrollment key

Request fields

#Enroll a status agent

Request fields

#Read agent configuration

#Send an agent heartbeat

Request fields

#Submit check results

Request fields

Partner POPs 3

#List partner POPs

#Create a partner POP

Request fields

#Create a POP installation token

Request fields

Privacy 4

#Export account data

#Delete the account

Request fields

#Read consent settings

#Update consent settings

Request fields

Billing 3

#List plans

#Read the current subscription

#Create a checkout session

Request fields

Webhooks 3