# Timeweb Cloud API: POST /api/v1/servers — Создание сервера

Нужен `preset_id` или `configuration` (одно из двух). Ответ `201` с объектом `server`; сервер может ещё запускаться — смотрите `status`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `name` | body | string | да | Имя сервера, до 255 символов |
| `preset_id` | body | number | нет | ID тарифа (нельзя вместе с configuration) |
| `configuration.configurator_id` | body | number | нет | ID конфигуратора (обязателен внутри configuration) |
| `configuration.disk` | body | number | нет | Диск, МБ |
| `configuration.cpu` | body | number | нет | Число ядер |
| `configuration.ram` | body | number | нет | ОЗУ, МБ |
| `configuration.gpu` | body | number | нет | Число видеокарт |
| `os_id` | body | number | нет | ID ОС (нельзя вместе с image_id) |
| `image_id` | body | string | нет | ID образа |
| `software_id` | body | number | нет | ID ПО из маркетплейса |
| `bandwidth` | body | number | нет | Пропускная способность: 100–1000 с шагом 100 |
| `is_ddos_guard` | body | boolean | нет | Защищённый IP (L3/L4) |
| `ssh_keys_ids` | body | array | нет | SSH-ключи |
| `is_local_network` | body | boolean | нет | Локальная сеть |
| `network.id` | body | string | нет | ID приватной сети |
| `network.floating_ip` | body | string | нет | Публичный IP |
| `network.local_ip` | body | string | нет | Приватный IP |
| `cloud_init` | body | string | нет | Cloud-init скрипт |
| `availability_zone` | body | string | нет | spb-1…spb-4, msk-1, nsk-1, ams-1, ala-1, fra-1 |
| `project_id` | body | number | нет | ID проекта |
| `hostname` | body | string | нет | Сетевое имя |
| `comment` | body | string | нет | Комментарий, до 255 символов |

## Базовые URL

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

## Авторизация

Тип: Bearer-токен

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

```
Authorization: Bearer $TIMEWEB_CLOUD_TOKEN
```

## Нюансы

- Тело `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)

---

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