## Заменить настройки задачи `PATCH /v1/infra/servers/:id/jobs/:jobId` PATCH полностью заменяет пользовательские настройки, а не объединяет отдельные поля. Cron, timezone и path обязательны; пропущенные label/enabled становятся пустой строкой/true. Перед выключением прочитайте список и передайте прежние значения остальных полей. Только такое выключение без иных изменений разрешено при недоступности функции или допуска. Секрет не меняется. Нужен ключ с `vibe:infra` и существующие права на сервер. Для записи — управляющий ключ или роль команды с правом управления жизненным циклом. [Общие правила](../jobs.md); [проверка подписи](./signature.md). ## Параметры | Параметр | Где | Тип | Обязателен | Описание | |---|---|---|---|---| | `id` | path | string | yes | ID сервера из [списка серверов](../servers.md) | | `jobId` | path | string | yes | ID задачи из [списка](./list.md) | | `cronExpr` | body | string | yes | Пять полей, 9–120 символов; интервал по умолчанию не меньше 5 минут | | `timezone` | body | string | yes | Поддерживаемый IANA-пояс, например Europe/Moscow | | `path` | body | string | yes | Относительный путь с query, 1–512 символов; без URL, traversal, control и сырого # | | `label` | body | string | no | До 80 символов, по умолчанию пустая строка | | `enabled` | body | boolean | no | По умолчанию true | Неизвестные поля отвергаются; lead здесь отсутствует. ALWAYS разрешён, конфликт с бессрочной работой не применяется. Хост галактики не поддерживается; приложение в галактике требует отдельного допуска. ## Примеры ### curl — личный ключ ```bash curl --max-time 20 -X PATCH "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/jobs/JOB_ID" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "cronExpr": "0 9 * * *", "timezone": "Europe/Moscow", "path": "/tasks/digest?mode=daily", "label": "daily digest", "enabled": true }' ``` ### curl — OAuth-приложение ```bash curl --max-time 20 -X PATCH "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" \ -H "Content-Type: application/json" \ -d '{ "cronExpr": "0 9 * * *", "timezone": "Europe/Moscow", "path": "/tasks/digest?mode=daily", "label": "daily digest", "enabled": true }' ``` ### 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: 'PATCH', headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ "cronExpr": "0 9 * * *", "timezone": "Europe/Moscow", "path": "/tasks/digest?mode=daily", "label": "daily digest", "enabled": true }), }); 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: 'PATCH', headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ "cronExpr": "0 9 * * *", "timezone": "Europe/Moscow", "path": "/tasks/digest?mode=daily", "label": "daily digest", "enabled": true }), }); 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, "data": { "id": "job_example", "serverId": "server_example", "label": "daily digest", "cronExpr": "0 9 * * *", "timezone": "Europe/Moscow", "path": "/tasks/digest?mode=daily", "enabled": true, "nextScheduledFor": "2026-10-10T06:00:00.000Z", "scheduleRevision": 1, "availableSince": "2026-10-09T10:00:00.000Z", "createdAt": "2026-10-09T10:00:00.000Z", "updatedAt": "2026-10-09T10:00:00.000Z" } } ``` ## Поля ответа | Поле | Тип | Описание | |---|---|---| | `success` | boolean | Всегда `true` при успехе. | | `data` | object | Обновлённая задача; поля объекта описаны ниже. | Секрет подписи в ответе отсутствует. Поля объекта `data`: | Поле | Тип | Описание | |---|---|---| | `id` | string | Идентификатор задачи | | `serverId` | string | Идентификатор сервера | | `label` | string | Подпись задачи | | `cronExpr` | string | Пять полей cron | | `timezone` | string | Часовой пояс расписания | | `path` | string | Путь и необязательная query-строка | | `enabled` | boolean | Включены ли плановые запуски | | `nextScheduledFor` | string | Следующее плановое вхождение, UTC ISO-8601 | | `scheduleRevision` | integer | Ревизия расписания | | `availableSince` | string | Начало текущего периода расписания, UTC ISO-8601 | | `createdAt` | string | Время создания, UTC ISO-8601 | | `updatedAt` | string | Время последнего изменения, UTC ISO-8601 | ## Ошибки | 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` | Задача отсутствует, удалена или принадлежит другому серверу | | 404 | `FEATURE_DISABLED` | Функция недоступна порталу | | 403 | `WAKE_SCHEDULE_DISABLED` | Порталу недоступны расписания | | 400 | `BLACKHOLE_ONLY` | Нужен сервер Black Hole | | 400 | `GALAXY_NOT_SUPPORTED` | Хост галактики не поддерживается | | 403 | `WAKE_SCHEDULE_GALAXY_DISABLED` | Расписания приложений галактики недоступны | | 400 | `VALIDATION_ERROR` | Неверная форма запроса, путь или часовой пояс | | 400 | `INVALID_CRON` | Cron не разобран или следующее вхождение не вычисляется | | 400 | `CADENCE_TOO_LOW` | Частота превышает разрешённую | | 429 | `RATE_LIMITED` | Слишком много запросов; настройка мутаций 10 в минуту, общие ограничения также действуют | Полный список общих ошибок API — [Ошибки](/docs/errors). ```json { "success": false, "error": { "code": "NOT_FOUND", "message": "Job not found" } } ``` ## Смотрите также - [Список задач](./list.md) - [Запустить вручную](./run.md) - [Удалить задачу](./delete.md)