## Удалить задачу

`DELETE /v1/infra/servers/:id/jobs/:jobId`

Логически удаляет задачу и останавливает новые запуски. Доступно и при недоступности функции. Уже отправленная попытка RUNNING завершается; запрос не отзывается. Задача исчезает из списка, адресные операции и журнал затем возвращают 404.

Нужен ключ с `vibe:infra` и существующие права на сервер. Для записи — управляющий ключ или роль команды с правом управления жизненным циклом. [Общие правила](../jobs.md); [проверка подписи](./signature.md).

## Параметры

| Параметр | Где | Тип | Обязателен | Описание |
|---|---|---|---|---|
| `id` | path | string | yes | ID сервера из [списка серверов](../servers.md) |
| `jobId` | path | string | yes | ID задачи из [списка](./list.md) |

Тело запроса и query-параметры не нужны. Для POST без тела не передавайте Content-Type: application/json; пустое JSON-тело отвергается до обработчика.

## Примеры

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

```bash
curl --max-time 20 -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/jobs/JOB_ID" \
  -H "X-Api-Key: YOUR_API_KEY"
```

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

```bash
curl --max-time 20 -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/jobs/JOB_ID" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"
```

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

```javascript
const serverId = 'SERVER_ID';
const jobId = 'JOB_ID';
const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/${encodeURIComponent(serverId)}/jobs/${encodeURIComponent(jobId)}`, {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);
```

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

```javascript
const serverId = 'SERVER_ID';
const jobId = 'JOB_ID';
const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/${encodeURIComponent(serverId)}/jobs/${encodeURIComponent(jobId)}`, {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);
```

## Ответ

HTTP 200. Пример формы ответа с вымышленными идентификаторами, не результат живого запроса.

```json
{
  "success": true
}
```


## Поля ответа

| Поле | Тип | Описание |
|---|---|---|
| `success` | boolean | Всегда `true` при успехе. |

В ответе нет поля `data` и секрета подписи.

## Ошибки

| HTTP | Код | Причина |
|---|---|---|
| 401 | `MISSING_API_KEY` | Не передан ключ |
| 403 | `INFRA_FORBIDDEN_FOR_COWORK_KEY` | Ключ Коворка не допускает запись в инфраструктуру; используйте [ключ для развёртывания](../../cowork/deploy-key.md) |
| 403 | `INFRA_SCOPE_REQUIRED` | Нужен scope `vibe:infra` |
| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ только для чтения не допускает запись |
| 403 | `SERVER_ROLE_FORBIDDEN` | Роль участника команды не допускает это действие |
| 404 | `NOT_FOUND` | Сервер не найден или недоступен вызывающему |
| 404 | `NOT_FOUND` | Задача отсутствует, удалена или принадлежит другому серверу |
| 429 | `RATE_LIMITED` | Слишком много запросов; настройка мутаций 10 в минуту, общие ограничения также действуют |

Полный список общих ошибок API — [Ошибки](/docs/errors).

```json
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Job not found"
  }
}
```

## Смотрите также

- [Список задач](./list.md)
- [Создать задачу](./create.md)