Для AI-агентов: markdown этой страницы — /docs-content/infra/deploy/server-operation.md индекс документации — /llms.txt

Исход операции из ленты сервера

GET /v1/infra/servers/:id/operations/:operationId

Возвращает исход выкладки или команды, на которую ссылается запись ленты событий сервера. Операция ищется по паре «сервер, идентификатор».

Нужна, когда исход читает не тот ключ, которым операция запущена: GET /v1/infra/operations/:operationId отвечает только ключу-создателю, а эта ручка — по правилу доступа ленты событий. Её читает владелец сервера личным ключом или ключом своего OAuth-приложения из того же портала и участник команды разработки, чья роль включает настройки сервера, — своим личным ключом. Ключ OAuth-приложения читает ленту правами своего владельца: пользователь сессии на доступ не влияет, а токен сессии можно не передавать. Ключи, выданные под узкую задачу со своим перечнем маршрутов, — ключ обслуживания агента, ключ внешнего API приложения, ключ участника команды и ключ внешнего участника — исход по этому пути не читают и получают 403 с кодом вида …_KEY_OUT_OF_SCOPE. Ответ содержит только метаданные операции. Приватные поля длительного exec stdout, stderr, duration и truncated отсутствуют даже для создателя; читайте их через разрешённую ручку в области операции. Метаданные такие же, как у GET /v1/infra/operations/:operationId. Ручка только на чтение, побочных действий у неё нет.

Длительный exec доступен только отдельной машине. async=true принимает таймаут от 1 до 86400 секунд на STANDALONE. Другие виды сервера получают 400 DURABLE_EXEC_UNSUPPORTED_SERVER_KIND до блокировки, создания операции и отправки команды, без перехода к синхронному исполнению. Exec Galaxy остаётся синхронным с пределом 600 секунд. Работающая длительная задача отдельной машины занимает канал после 202; опрашивайте эту операцию вместо повторного запуска. Неизвестный исход требует проверки и подтверждения остановки. /unstick и удаление лока не снимают ограничение приёма длительной задачи.

Параметры

Параметр	Тип	Обяз.	Описание
`id` (path)	string	да	ID сервера. Список: `GET /v1/infra/servers`
`operationId` (path)	string	да	Идентификатор операции — поле `ref.id` записи ленты событий, либо идентификатор из ответа `POST /deploy` или `POST /exec`

Примеры

curl — личный ключ

Terminal

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/operations/OPERATION_ID

curl — OAuth-приложение

Terminal

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/operations/OPERATION_ID

JavaScript — личный ключ

javascript

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/operations/${operationId}`,
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)

if (res.status === 410) {
  console.log('Операция была, подробности больше не хранятся')
} else {
  const { data } = await res.json()
  console.log(`Статус: ${data.status}, шаг: ${data.step}, причина: ${data.error?.code ?? '—'}`)
}

JavaScript — OAuth-приложение

javascript

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/operations/${operationId}`,
  {
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { data } = await res.json()

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data.operationId`	string	Идентификатор операции
`data.kind`	string	Вид операции: `deploy` или `exec`
`data.serverId`	string	ID сервера
`data.status`	string	`running`, `succeeded`, `failed` или `unknown`
`data.step`	string \| null	Шаг, на котором операция находится или остановилась. У `kind: "exec"` всегда `null`
`data.exitCode`	number \| null	Только при `kind: "exec"`: код возврата команды, если агент его подтвердил, иначе `null`. У выкладки поля нет
`data.startedAt`	string	Время старта, ISO 8601
`data.finishedAt`	string \| null	Время завершения, ISO 8601. `null`, пока операция идёт
`data.error`	object \| null	`{ code, message }` при `status: "failed"`, иначе `null`. `code` может быть `null`, если платформа не назвала код отказа

Смысл статусов и пары exitCode + status — на странице Исход операции.

Пример ответа

JSON

{
  "success": true,
  "data": {
    "operationId": "cmop1abcdefghijklmnopqrs",
    "kind": "deploy",
    "serverId": "8f14e45f-ceea-467a-9c8d-2f1c5a6b7e30",
    "status": "failed",
    "step": "download",
    "startedAt": "2026-10-06T12:13:17.762Z",
    "finishedAt": "2026-10-06T12:13:28.135Z",
    "error": {
      "code": "DOWNLOAD_HTTP_STATUS",
      "message": "The source returned HTTP 404."
    }
  }
}

Пример ответа при ошибке

404 — сервера нет, он недоступен этому ключу или лента для владельца сервера ещё не включена: