API v1Создать именованный комплект

Создать именованный комплект

Обновлено 8 октября 2026

POST/bundles

Создаёт проект для объединения проверок. Сохраните bundle_id. Передавайте его при загрузках через POST /runs. Создание проекта не запускает проверку.

Передайте ключ организации в заголовке Authorization: Bearer <ключ>.

Пример запроса

Используйте NK_BASE и NK_KEY из быстрого старта. Переменные в пути, например RUN_ID, замените значениями из ваших ответов API.

POST /bundles

curl --fail-with-body -X POST "$NK_BASE/bundles" \
  -H "Authorization: Bearer $NK_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Сохраните тело запроса в request.json. Его поля описаны ниже.

Тело запроса

application/json

labelстрока · обязательное: Название комплекта. До 200 символов. От 1 символов.
versionцелое число · необязательное: Для переименования: текущая версия из GET /bundles. По умолчанию: 1.

Ответы и ошибки

`201`

Успешный ответ.

application/json

Поля ответа

bundle_idстрока · обязательное: Идентификатор комплекта.
labelстрока · обязательное: Название, до 200 символов.
versionцелое число · обязательное: Текущая версия названия.
created_atстрока · необязательное: Время создания.
tenant_idстрока · необязательное: Организация.

`401`

Ключ не передан, неверен или отозван.

application/json

Поля ответа

detailобъект / массив: объект / строка · обязательное

Обычно объект с error. При ошибке проверки параметров возможен список нарушений.

Вложенные поля

errorстрока · обязательное: Машинный код ошибки. Используйте его в обработчике.
messageстрока · необязательное: Пояснение для человека. Текст может меняться.
fileстрока · необязательное: Проблемный файл, если ошибка относится к нему.

Массив элементов:

locмассив: строка / целое число · необязательное: Путь до неверного поля.
msgстрока · необязательное: Причина нарушения.
typeстрока · необязательное: Код нарушения.
inputобъект · необязательное: Переданное значение.

Текст ошибки, если сервер не вернул объект.

`403`

Доступ закрыт или действие не разрешено.

application/json

Поля ответа

detailобъект / массив: объект / строка · обязательное

Обычно объект с error. При ошибке проверки параметров возможен список нарушений.

Вложенные поля

errorстрока · обязательное: Машинный код ошибки. Используйте его в обработчике.
messageстрока · необязательное: Пояснение для человека. Текст может меняться.
fileстрока · необязательное: Проблемный файл, если ошибка относится к нему.

Массив элементов:

locмассив: строка / целое число · необязательное: Путь до неверного поля.
msgстрока · необязательное: Причина нарушения.
typeстрока · необязательное: Код нарушения.
inputобъект · необязательное: Переданное значение.

Текст ошибки, если сервер не вернул объект.

`422`

Ошибка валидации: detail содержит объект с кодом либо список нарушений.

application/json

Поля ответа

detailобъект / массив: объект / строка · обязательное

Обычно объект с error. При ошибке проверки параметров возможен список нарушений.

Вложенные поля

errorстрока · обязательное: Машинный код ошибки. Используйте его в обработчике.
messageстрока · необязательное: Пояснение для человека. Текст может меняться.
fileстрока · необязательное: Проблемный файл, если ошибка относится к нему.

Массив элементов:

locмассив: строка / целое число · необязательное: Путь до неверного поля.
msgстрока · необязательное: Причина нарушения.
typeстрока · необязательное: Код нарушения.
inputобъект · необязательное: Переданное значение.

Текст ошибки, если сервер не вернул объект.

`Другой ответ`

Ошибка входного сервера или сети может иметь текстовое/HTML-тело. Проверяйте HTTP-статус и Content-Type.