Для 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 — ключ Коворк/Код

Terminal
curl -X POST https://vibecode.bitrix24.tech/v1/cowork/subscription/resume \
  -H "X-Api-Key: YOUR_COWORK_KEY"

JavaScript — ключ Коворк/Код

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 месяцев, отмена снята:

JSON
{
  "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 — отмена не запланирована, в том числе при повторном вызове после успешного:

JSON
{
  "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.

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