Для AI-агентов: markdown этой страницы — /docs-content/infra/database/rows-delete.md индекс документации — /llms.txt

Удалить строку

DELETE /v1/infra/servers/:id/db/tables/:table/rows/:key

Удаляет одну строку из таблицы SQLite-базы приложения в Галактике по её непрозрачному ключу. Вернуть удалённую строку можно только восстановлением всей базы из защитной копии.

Перед записью платформа сохраняет защитную копию базы — см. Защитные копии перед записью. Условия доступа — Когда база доступна.

Параметры

Тела у запроса нет: запрос с телом отклоняется с 400 VALIDATION_ERROR.

Параметр	Тип	Обяз.	Описание
Параметр`id` (path)	Типstring	Обяз.да	ОписаниеID приложения с `kind` равным `GALAXY_APP`. Список: `GET /v1/infra/servers`
Параметр`table` (path)	Типstring	Обяз.да	ОписаниеТочное имя таблицы из `data.tables[].name` ответа `GET /db/schema`, до 256 байт UTF-8. У таблицы должно быть `editability.editable: true`: представления, виртуальные таблицы и таблицы без первичного ключа и без доступного `rowid` не редактируются
Параметр`key` (path)	Типstring	Обяз.да	ОписаниеКлюч строки — элемент `data.rowKeys[i]` ответа `GET /db/tables/:table/rows`, выровненный со строкой `data.rows[i]`. Строка до 1024 символов base64url, подставляется в путь как есть. `null` в `rowKeys` означает, что строку адресовать нельзя: значение ключевой колонки `null`, BLOB или слишком длинное. Ключ строится по первичному ключу, а без него — по `rowid`, если колонка с таким именем не перекрывает его. Не изменяйте и не записывайте ключ в журналы: внутри — значения ключевых колонок строки
Параметр`file` (query)	Типstring	Обяз.нет	ОписаниеОтносительный путь к файлу базы внутри тома приложения, до 1024 байт UTF-8. По умолчанию — значение `VIBE_DB_PATH` контейнера приложения, без него `app.db`. Абсолютные пути, переходы вверх по каталогам и символические ссылки запрещены. Должен совпадать с файлом, из которого прочитан `key`

Примеры

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

Terminal

curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows/eyJ2IjoxLCJhcHBJZCI6IjdjMmIxZjA4LTNhNGQtNGU5MS05YjZjLTJmNWU4YTFkMGMzMyIsImZpbGUiOiJhcHAuZGIiLCJ0YWJsZSI6ImN1c3RvbWVycyIsImtpbmQiOiJwayIsImNvbHVtbnMiOlsiaWQiXSwidmFsdWVzIjpbeyJ0eXBlIjoiaW50ZWdlciIsInZhbHVlIjoiNCJ9XX0" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal

curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows/eyJ2IjoxLCJhcHBJZCI6IjdjMmIxZjA4LTNhNGQtNGU5MS05YjZjLTJmNWU4YTFkMGMzMyIsImZpbGUiOiJhcHAuZGIiLCJ0YWJsZSI6ImN1c3RvbWVycyIsImtpbmQiOiJwayIsImNvbHVtbnMiOlsiaWQiXSwidmFsdWVzIjpbeyJ0eXBlIjoiaW50ZWdlciIsInZhbHVlIjoiNCJ9XX0" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript

// Ключ берётся из data.rowKeys ответа GET /db/tables/customers/rows
const rowKey = 'eyJ2IjoxLCJhcHBJZCI6IjdjMmIxZjA4LTNhNGQtNGU5MS05YjZjLTJmNWU4YTFkMGMzMyIsImZpbGUiOiJhcHAuZGIiLCJ0YWJsZSI6ImN1c3RvbWVycyIsImtpbmQiOiJwayIsImNvbHVtbnMiOlsiaWQiXSwidmFsdWVzIjpbeyJ0eXBlIjoiaW50ZWdlciIsInZhbHVlIjoiNCJ9XX0'

const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows/${rowKey}`, {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data, error } = await res.json()
if (res.status === 409 && error.code === 'APP_DB_BACKUP_NOT_READY') {
  // Защитная копия готовится — повторите запрос через Retry-After секунд
  console.log('Повтор через', res.headers.get('Retry-After'), 'с')
} else {
  console.log('Удалено строк:', data.rowCount)
}

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

javascript

// Ключ берётся из data.rowKeys ответа GET /db/tables/customers/rows
const rowKey = 'eyJ2IjoxLCJhcHBJZCI6IjdjMmIxZjA4LTNhNGQtNGU5MS05YjZjLTJmNWU4YTFkMGMzMyIsImZpbGUiOiJhcHAuZGIiLCJ0YWJsZSI6ImN1c3RvbWVycyIsImtpbmQiOiJwayIsImNvbHVtbnMiOlsiaWQiXSwidmFsdWVzIjpbeyJ0eXBlIjoiaW50ZWdlciIsInZhbHVlIjoiNCJ9XX0'

const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows/${rowKey}`, {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data, error } = await res.json()
if (res.status === 409 && error.code === 'APP_DB_BACKUP_NOT_READY') {
  // Защитная копия готовится — повторите запрос через Retry-After секунд
  console.log('Повтор через', res.headers.get('Retry-After'), 'с')
} else {
  console.log('Удалено строк:', data.rowCount)
}

Поля ответа

Успешное удаление отвечает 200 OK с телом, а не 204 No Content.

Поле	Тип	Описание
Поле`success`	Типboolean	ОписаниеВсегда `true` при успехе
Поле`data.file`	Типstring	ОписаниеФайл базы, из которого удалена строка
Поле`data.table`	Типstring	ОписаниеИмя таблицы
Поле`data.rowCount`	Типnumber	ОписаниеЧисло удалённых строк, всегда `1`
Поле`data.durationMs`	Типnumber	ОписаниеВремя выполнения записи в базе, в миллисекундах
Поле`data.backupId`	Типstring	ОписаниеID защитной копии, сделанной перед первой правкой строк за последние 10 минут. Правки строк в этом окне получают одну и ту же копию, и восстановление из неё отменяет их все. Список копий — `GET /db/backups`, восстановление — `POST /db/restore`

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

JSON

{
  "success": true,
  "data": {
    "file": "app.db",
    "rowCount": 1,
    "durationMs": 1.2,
    "table": "customers",
    "backupId": "cb2fcdfd-bace-4932-a276-31d737337f3d"
  }
}

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

404 — строки с этим ключом уже нет, например после повторного удаления: