---
title: "Update records"
method: PUT
path: "/sheets/{sheetId}/records"
tags: ["records"]
---

# Update records

`PUT /sheets/{sheetId}/records`

Updates existing records in a workbook sheet

## Path parameters

- `sheetId` string, required — Sheet ID

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Request body

- TypeRecordsRecord[] — List of Record objects
  - `id` string, required — Record ID
  - `versionId` string — Version ID
  - `commitId` string — Commit ID
  - `valid` boolean — Auto-generated value based on whether the record contains a field with an error message. Cannot be set via the API.
  - `messages` TypeRecordsValidationMessage[] — This record level `messages` property is deprecated and no longer stored or used. Use the `messages` property on the individual cell values instead. This property will be removed in a future release.
    - `field` string
    - `type` 'error' | 'warn' | 'info'
    - `source` 'required-constraint' | 'unique-constraint' | 'custom-logic' | 'unlinked' | 'invalid-option' | 'is-artifact'
    - `message` string
    - `path` string — A JSONPath string - https://www.rfc-editor.org/rfc/rfc9535
  - `metadata` object
  - `config` TypeRecordsRecordConfig — Configuration of a record or specific fields in the record
    - `readonly` boolean
    - `fields` object
    - `markedForDeletion` boolean
  - `values` TypeRecordsRecordData, required — A single row of data in a Sheet

## Response `200`

Response with status 200

- TypeVersionsVersionResponse
  - `data` TypeVersionsVersion, required
    - `versionId` string, required — Version ID

## Other responses

- `400` — Error response with status 400
- `404` — Error response with status 404

---

[API](https://skmtc.net/flatfile/apis/api-reference.md) · [All operations](https://skmtc.net/flatfile/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flatfile/api-reference/revisions/9d3a9979cd96/schema)