---
title: "record_write"
description: "Salva ou corrige registros em um lote atômico, validado contra `schemaVersion` sem coerção nem descarte de propriedades."
---

| Operação | Escopo OAuth | Descrição |
| :-- | :-- | :-- |
| `record_write` | `files:write` | Salva ou corrige registros em um lote atômico, validado contra `schemaVersion` sem coerção nem descarte de propriedades. Um item inválido, sem permissão ou em conflito recusa todo o lote. Novos registros usam `expectedVersion: 0`; correções recebem `recordId` e a revisão esperada. Corrigir registros de outros membros exige escrita na tabela. `sourceFileId` exige um arquivo ativo e legível do espaço da empresa e fixa sua versão atual como `sourceVersion`. A origem conserva essa versão mesmo depois de uma edição do arquivo. Cada arquivo em `citedFileIds` (até 10), os outros arquivos que o registro cita, também exige um arquivo ativo e legível do espaço da empresa; enquanto algum registro cita um arquivo, ele não pode ir para a lixeira nem ser apagado. |

Grupo: [Tabelas, registros e exportações](/docs/agents/mcp/tables-records-and-exports).