sandbox checkpoint

Save a restore point for an app’s sandbox. A checkpoint appears in the app’s version history in the Base44 app editor, where you can restore the app to that state later. Use it to mark a known-good state before or after a set of risky changes. A checkpoint records the latest commit stored for the app. Before creating it, the command finishes any commit that sandbox write, sandbox edit, or sandbox run has started. A file you change in the sandbox another way, such as in a code editor connected to the sandbox, isn’t included until it’s committed. To include it, run any sandbox run command, then create the checkpoint. If the command can’t confirm that those commits finished, it fails with COMMIT_FLUSH_PENDING instead of checkpointing a stale state. Wait a moment and run it again. sandbox commands don’t require a local project. Target an app by passing --app-id, setting the BASE44_APP_ID environment variable, or running the command from a linked project if you have one.

This command needs the sandbox:write permission. The CLI requests it when you sign in, and an existing session cannot gain it afterwards. If the command fails with an authorization error, run base44 login again to start a session that has it.

Usage

base44 sandbox checkpoint

Flags

Flag	Description
`--app-id <id>`	Target the specified app. Defaults to the app linked in the current project. See Select a target app.
`--branch <name>`	Target a branch of the app by exact name. Defaults to `main`.
`--name <name>`	Title for the checkpoint, up to 200 characters. Defaults to a generated title.
`--json`	Keep stdout to just the JSON result, without the interactive status line. See JSON output.

Output

The command returns JSON:

{
  "checkpointId": "68a1f0c4e2b91a0012d4c7fa",
  "name": "before refactor",
  "gitCommitHash": "3f9c1ab7d2e845c0b6f31e29a7d4c8b501ae6f32"
}

Field	Description
`checkpointId`	ID of the new checkpoint.
`name`	The checkpoint title. `null` when no title could be set.
`gitCommitHash`	Commit the checkpoint is anchored to. `null` when it is not available.

Get Started

Commands

Usage

Flags

Output

See also

​Usage

​Flags

​Output

​See also

Usage

Flags

Output

See also