Update DNS record

PATCH /dns/rr/{rrid}

Operation ID: PatchRecordByRRID

Update a specific Resource Record (rrid). This is useful for modifying the record’s name or type, or when managing multiple records with the same name and type combination.

Path parameters

Name	Type	Required	Description
`rrid`	rrid	yes	—

Request body

recordRequest

Field	Type	Required	Description
`type`	type	no	—
`name`	fqdn_or_subdomain	no	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`	ttl	no	Time To Live (60-604800)
`annotation`	`string`	no	A custom note for this particular record.

Plus the fields of one of these variants:

Variant	Fields
`A`	`data`: ipv4
`AAAA`	`data`: ipv6
`CNAME`	`data`: fqdn
`CAA`	`flags`: `integer`, `tag`: `string`, `data`: `string`
`ALIAS`	`data`: fqdn
`MX`	`data`: fqdn, `priority`: `integer`
`TXT`	`data`: `string`

Responses

Status	Type	Description
`200`	`recordResponse`	The updated record
`400`	`Error`	Invalid request
`401`	`Error`	Unauthorized
`404`	`Error`	DNS record not found
`417`	`Error`	DNS record update violates a zone constraint
`500`	`Error`	Unexpected error

Response body

Field	Type	Required	Description
`success`	`boolean`	yes	Success indicator
`code`	`integer`	no	Response/Error Code
`response`	recordResponse	no	—

Example

curl -X PATCH "https://api.regfish.com/dns/rr/<rrid>" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "www",
    "ttl": 600,
    "annotation": "string",
    "data": "12.12.12.12"
  }'

Build a request

Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.