
## Восстановить регистрацию бота

`POST /v1/bots/registrations/:code/recover`

Завершает регистрацию бота, результат которой не был подтверждён сразу, и возвращает ID бота на портале Битрикс24. Вызывается тем же ключом и с тем же кодом бота, что и исходная регистрация.

Вызов нужен, когда [`POST /v1/bots`](/docs/bots/management/create) ответил `409 BOT_EFFECT_DESIRED_STATE_NOT_PROVED`: запрос на регистрацию отправлен, но её результат ещё не проверен. Новый бот при этом не регистрируется — Вайбкод проверяет уже отправленную регистрацию и завершает запись о боте.

## Параметры

| Параметр | Тип | Обяз. | Описание |
|----------|-----|:-----:|---------|
| `code` (path) | string | да | Код бота — значение поля `code` из запроса [`POST /v1/bots`](/docs/bots/management/create) |

Тело запроса не требуется.

## Примеры

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

```bash
curl -X POST https://vibecode.bitrix24.tech/v1/bots/registrations/support_bot/recover \
  -H "X-Api-Key: YOUR_API_KEY"
```

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

```bash
curl -X POST https://vibecode.bitrix24.tech/v1/bots/registrations/support_bot/recover \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/registrations/support_bot/recover', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()
console.log(data) // { botId: 42, code: 'support_bot', recovered: true }
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/registrations/support_bot/recover', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()
```

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

| Поле | Тип | Описание |
|------|-----|---------|
| `data.botId` | number | ID бота на портале Битрикс24 — тот же, что `data.bots[].id` в [`GET /v1/bots`](/docs/bots/management/list) |
| `data.code` | string | Код бота из пути запроса |
| `data.recovered` | boolean | Всегда `true` |

## Пример ответа

```json
{
  "success": true,
  "data": {
    "botId": 42,
    "code": "support_bot",
    "recovered": true
  }
}
```

## Пример ответа при ошибке

404 — у ключа нет регистрации с таким кодом:

```json
{
  "success": false,
  "error": {
    "code": "BOT_REGISTRATION_NOT_FOUND",
    "message": "No owned registration is available for recovery"
  }
}
```

## Ошибки

| HTTP | Код | Описание |
|------|-----|---------|
| 400 | `CODE_REQUIRED` | Код бота в пути пустой |
| 404 | `BOT_REGISTRATION_NOT_FOUND` | У ключа нет регистрации с этим кодом, которую можно завершить. Так же отвечает вызов с другим ключом или с другим кодом, чем при регистрации |
| 409 | `BOT_REGISTRATION_RECOVERY_PENDING` | Подтверждение или сверка регистрации ещё не завершены. Повторите вызов через число секунд из `Retry-After`: до следующей плановой проверки (от 1 до 300 секунд), иначе 30 секунд. Если ответ повторяется, обратитесь в поддержку и передайте `error.details.registrationRef`, когда он есть в ответе |
| 409 | `BOT_UNAVAILABLE` | Состояние регистрации требует исправления на стороне платформы, в том числе при несовместимой OAuth-политике или изменившемся подтверждении приложения. Заголовка `Retry-After` нет, повтор не поможет. Обратитесь в поддержку и передайте `error.details.registrationRef`, когда он есть в ответе, иначе исходный код бота и портал |
| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `imbot` |
| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ только для чтения — см. [права доступа](/docs/access-rights) |

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

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

**Повторный вызов безопасен.** Если регистрация уже завершена, вызов с тем же ключом и кодом снова возвращает `200` с тем же `botId`.

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

- [Список ботов](/docs/bots/management/list)
- [Восстановление доступа к боту](/docs/bots/ownership-recovery)
- [Бот-платформа](/docs/bots)
