#Удалить ключ провайдера

DELETE /v1/ai/credentials/:id

Удаляет подключённый ключ провайдера. Связанные модели Custom-провайдера, привязанные к этому ключу, удаляются каскадно. История использования (AiUsageLog) сохраняется — записи статистики не пропадают.

#Параметры

Параметр Тип Обяз. Описание
id (path) string да ID ключа из `GET /v1/ai/credentials`

#Примеры

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

Terminal 
curl -X DELETE https://vibecode.bitrix24.tech/v1/ai/credentials/cred_abc123def456 \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE https://vibecode.bitrix24.tech/v1/ai/credentials/cred_abc123def456 \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const id = 'cred_abc123def456'
const res = await fetch(`https://vibecode.bitrix24.tech/v1/ai/credentials/${id}`, {
  method: 'DELETE',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { success } = await res.json()
if (success) console.log('Ключ удалён')

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

javascript 
const id = 'cred_abc123def456'
const res = await fetch(`https://vibecode.bitrix24.tech/v1/ai/credentials/${id}`, {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

if ((await res.json()).success) console.log('OK')

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе

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

HTTP-статус 200 OK:

JSON 
{
  "success": true
}

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

404 not_found — ключ не найден или принадлежит другому пользователю:

JSON 
{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "Credential not found"
  }
}

#Ошибки

HTTP Код Описание
404 not_found Ключ с таким id не найден или не принадлежит вам
403 scope_missing API-ключу не хватает скоупа vibe:ai
401 MISSING_API_KEY Не передан заголовок X-Api-Key

Полный список общих ошибок API — Ошибки.

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

Каскадное удаление моделей. Для Custom-провайдера, к ключу которого привязаны модели через `POST /v1/ai/credentials/:id/models` или `POST /v1/ai/credentials/:id/fetch-models`, все привязанные модели удаляются вместе с ключом.

История использования сохраняется. Записи AiUsageLog не удаляются — статистика по этому провайдеру за прошлые периоды останется в `GET /v1/ai/usage`. Поля modelId и providerId хранятся как строки, без FK-связи с таблицей ключей.

Только USER-ключи. Эндпоинт работает только с ключами текущего пользователя. PORTAL-ключи, подключённые администратором для всех — здесь недоступны.

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