© 2002-2026 regfish GmbH. Regfish is a registered trademark of regfish GmbH. All prices include VAT. No guarantee for completeness. Our Terms and Conditions.
PATCH
/dns/rr/{rrid}
ResourceRecordsByID
Authentication
Parameters
Name
Type
Format
Required
Description
rrid
number
—
Required
Resource Record ID
Request body
Data object for the record
recordRequestrecordRequest
{
"type": "A",
"name": "www",
"data": "12.12.12.12"
}Fields
Name
Type
Format
Required
Description
type
string
—
Required
—
name
string
—
Required
Fully Qualified Domain Name (FQDN) or subdomain. You can use the `@` symbol to represent your apex domain (e.g., example.com). Wildcards are supported.
ttl
integer
—
Optional
Time To Live (60-604800)
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/1' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'content-type: application/json' \
--data '{
"type": "A",
"name": "www",
"data": "12.12.12.12"
}'Responses
200
The updated record
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
DNS record not found
Response example 404
{
"success": false,
"message": "DNS record not found",
"error": "DNS record not found"
}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"
}