Sign in
latestOpenAPI 3.1.02026-08-205816.9 KB

4620b74b36e4

List checkpoints

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

Returns the specified app's checkpoints, newest first. A checkpoint is a saved version of the app, captured as you build.

To deploy a specific checkpoint, pass its id as the checkpoint_id to Deploy an app.

<Warning>The response may include fields beyond the ones documented here. Don't use any undocumented fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/app-checkpoints

Path parameters

app_idstring required

ID of the app.

ID of the app.

Query parameters

limitinteger nullable

Maximum number of checkpoints to return, between 1 and 10000. Omit to return all of them.

Maximum number of checkpoints to return, between 1 and 10000. Omit to return all of them.

skipinteger nullable

Number of checkpoints to skip before the page starts, 0 or greater. Combine with limit to page through results.

Number of checkpoints to skip before the page starts, 0 or greater. Combine with limit to page through results.

Response

The app's checkpoints.

idstring nullable

ID of the checkpoint. Pass it as checkpoint_id to Deploy an app to deploy this saved version.

namestring nullable

Name of the checkpoint.

changesstring nullable

Summary of what changed in this checkpoint, or null if none was recorded.

preview_status'pending' | 'building' | 'ready' | 'failed' nullable

Build status of this checkpoint's preview, or null if no preview build was attempted.

created_bystring nullable

Email of the user who created the checkpoint.

created_datestring date-time nullable

Time the checkpoint was created.

last_deployed_atstring date-time nullable

Time this checkpoint was last deployed to production, or null if it has never been deployed.

git_commit_hashstring nullable

Git commit hash of the code captured in this checkpoint, or null if it has no commit.

preview_urlstring nullable

URL to preview this checkpoint's build, or null if the checkpoint has no build.

is_github_syncboolean nullable

Whether the checkpoint came from a GitHub sync (true) or an in-app change (false).

Example response

[
  {
    "id": "6886b8d390dc7e2f4a2c91b3",
    "name": "Add contact form",
    "changes": "Added a contact form to the home page",
    "preview_status": "ready",
    "created_by": "developer@example.com",
    "created_date": "2026-08-01T09:15:00",
    "last_deployed_at": "2026-08-02T14:30:00",
    "git_commit_hash": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
    "preview_url": "https://preview.base44.app/6886b8d390dc7e2f4a2c91b3"
  }
]