ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
DNS

Set URL forwarding

PUT
/v1/domains/{id}/forwarding

Redirects the root, and any named subdomains, to a destination URL - a permanent (301) redirect, the only kind the registrar behind hosted DNS does. Replaces only the records this made before: anything you added by hand is untouched. An empty list removes forwarding. Hosted DNS has to be on first.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Request Body

application/json
  1. body
records*array<>

The full new set. An empty list removes forwarding

Itemsitems <= 50

Response Body

A hosted zone's records

application/json
  1. response

A hosted zone's records

records*array<>

Every record in the zone

curl -X PUT "https://example.com/v1/domains/dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/forwarding" \  -H "Content-Type: application/json" \  -d '{    "records": [      {        "target": "https://example.com"      }    ]  }'
{  "records": [    {      "id": "dns_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "name": "www.acme.com",      "type": "A",      "content": "203.0.113.10",      "ttl": 3600,      "priority": null,      "managedBy": null    }  ]}

Delete a record DELETE

Removes one record from the zone. The rest of the zone is sent to the registrar as it now stands, because a zone is replaced whole.

Set email forwarding PUT

Forwards mail for a named address, or the catch-all, to another address. Replaces only the records this made before: anything you added by hand is untouched. An empty list removes forwarding. Hosted DNS has to be on first.