Новый запуск
http
POST /api/v1/sessions/{sid}/runsСоздать следующий запуск. Сессии с allow_multiple_runs=false отклоняют операцию с 409 multiple_runs_not_allowed. Окружения в состоянии deleting, deleted или unavailable отклоняют новый запрос с 409 session_unavailable. Создайте новую сессию с нужным контекстом. Если внешняя потеря песочницы обнаружена после принятия запроса, запуск асинхронно завершается с sandbox_lost. Идемпотентный повтор принятого запроса возвращает исходное подтверждение независимо от состояния песочницы.
operationId: create_run
Авторизация
HTTPBearer
Условия браузерного доступа: авторизация. Изменяющие данные запросы к сессиям требуют Bearer-ключ.
Параметры
| Имя | Где | Обязательный | Тип | Описание и ограничения |
|---|---|---|---|---|
sid | path | Да | string | format: "uuid" |
Idempotency-Key | header | Нет | string / null |
Тело запроса
application/json: CreateRun
json
{
"$ref": "#/components/schemas/CreateRun"
}Ответы
| Код | Описание | Содержимое |
|---|---|---|
| 202 | Успешный ответ | application/json: Accepted |
| 400 | Некорректный запрос | application/json: ErrorResponse |
| 401 | Требуется авторизация | application/json: ErrorResponse |
| 403 | Браузерная сессия предоставляет только чтение (read_only_access). | application/json: ErrorResponse |
| 404 | Ресурс не найден | application/json: ErrorResponse |
| 409 | Конфликт | application/json: ErrorResponse |
| 413 | Превышен размер содержимого | application/json: ErrorResponse |
| 415 | Неподдерживаемый тип содержимого | application/json: ErrorResponse |
| 422 | Некорректные данные | application/json: ErrorResponse |
| 503 | Сервис недоступен | application/json: ErrorResponse |
Заголовки ответа 202
Location: Адрес принятого запуска. string