Для AI-агентов: markdown этой страницы — /docs-content/cowork/subscription-resume.md индекс документации — /llms.txt
Отменить запланированное прекращение подписки
POST /v1/cowork/subscription/resume
Снимает запланированную отмену подписки Коворк/Код: место продолжает работать после конца оплаченного срока и продлевается как раньше. Пользователь и портал берутся из привязки ключа, тело запроса не нужно.
Вызов ничего не списывает и не меняет тариф, оплаченный срок, дату следующего списания и квоту. Отмена снимается только у подписки в состоянии ACTIVE: приостановленную или уже завершённую подписку вызов не возобновляет.
Параметры
Параметров пути и запроса нет. Тело можно не передавать. Если тело всё же передано, оно должно быть корректным JSON с заголовком Content-Type: application/json, его содержимое не читается.
Примеры
Эндпоинт требует скоуп vibe:cowork. Этот скоуп платформа выдаёт только ключам Коворк/Код: ключу десктопа и ключу внешнего агента, подключённого к подписке. Добавить его к личному ключу или ключу OAuth-приложения нельзя, такие ключи получают 403 INSUFFICIENT_SCOPE, поэтому примеров два.
curl — ключ Коворк/Код
curl -X POST https://vibecode.bitrix24.tech/v1/cowork/subscription/resume \
-H "X-Api-Key: YOUR_COWORK_KEY"
JavaScript — ключ Коворк/Код
const res = await fetch('https://vibecode.bitrix24.tech/v1/cowork/subscription/resume', {
method: 'POST',
headers: { 'X-Api-Key': 'YOUR_COWORK_KEY' },
})
if (!res.ok) {
const { error } = await res.json()
if (error.code === 'NO_SCHEDULED_CANCELLATION') {
console.log('Отмена не запланирована, подписка продлевается')
} else {
console.error(error.code, error.message)
}
} else {
const { state } = await res.json()
console.log('Отмена снята:', state.subscription.cancelAtPeriodEnd === false)
}
Поля ответа
Успешный ответ — объект с единственным полем state, без обёртки success. Внутри state — состояние подписки той же формы, что и в ответе GET /v1/cowork/state, полное описание полей — там.
| Поле | Тип | Описание |
|---|---|---|
Полеstate |
Типobject | ОписаниеСостояние подписки после снятия отмены |
Полеstate.portal |
Типobject | ОписаниеПортал, к которому привязан ключ: id, domain, isPartner |
Полеstate.subscription |
Типobject | ОписаниеТариф, состояние и даты подписки |
Полеstate.subscription.cancelAtPeriodEnd |
Типboolean | ОписаниеПосле успешного вызова — false |
Полеstate.subscription.nextChargeAt |
Типstring или null | ОписаниеДата следующего списания, ISO 8601. Вызов её не меняет |
Полеstate.subscription.paidThroughAt |
Типstring | ОписаниеДо какой даты оплачено место, ISO 8601. Вызов её не меняет |
Полеstate.windows |
Типobject | ОписаниеТри окна квоты: fiveHour, week, month |
Полеstate.bottleneck |
Типstring | ОписаниеОкно, которое ограничивает расход сильнее остальных |
Полеstate.recommendation |
Типobject | ОписаниеРекомендация подождать сброса окна или перейти на тариф выше |
Полеstate.tiers |
Типarray | ОписаниеКаталог тарифов с ценой feeVibes и признаками current, isNext |
Полеstate.serverTime |
Типstring | ОписаниеВремя сервера в момент ответа, ISO 8601 |
Полеstate.boostPct |
Типnumber | ОписаниеДействующее усиление квоты в процентах |
Полеstate.boostExpiresAt |
Типstring или null | ОписаниеКогда усиление закончится, ISO 8601 |
Пример ответа
Подписка PRO, оплаченная на 12 месяцев, отмена снята:
{
"state": {
"portal": {
"id": "0d9f7744-f853-47c7-b06e-6f61f9dd1b7f",
"domain": "example.bitrix24.ru",
"isPartner": true
},
"subscription": {
"tier": "PRO",
"state": "ACTIVE",
"currentPeriodStart": "2026-10-27T14:58:42.814Z",
"currentPeriodEnd": "2026-11-26T14:58:42.814Z",
"nextChargeAt": "2027-10-22T14:58:42.814Z",
"cancelAtPeriodEnd": false,
"pendingTier": null,
"termMonths": 12,
"paidThroughAt": "2027-10-22T14:58:42.814Z"
},
"windows": {
"fiveHour": { "pctUsed": 0, "resetAt": "2026-11-12T16:46:27.570Z", "exhausted": false },
"week": { "pctUsed": 0, "resetAt": "2026-11-19T11:46:27.570Z", "exhausted": false },
"month": { "pctUsed": 0, "resetAt": "2026-11-26T14:58:42.814Z", "exhausted": false }
},
"bottleneck": "fiveHour",
"recommendation": {
"reason": "none",
"triggerWindow": null,
"wait": null,
"upgrade": { "available": true, "nextTier": "MAX" }
},
"tiers": [
{ "tier": "FREE", "multiplier": null, "feeVibes": 0, "current": false, "isNext": false },
{ "tier": "PRO", "multiplier": "×1", "feeVibes": 2000, "current": true, "isNext": false },
{ "tier": "MAX", "multiplier": "×5", "feeVibes": 10000, "current": false, "isNext": true },
{ "tier": "ULTRA", "multiplier": "×20", "feeVibes": 20000, "current": false, "isNext": false }
],
"serverTime": "2026-11-12T11:46:27.570Z",
"boostPct": 0,
"boostExpiresAt": null
}
}
Пример ответа при ошибке
409 — отмена не запланирована, в том числе при повторном вызове после успешного:
{
"success": false,
"error": {
"code": "NO_SCHEDULED_CANCELLATION",
"message": "No active subscription with a scheduled cancellation."
}
}
Ошибки
| HTTP | Код | Описание |
|---|---|---|
| HTTP400 | КодINVALID_JSON_BODY |
ОписаниеТело передано, но не читается как JSON |
| HTTP401 | КодMISSING_API_KEY |
ОписаниеНе передан заголовок X-Api-Key |
| HTTP401 | КодINVALID_API_KEY |
ОписаниеКлюч не опознан: такой строки на платформе нет |
| HTTP403 | КодINSUFFICIENT_SCOPE |
ОписаниеУ ключа нет скоупа vibe:cowork |
| HTTP404 | КодCOWORK_NOT_ACTIVATED |
ОписаниеПодписка Коворк/Код не найдена для пары пользователь и портал |
| HTTP409 | КодNO_SCHEDULED_CANCELLATION |
ОписаниеОтмена не запланирована, подписка не в состоянии ACTIVE, отмену уже сняли или срок закончился и подписка завершилась |
| HTTP415 | КодFST_ERR_CTP_INVALID_MEDIA_TYPE |
ОписаниеТело передано с типом содержимого, отличным от application/json |
| HTTP429 | КодRATE_LIMITED |
ОписаниеПревышен общий предел частоты запросов ключа. Подождите столько секунд, сколько указано в заголовке Retry-After |
| HTTP503 | КодCOWORK_FEATURE_DISABLED |
ОписаниеКоворк/Код отключён на уровне платформы |
| HTTP503 | Кодuser_self_deletion_pending |
ОписаниеВладелец ключа запланировал отключение от портала. Время отключения — в поле error.selfDeletionPendingAt |
Полный список общих ошибок API — Ошибки.
Известные особенности
Вызывайте метод только после явного подтверждения человеком. Снятие отмены возвращает автопродление, то есть в дату nextChargeAt спишется оплата следующего срока. Открытие ссылки или экрана не должно вызывать этот метод.
Отмену в конце срока завершает платформа, а не клиент. До даты paidThroughAt подписка остаётся в состоянии ACTIVE с cancelAtPeriodEnd: true, и снять отмену можно в любой момент этого срока. После неё подписка переходит в CANCELLED, и метод отвечает 409 NO_SCHEDULED_CANCELLATION — вернуть место можно только новой покупкой тарифа.
Проверить, есть ли что снимать, можно без побочных эффектов. Поле subscription.cancelAtPeriodEnd в GET /v1/cowork/state показывает, запланирована ли отмена. Кнопку «Продолжить подписку» показывают только при true.