
## Отменить запланированное прекращение подписки

`POST /v1/cowork/subscription/resume`

Снимает запланированную отмену подписки Коворк/Код: место продолжает работать после конца оплаченного срока и продлевается как раньше. Пользователь и портал берутся из привязки ключа, тело запроса не нужно.

Вызов ничего не списывает и не меняет тариф, оплаченный срок, дату следующего списания и квоту. Отмена снимается только у подписки в состоянии `ACTIVE`: приостановленную или уже завершённую подписку вызов не возобновляет.

## Параметры

Параметров пути и запроса нет. Тело можно не передавать. Если тело всё же передано, оно должно быть корректным JSON с заголовком `Content-Type: application/json`, его содержимое не читается.

## Примеры

Эндпоинт требует скоуп `vibe:cowork`. Этот скоуп платформа выдаёт только ключам Коворк/Код: ключу десктопа и ключу внешнего агента, подключённого к подписке. Добавить его к личному ключу или ключу OAuth-приложения нельзя, такие ключи получают `403 INSUFFICIENT_SCOPE`, поэтому примеров два.

### curl — ключ Коворк/Код

```bash
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`](/docs/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 | Код | Описание |
|------|-----|----------|
| 400 | `INVALID_JSON_BODY` | Тело передано, но не читается как JSON |
| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |
| 401 | `INVALID_API_KEY` | Ключ не опознан: такой строки на платформе нет |
| 403 | `INSUFFICIENT_SCOPE` | У ключа нет скоупа `vibe:cowork` |
| 404 | `COWORK_NOT_ACTIVATED` | Подписка Коворк/Код не найдена для пары пользователь и портал |
| 409 | `NO_SCHEDULED_CANCELLATION` | Отмена не запланирована, подписка не в состоянии `ACTIVE`, отмену уже сняли или срок закончился и подписка завершилась |
| 415 | `FST_ERR_CTP_INVALID_MEDIA_TYPE` | Тело передано с типом содержимого, отличным от `application/json` |
| 429 | `RATE_LIMITED` | Превышен общий предел частоты запросов ключа. Подождите столько секунд, сколько указано в заголовке `Retry-After` |
| 503 | `COWORK_FEATURE_DISABLED` | Коворк/Код отключён на уровне платформы |
| 503 | `user_self_deletion_pending` | Владелец ключа запланировал отключение от портала. Время отключения — в поле `error.selfDeletionPendingAt` |

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

## Известные особенности

**Вызывайте метод только после явного подтверждения человеком.** Снятие отмены возвращает автопродление, то есть в дату `nextChargeAt` спишется оплата следующего срока. Открытие ссылки или экрана не должно вызывать этот метод.

**Отмену в конце срока завершает платформа, а не клиент.** До даты `paidThroughAt` подписка остаётся в состоянии `ACTIVE` с `cancelAtPeriodEnd: true`, и снять отмену можно в любой момент этого срока. После неё подписка переходит в `CANCELLED`, и метод отвечает `409 NO_SCHEDULED_CANCELLATION` — вернуть место можно только новой покупкой тарифа.

**Проверить, есть ли что снимать, можно без побочных эффектов.** Поле `subscription.cancelAtPeriodEnd` в [`GET /v1/cowork/state`](/docs/cowork/state) показывает, запланирована ли отмена. Кнопку «Продолжить подписку» показывают только при `true`.

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

- [Состояние подписки Коворк/Код](/docs/cowork/state)
- [Сводка по подписке Коворк/Код](/docs/cowork/me)
- [Предрасчёт смены тарифа](/docs/cowork/subscription-preview)
- [Коворк/Код](/docs/cowork)
- [Ошибки](/docs/errors)
