---
title: "A record's history, as the builder"
description: "Every change to the record, one entry per field that moved, newest first."
canonical: "https://gtable.app/docs/builder-api/data/records-history"
updated: "2026-10-05"
---

# A record's history, as the builder

`GET https://studio.gtable.app/v1/apps/{appId}/records/{recordId}/history`

Every change to the record, one entry per field that moved, newest first.

`tableId` names the table it is in.

Requires the `records:read` scope. Operation `apps.records.history`. MCP tool `apps_records_history`. CLI, once published: `gtable apps records history`.

## Path parameters

| Name       | Type   | Required | Description |
| ---------- | ------ | -------- | ----------- |
| `appId`    | string | yes      |             |
| `recordId` | string | yes      |             |

## Query parameters

| Name      | Type    | Required | Description   |
| --------- | ------- | -------- | ------------- |
| `limit`   | integer | no       | Default `50`. |
| `tableId` | string  | yes      |               |