---
title: "record_write"
description: "Saves or corrects records in one atomic batch, validated against `schemaVersion` with no coercion and no dropped properties."
---

| Operation | OAuth scope | Description |
| :-- | :-- | :-- |
| `record_write` | `files:write` | Saves or corrects records in one atomic batch, validated against `schemaVersion` with no coercion and no dropped properties. One invalid, unauthorized or conflicting item refuses the whole batch. New records use `expectedVersion: 0`; corrections take `recordId` and the expected revision. Correcting other members' records requires write on the table. `sourceFileId` requires an active, readable company-space file and pins its current version as `sourceVersion`. The source keeps that version after later file edits. Each file in `citedFileIds` (up to 10), the other files the record cites, also requires an active, readable company-space file; while any record cites a file, it can't be trashed or purged. |

Group: [Tables, records and exports](/docs/en-US/agents/mcp/tables-records-and-exports).