Skip to main content
GET
Get data version history status

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Response

The app's version history status.

Whether version history is on for an app, and how far back it goes.

state
enum<string>
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.

Available options:
enabled,
needs_upgrade,
unavailable
Example:

"enabled"

retention_days
integer | null

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

Example:

30

history_available_since
string | null

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:

"2026-06-02T08:00:00Z"