Sign in

Get data version history status

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns whether the app has version history for its entity data, and how far back it goes.

Base44 records every change to an entity's records, and marks points you can go back to as checkpoints. Read state before calling the other version history endpoints, since they're refused unless it's enabled.

Version history comes with the Elite plan and above. Elite keeps 7 days of history, and higher plans keep 30.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

get/api/apps/{app_id}/entities/versions/info

Path parameters

app_idstring required

ID of the app.

ID of the app.

Response

The app's version history status.

state'enabled' | 'needs_upgrade' | 'unavailable' required

Whether the app has version history. enabled means Base44 is keeping history and you can list checkpoints and restore from them. needs_upgrade means the app's workspace plan doesn't include version history. unavailable means version history doesn't cover this app, for example because its data is stored in the workspace's own database.

retention_daysinteger nullable

How many days of history Base44 keeps, or null unless state is enabled.

history_available_sincestring nullable

The earliest moment you can restore to, as a UTC timestamp in ISO 8601 format with a Z suffix, when history was paused while the workspace was on a plan without it. It is null unless state is enabled, and also when retention_days alone limits how far back you can go.

Example response

{
  "state": "enabled",
  "retention_days": 30,
  "history_available_since": "2026-06-02T08:00:00Z"
}

Changes

Changed in 1 of the 33 revisions of this API.1