Skip to content

Create an A record

POST
/api/v2/organizations/{organization}/dns/zones/{zoneId}/records
curl --request POST \
--url https://dashboard.quantcdn.io/api/v2/organizations/example/dns/zones/example/records \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "dragon-den", "type": "A", "value": "203.0.113.10", "ttl": 300 }'

Dns:write and add_domains are required. Existing names are rejected; this endpoint does not update records. Only organization-wide tokens are accepted.

organization
required
string
zoneId
required
string
Media typeapplication/json
object
name
required

Name relative to the zone; @ denotes the apex

string
Example
dragon-den
type
required
string
Allowed values: A
value
required
string format: ipv4
Example
203.0.113.10
ttl
integer
default: 300 >= 1 <= 86400

Success

Missing or invalid API token

Token scope, organization or role permission denied

Zone not found in this organization

A record already exists for this name

Invalid request

DNS service unavailable