> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List checkpoints
> The App Management 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](/developers/references/app-management/get-started/overview#checkpoints) 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](/api-reference/deploy-an-app).
The response may include fields beyond the ones documented here. Don't use any undocumented fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/app-checkpoints
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/app-checkpoints:
get:
summary: List checkpoints
description: >-
The App Management 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](/developers/references/app-management/get-started/overview#checkpoints)
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](/api-reference/deploy-an-app).
The response may include fields beyond the ones documented
here. Don't use any undocumented fields, as they can change at any
time.
operationId: list_checkpoints_api_apps__app_id__app_checkpoints_get
parameters:
- description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
in: path
name: app_id
required: true
schema:
description: ID of the app.
title: App Id
type: string
- description: >-
Maximum number of checkpoints to return, between 1 and 10000. Omit
to return all of them.
example: 50
in: query
name: limit
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: >-
Maximum number of checkpoints to return, between 1 and 10000. Omit
to return all of them.
title: Limit
- description: >-
Number of checkpoints to skip before the page starts, 0 or greater.
Combine with `limit` to page through results.
example: 0
in: query
name: skip
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: >-
Number of checkpoints to skip before the page starts, 0 or
greater. Combine with `limit` to page through results.
title: Skip
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/CheckpointSummary'
title: >-
Response 200 List Checkpoints Api Apps App Id App
Checkpoints Get
type: array
description: The app's checkpoints.
'400':
description: '`limit` is outside 1 to 10000, or `skip` is negative.'
'401':
description: Missing or invalid credentials.
'403':
description: You don't have access to this app.
'404':
description: App not found.
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
components:
schemas:
CheckpointSummary:
properties:
changes:
anyOf:
- type: string
- type: 'null'
description: >-
Summary of what changed in this checkpoint, or `null` if none was
recorded.
example: Added a contact form to the home page
title: Changes
created_by:
anyOf:
- type: string
- type: 'null'
description: Email of the user who created the checkpoint.
example: developer@example.com
title: Created By
created_date:
anyOf:
- format: date-time
type: string
- type: 'null'
description: Time the checkpoint was created.
example: '2026-08-01T09:15:00'
title: Created Date
git_commit_hash:
anyOf:
- type: string
- type: 'null'
description: >-
Git commit hash of the code captured in this checkpoint, or `null`
if it has no commit.
example: a1b2c3d4e5f67890abcdef1234567890abcdef12
title: Git Commit Hash
id:
anyOf:
- type: string
- type: 'null'
description: >-
ID of the checkpoint. Pass it as `checkpoint_id` to [Deploy an
app](/api-reference/deploy-an-app) to deploy this saved version.
example: 6886b8d390dc7e2f4a2c91b3
title: Id
is_github_sync:
anyOf:
- type: boolean
- type: 'null'
description: >-
Whether the checkpoint came from a GitHub sync (`true`) or an in-app
change (`false`).
example: false
title: Is Github Sync
last_deployed_at:
anyOf:
- format: date-time
type: string
- type: 'null'
description: >-
Time this checkpoint was last deployed to production, or `null` if
it has never been deployed.
example: '2026-08-02T14:30:00'
title: Last Deployed At
name:
anyOf:
- type: string
- type: 'null'
description: Name of the checkpoint.
example: Add contact form
title: Name
preview_status:
anyOf:
- enum:
- pending
- building
- ready
- failed
type: string
- type: 'null'
description: >-
Build status of this checkpoint's preview, or `null` if no preview
build was attempted.
example: ready
title: Preview Status
preview_url:
anyOf:
- type: string
- type: 'null'
description: >-
URL to preview this checkpoint's build, or `null` if the checkpoint
has no build.
example: https://preview.base44.app/6886b8d390dc7e2f4a2c91b3
title: Preview Url
title: CheckpointSummary
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
ApiKeyAuth:
description: Personal API key.
in: header
name: api_key
type: apiKey
````