BAbase44

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

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

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

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/apps/{app_id}/entities/versions/info
  • Auth
    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": 30,
  "history_available_since": "2026-06-02T08:00:00Z"
}

Changes

  • 32455e516133Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API