DNS

Create a DNS record

Adds a record to the domain's live zone and returns its provider-assigned id. Requires scope dns:write.

post/domains/{domain}/dns/records

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/domains/{domain}/dns/records
  • Auth: HTTP bearer

Path parameters

domainstring required

The domain name, e.g. yourdomain.com

Request body

type'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'SRV' | 'NS' | 'CAA' required
namestring required

Record name — a full hostname, or @ for the domain apex

valuestring required
ttlinteger

Time-to-live in seconds (provider default if omitted)

priorityinteger

Priority for MX/SRV records

Example request

{
  "type": "A",
  "name": "app.yourdomain.com",
  "value": "203.0.113.10",
  "ttl": 3600,
  "priority": 10
}

Response

Record created

successboolean

Example response

{
  "success": true,
  "data": {
    "id": "4f3a2b1c"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.