List checkpoints

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/app-checkpoints \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/app-checkpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/app-checkpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/app-checkpoints"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/app-checkpoints")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
    "is_github_sync": false
  }
]

Checkpoints

List checkpoints

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

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.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

GET

api

apps

{app_id}

app-checkpoints

List checkpoints

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/app-checkpoints \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/app-checkpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/app-checkpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/app-checkpoints"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/app-checkpoints")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
    "is_github_sync": false
  }
]

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app.

Query Parameters

limit

integer | null

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

skip

integer | null

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

Response

Successful Response

string | null

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

Example:

"6886b8d390dc7e2f4a2c91b3"

name

string | null

Name of the checkpoint.

Example:

"Add contact form"

changes

string | null

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

Example:

"Added a contact form to the home page"

preview_status

enum<string> | null

Build status of this checkpoint's preview. Either pending, building, ready, or failed, or null if no preview build was attempted.

Available options:

pending,

building,

ready,

failed

Example:

"ready"

created_by

string | null

Email of the user who created the checkpoint.

Example:

"developer@example.com"

created_date

string<date-time> | null

Time the checkpoint was created, as a UTC timestamp in ISO 8601 format.

Example:

"2026-08-01T09:15:00"

last_deployed_at

string<date-time> | null

Time this checkpoint was last deployed to production, as a UTC timestamp in ISO 8601 format, or null if it has never been deployed.

Example:

"2026-08-02T14:30:00"

git_commit_hash

string | null

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

Example:

"a1b2c3d4e5f67890abcdef1234567890abcdef12"

preview_url

string | null

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

Example:

"https://preview.base44.app/6886b8d390dc7e2f4a2c91b3"

is_github_sync

boolean | null

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

Example:

false

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

List checkpoints

Authorizations

Path Parameters

Query Parameters

Response