Timeweb Cloud API: Добавить DNS-запись домена

Сценарий из mcp-everything. Актуально на 2026-10-24.

Поддомены для клиентов, подтверждение домена TXT-записью, почтовые MX-записи.

1. Найди домен: GET /api/v1/domains.
2. Посмотри текущие записи: GET /api/v1/domains/{fqdn}/dns-records.
3. Добавь запись: POST /api/v1/domains/{fqdn}/dns-records с type (A, AAAA, CNAME, MX, TXT, SRV), value и при необходимости subdomain, priority и ttl.

curl -X POST "https://api.timeweb.cloud/api/v1/domains/example.ru/dns-records" \
  -H "Authorization: Bearer $TIMEWEB_CLOUD_TOKEN" -H 'Content-Type: application/json' \
  -d '{"type": "TXT", "value": "yandex-verification: 0123456789abcdef"}'

Базовые URL

• Боевой: https://api.timeweb.cloud

Авторизация

Тип: Bearer-токен

JWT-токен создаётся в панели управления в разделе «API и Terraform» и передаётся в каждом запросе:

Authorization: Bearer $TIMEWEB_CLOUD_TOKEN

Методы сценария

GET /api/v1/domains — Список доменов

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	Сколько записей вернуть
offset	query	integer	нет	Смещение
idn_name	query	string	нет	Интернационализированное имя
linked_ip	query	string	нет	Привязанный IP
order	query	string	нет	Порядок
sort	query	string	нет	Сортировка

GET /api/v1/domains/{fqdn}/dns-records — DNS-записи домена

Параметр	Где	Тип	Обяз.	Описание
fqdn	path	string	да	Полное имя домена или поддомена
limit	query	integer	нет	Сколько записей вернуть
offset	query	integer	нет	Смещение

POST /api/v1/domains/{fqdn}/dns-records — Добавление DNS-записи

Параметр	Где	Тип	Обяз.	Описание
fqdn	path	string	да	Полное имя домена
type	body	string	да	TXT, SRV, CNAME, AAAA, MX, A
value	body	string	да	Значение записи
subdomain	body	string	нет	Полное имя поддомена
priority	body	number	нет	Приоритет
ttl	body	number	нет	Время жизни

Нюансы

• Тело POST, PUT, PATCH — application/json.
• Пагинация и поиск в коллекциях: limit, offset, search, sort.
• Ответы на GET содержат объект сущности по ключу, meta.total для коллекций и response_id (UUIDv4, приложите его в обращении в поддержку).
• Созданный ресурс может быть ещё «в состоянии запуска» — проверяйте поле status.
• Около 380 методов; кроме перечисленных — выделенные серверы, диски и бэкапы, образы, Kubernetes, балансировщики, VPC, плавающие IP, приложения, CDN, реестр контейнеров, ограничения доступа к аккаунту.

Другие сценарии

• Создать облачный сервер из скрипта
• Перезагрузить, выключить или изменить сервер
• Создать базу данных и S3-хранилище

---

Если этого недостаточно — официальная документация: https://timeweb.cloud/api-docs Вся интеграция одним документом: https://mcp-everything.ru/integrations/timeweb-cloud.md