DNS Hosting API

The following operations can currently be performed with the API:

  • add, change, and delete domains;
  • add and edit resource records: SRV, MX, CNAME, TXT, A, AAAA, NS, and PTR (when a domain is added, SOA records are created automatically with MINIMUM and EXPIRE values set to 300 and 604800 respectively);
  • tag domains for easier grouping and filtering.

All available methods for working with the DNS hosting API are provided below in the form of the OpenAPI 3.0 specification.


A Keystone token (for the account) or a Selectel token (API key) are used to work with the DNS API.

The token is passed in each request in the header:

  • X-Auth-Token – Keystone token;
  • X-Token – Selectel token.

URL: https://api.selectel.ru/domains/v1/.

The query below will return a list of all added domains:

  • curl -i \
    -H 'X-Auth-Token: <keystone_token>' \
    -H 'Content-Type: application/json' \

    Specify <keystone_token> — a Keystone token.

  • curl -i \
    -H 'X-Token: <selectel_token>' \
    -H 'Content-Type: application/json' \

    Specify <selectel_token> — a Selectel token.