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

Добавить строку

POST /v1/infra/servers/:id/db/tables/:table/rows

Добавляет одну строку в таблицу SQLite-базы приложения в Галактике. Значения колонок передаются в теле запроса, SQL писать не нужно.

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

Параметры

Параметр	Тип	Обяз.	Описание
Параметр`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` строк не принимают

Поля запроса (body)

Тело — строгий JSON: поля, которых нет в таблице ниже, отклоняются с 400 VALIDATION_ERROR. Размер тела — до 64 КиБ.

Поле	Тип	Обяз.	Описание
Поле`file`	Типstring	Обяз.нет	ОписаниеОтносительный путь к файлу базы внутри тома приложения, до 1024 байт UTF-8. По умолчанию — значение `VIBE_DB_PATH` контейнера приложения, без него `app.db`. Абсолютные пути, переходы вверх по каталогам и символические ссылки запрещены
Поле`values`	Типobject	Обяз.да	ОписаниеЗначения новой строки: ключ — имя колонки из схемы, до 256 байт UTF-8, значение — ячейка. До 256 колонок. Пустой объект `{}` добавляет строку из значений по умолчанию — `INSERT ... DEFAULT VALUES`. Вычисляемые и скрытые колонки передавать нельзя
Поле`values.<колонка>`	Типnull \| number \| string \| object	Обяз.—	Описание`null`, конечное число, строка до 64 КиБ UTF-8 или объект `{ "type": "integer", "value": "9223372036854775807" }` для точного 64-битного целого. Целое число без объекта — только в диапазоне ±9007199254740991. Логические значения, массивы, BLOB и другие объекты не принимаются

Примеры

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "values": {
      "name": "Customer D",
      "email": "d@example.com"
    }
  }'

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "values": {
      "name": "Customer D",
      "email": "d@example.com"
    }
  }'

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    values: {
      name: 'Customer D',
      email: 'd@example.com',
    },
  }),
})

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.backupId)
}

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/infra/servers/7c2b1f08-3a4d-4e91-9b6c-2f5e8a1d0c33/db/tables/customers/rows', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    values: {
      name: 'Customer D',
      email: 'd@example.com',
    },
  }),
})

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.backupId)
}

Поля ответа

Поле	Тип	Описание
Поле`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": 0.903,
    "table": "customers",
    "backupId": "cb2fcdfd-bace-4932-a276-31d737337f3d"
  }
}

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

409 — защитная копия ещё не готова, строка не добавлена. Ответ приходит с заголовком Retry-After: 1: