curl -X PUT "https://your-paneldns-domain.com/api/v1/zones/501/records/1001" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "mail2.widgets.co.",
"priority": 20
}'
{
"ok": true,
"data": {
"id": 1001,
"zone_id": 501,
"remote_id": "abcd1234",
"name": "@",
"type": "MX",
"content": "mail2.widgets.co.",
"ttl": 3600,
"priority": 20,
"is_protected": false,
"created_at": "2026-03-01T09:10:00.000000Z",
"updated_at": "2026-06-05T10:05:00.000000Z"
}
}
{
"ok": false,
"error": "Not found.",
"code": 404
}
Records
Update Record
Replace a DNS record’s content. Requires records:write scope.
PUT
/
api
/
v1
/
zones
/
{id}
/
records
/
{rid}
curl -X PUT "https://your-paneldns-domain.com/api/v1/zones/501/records/1001" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "mail2.widgets.co.",
"priority": 20
}'
{
"ok": true,
"data": {
"id": 1001,
"zone_id": 501,
"remote_id": "abcd1234",
"name": "@",
"type": "MX",
"content": "mail2.widgets.co.",
"ttl": 3600,
"priority": 20,
"is_protected": false,
"created_at": "2026-03-01T09:10:00.000000Z",
"updated_at": "2026-06-05T10:05:00.000000Z"
}
}
{
"ok": false,
"error": "Not found.",
"code": 404
}
Both
PUT and PATCH are accepted and behave identically — they replace the supplied fields on the record. Omitted fields retain their current values.
integer
required
Zone ID.
integer
required
Record ID.
string
New record name. Max 253 characters.
string
New record type. One of the supported types.
string
New record value. See Create Record for format by type.
integer
New TTL in seconds. Minimum
60, maximum 86400.integer
New priority. Only applies to
MX and SRV records.All fields are optional on both
PUT and PATCH — omitted fields retain their current values.curl -X PUT "https://your-paneldns-domain.com/api/v1/zones/501/records/1001" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "mail2.widgets.co.",
"priority": 20
}'
{
"ok": true,
"data": {
"id": 1001,
"zone_id": 501,
"remote_id": "abcd1234",
"name": "@",
"type": "MX",
"content": "mail2.widgets.co.",
"ttl": 3600,
"priority": 20,
"is_protected": false,
"created_at": "2026-03-01T09:10:00.000000Z",
"updated_at": "2026-06-05T10:05:00.000000Z"
}
}
{
"ok": false,
"error": "Not found.",
"code": 404
}