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

Изменить строку

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

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

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

Параметры

Параметр	Тип	Обяз.	Описание
Параметр`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`, если колонка с таким именем не перекрывает его. Не изменяйте и не записывайте ключ в журналы: внутри — значения ключевых колонок строки

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

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

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

Примеры

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

Terminal

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

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

Terminal

curl -X PATCH "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" \
  -H "Content-Type: application/json" \
  -d '{
    "values": {
      "email": "d2@example.com"
    }
  }'

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: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    values: {
      email: 'd2@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.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: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    values: {
      email: 'd2@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.rowCount)
}

Поля ответа

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

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

409 — в values передана колонка первичного ключа id: