ADadexad

Get data version history status

Changed on

<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 28.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app, or a workspace API key, which acts as the workspace owner. Read-only keys work too.</Note>

Runs as your user in this app, so the app's access rules decide which records you can read or change.

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

Request

  • Base URL
    https://app.base44.com
  • Auth
    • HTTP bearer
    • or API key in header api_key
    • or HTTP bearer

Path parameters

app_idstring required

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": 28,
  "history_available_since": "2026-06-02T08:00:00Z"
}

Changes

  • e51af2957a57Revision changes
    • info

      added the non-success response with the status

  • 0ca6a43fceb9Revision changes
    • info

      the endpoint scheme security WorkspaceApiKeyAuth was added to the API

    • info

      the endpoint scheme security WorkspaceApiKeyBearerAuth was added to the API