DNS automation
v1.6.2
Update DNS record
Update a DNS record and automatically detect the record based on the
name and type specified in the parameters. If you want to update the name or type attribute, please refer to the PATCH /dns/rr/{rrid} endpoint.PATCH
/dns/rr
ResourceRecords
Authentication
Request body
Data object for the record
recordRequestFQDNrecordRequestFQDN
{
"type": "A",
"name": "www.example.com.",
"data": "12.12.12.12"
}Fields
Name
Type
Format
Required
Description
type
string
-
Required
-
name
string
-
Required
Fully Qualified Domain Name (FQDN, ending with a period).
ttl
integer
-
Optional
Time To Live in seconds (60-86400)
annotation
string
-
Optional
A custom note for this particular record.
data
string
-
Required
-
Request example
PATCH
curl --request PATCH \
--url 'https://api.regfish.com/dns/rr' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'content-type: application/json' \
--data '{
"type": "A",
"name": "www.example.com.",
"data": "12.12.12.12"
}'Responses
200
The record corresponding to the provided `name`/`type` combination
Response example 200
{
"success": true,
"code": 0,
"response": {
"type": "A",
"name": "www.example.com.",
"data": "12.12.12.12",
"id": 1,
"auto": true,
"active": true,
"ts_created": 1,
"ts_updated": 1
}
}400
Invalid request
Response example 400
{
"success": false,
"message": "Invalid request",
"error": "Invalid request"
}401
Unauthorized
Response example 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}404
No record found for the provided `name`/`type` combination
Response example 404
{
"success": false,
"message": "No record found for the provided `name`/`type` combination",
"error": "No record found for the provided `name`/`type` combination"
}417
DNS record update violates a zone constraint
Response example 417
{
"success": false,
"message": "DNS record update violates a zone constraint",
"error": "DNS record update violates a zone constraint"
}500
Unexpected error
Response example 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}Community
Forma parte de la comunidad
La DNS API de regfish es una gran solución para desarrolladores que quieren automatizar dominios y zonas DNS. Súmese a la comunidad y aproveche las ventajas de la automatización DNS. La DNS API está disponible gratis para todos los clientes de regfish.