К содержимому

Новый запуск ​

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-ключ.

Параметры ​

ИмяГдеОбязательныйТипОписание и ограничения
sidpathДаstringformat: "uuid"
Idempotency-KeyheaderНет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

HTTP API