## Убрать приложение из Битрикс24

`POST /v1/infra/servers/:id/b24-catalog/hide`

Скрывает приложение от сотрудников в каталоге Битрикс24 и удаляет чат приложения вместе с историей. Доступ к приложению и его ссылки сохраняются.

## Параметры

| Параметр | Тип | Обяз. | Описание |
|----------|-----|:-----:|----------|
| `id` (path) | string (UUID) | да | ID сервера из [списка серверов](./list.md). Сервер должен управляться API-ключом запроса |

Тело запроса может быть пустым или `{}`. Неизвестные поля игнорируются.

## Примеры

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

```bash
curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" -d '{}' \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/b24-catalog/hide
```

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

```bash
curl -X POST -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" -d '{}' \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/b24-catalog/hide
```

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

```javascript
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/b24-catalog/hide`,
  {
    method: 'POST',
    headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: '{}',
  }
)
const body = await res.json()
if (!body.success) throw new Error(body.error.code)
console.log(body.data.showInBitrix24, body.data.queued)
```

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

```javascript
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/b24-catalog/hide`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
      'Content-Type': 'application/json',
    },
    body: '{}',
  }
)
```

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

| Поле | Тип | Описание |
|------|-----|----------|
| `success` | boolean | `true`, когда выбор сохранён |
| `data.queued` | boolean | `true`, если карточка существует и её удаление поставлено в очередь. `false`, если карточки нет |
| `data.showInBitrix24` | string | Сохранённый выбор. Всегда `NO` |

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

У карточки поставлено удаление:

```json
{
  "success": true,
  "data": {
    "queued": true,
    "showInBitrix24": "NO"
  }
}
```

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

404 — сервер не найден или управляется другим API-ключом:

```json
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Server not found"
  }
}
```

## Ошибки

| HTTP | Код | Описание |
|------|-----|----------|
| 404 | `NOT_FOUND` | Сервер отсутствует, удалён или управляется другим API-ключом |
| 404 | `NOT_FOUND` | Сервер удалили до сохранения выбора |
| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |
| 401 | `INVALID_API_KEY` | Ключ не опознан |
| 403 | `INFRA_FORBIDDEN_FOR_COWORK_KEY` | Ключ Cowork/Code не разрешает изменяющие операции. Используйте [проектный ключ для деплоя](/docs/cowork/deploy-key) |
| 403 | `WRITE_BLOCKED_READONLY_KEY` | У ключа режим «только чтение», а скрытие карточки — операция записи. Переключите ключ на чтение и запись, порядок — [Режим доступа](/docs/keys-auth/access-mode) |
| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите запрос после паузы из заголовка `Retry-After` |

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

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

- **Карточка удаляется в фоне.** Готовность проверяйте через [состояние сервера](./get.md): `b24CatalogSync.itemId` стал `null`, а `pendingOp` перестал быть `DELETE`.
- **Скрыть можно и до создания карточки.** Ожидающая публикация отменяется, выбор становится `NO`. Следующие деплои этот выбор сохраняют и карточку не создают.
- **Повторная публикация создаёт новый чат.** После удаления [покажите приложение снова](./b24-catalog-publish.md), если оно нужно сотрудникам. Новый чат будет пустым, прежняя история не восстанавливается. Пока удаление ожидает выполнения, публикация отвечает `409 CATALOG_DELETE_PENDING` и выбор остаётся `NO`.
- **Повторный вызов сохраняет выбор.** Если карточки уже нет, метод возвращает `queued: false` и `showInBitrix24: "NO"`.

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

- [Опубликовать приложение в каталоге Битрикс24](./b24-catalog-publish.md)
- [Получить сервер](./get.md)
- [Полный деплой приложения](/docs/infra/deploy/deploy)
