logo
OpenapiDns

Create DNS record

API Docs with browser client
POST
/dns/records

Create a new DNS record for a domain. Requires domain ownership. The record will be validated against DNS zone rules before creation.

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/json

type*unknown
Value in"A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "SOA" | "PTR" | "SRV" | "CAA" | "DS" | "TLSA" | "SSHFP" | "HTTPS" | "SVCB" | "NAPTR" | "SPF"
name?string
rdata*string
ttl?integer
Range-2147483648 <= value <= 2147483647
zoneName*string
Match^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "http://backend.astra.namefi.dev/v-next/dns/records" \  -H "Content-Type: application/json" \  -d '{    "type": "A",    "rdata": "string",    "zoneName": "string"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "zoneName": "string",
  "name": "string",
  "type": "A",
  "class": "string",
  "ttl": -2147483648,
  "rdata": "string",
  "metadata": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}
{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Bad Request",
  "data": null
}
{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Unauthorized",
  "data": null
}
{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Forbidden",
  "data": null
}
{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Not Found",
  "data": null
}
{
  "defined": true,
  "code": "NOT_ACCEPTABLE",
  "status": 406,
  "message": "Not Acceptable",
  "data": null
}
{
  "defined": true,
  "code": "TIMEOUT",
  "status": 408,
  "message": "Request Timeout",
  "data": null
}
{
  "defined": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "Conflict",
  "data": null
}
{
  "defined": true,
  "code": "PRECONDITION_FAILED",
  "status": 412,
  "message": "Precondition Failed",
  "data": null
}
{
  "defined": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "Too Many Requests",
  "data": null
}
{
  "defined": true,
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal Server Error",
  "data": null
}

Batch update DNS records PUT

Update multiple DNS records in a single transaction. Requires domain ownership. All records must belong to the same zone and will be validated together.

Delete DNS record DELETE

Delete a DNS record by its ID. Requires domain ownership. The deletion will be validated to ensure zone integrity.