Timeweb Cloud API: Перезагрузить, выключить или изменить сервер

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

Управление серверами из своей панели или по расписанию.

1. Выполни действие: POST /api/v1/servers/{server_id}/action с action — например, reboot, hard_reboot, hard_shutdown. Успех — 204.
2. Чтобы сменить тариф или ресурсы, вызови PATCH /api/v1/servers/{server_id} с preset_id или configurator (cpu, ram, disk). Тем же методом меняются имя и комментарий.
3. Список серверов — GET /api/v1/servers с limit и offset; общее число — в meta.total.
4. Удаление — DELETE /api/v1/servers/{server_id}. Если в аккаунте включено подтверждение удаления, первый вызов вернёт server_delete.hash, а код придёт в Telegram — повтори запрос с hash и code.

curl -X POST "https://api.timeweb.cloud/api/v1/servers/<server_id>/action" \
  -H "Authorization: Bearer $TIMEWEB_CLOUD_TOKEN" -H 'Content-Type: application/json' \
  -d '{"action": "reboot"}'

Базовые URL

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

Авторизация

Тип: Bearer-токен

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

Authorization: Bearer $TIMEWEB_CLOUD_TOKEN

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

GET /api/v1/servers — Список серверов

В ответе servers и meta.total.

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

PATCH /api/v1/servers/{server_id} — Изменение сервера

Параметр	Где	Тип	Обяз.	Описание
server_id	path	integer	да	ID сервера
preset_id	body	number	нет	Новый тариф (нельзя вместе с configurator)
configurator.cpu	body	number	нет	Число ядер
configurator.ram	body	number	нет	ОЗУ, МБ
configurator.disk	body	number	нет	Диск, МБ
os_id	body	number	нет	Переустановить ОС
image_id	body	string	нет	Установить образ
name	body	string	нет	Имя
comment	body	string	нет	Комментарий
bandwidth	body	number	нет	Пропускная способность
cloud_init	body	string	нет	Cloud-init скрипт

DELETE /api/v1/servers/{server_id} — Удаление сервера

Если включено подтверждение удаления, первый вызов вернёт server_delete.hash, а код придёт в Telegram; повторите запрос с hash и code.

Параметр	Где	Тип	Обяз.	Описание
server_id	path	integer	да	ID сервера
hash	query	string	нет	Хеш из первого ответа
code	query	string	нет	Код подтверждения

POST /api/v1/servers/{server_id}/action — Действие над сервером

Успех — 204. Есть и отдельные методы /start, /shutdown, /reboot, /hard-reboot, /clone, /reset-password.

Параметр	Где	Тип	Обяз.	Описание
server_id	path	integer	да	ID сервера
action	body	string	да	hard_reboot, hard_shutdown, install, reboot, remove, reset_password, shutdown, start, clone

Нюансы

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

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

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

---

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