Skip to main content
The Apps API is in beta. Its endpoints and responses may change.
A checkpoint is a saved version of an app, captured as you build. These endpoints list an app’s checkpoints, create new ones, return the app to an earlier one, and read the files a checkpoint holds. See Apps API concepts for how checkpoints relate to turns and branches.

What a checkpoint holds

A checkpoint records the app’s committed code, its entity schemas, and its backend functions. Restore checkpoint rolls the code back to the checkpoint’s commit, redeploys the backend functions from that code, and restores the entity schemas the checkpoint saved.

Deploying a checkpoint

To publish a specific checkpoint, pass its id as checkpoint_id to Deploy an app. If a checkpoint’s preview_status in List checkpoints is failed, use Retry checkpoint build to start its preview build again.

Endpoints