# 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.

```bash
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, реестр контейнеров, ограничения доступа к аккаунту.

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

- [Создать облачный сервер из скрипта](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/sozdat-oblachnyy-server-iz-skripta.md)
- [Добавить DNS-запись домена](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/dobavit-dns-zapis-domena.md)
- [Создать базу данных и S3-хранилище](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/sozdat-bazu-dannyh-i-s3-hranilische.md)

---

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