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 in seconds (60-86400)
`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`
`SRV`	`priority`: `integer`, `weight`: `integer`, `port`: `integer`, `data`: fqdn
`TLSA`	`usage`: `integer`, `selector`: `integer`, `matching_type`: `integer`, `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
`429`	`Error`	Rate limit for ACME platform credentials (scope `acme-dns-challenge`): calls per minute, and distinct customers per day. Ordinary customer keys never receive this status on this endpoint.
`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.