Version History
Track every change to your apps and agents — and roll back any version
Both the App Builder and the Agent Builder keep a full version history of every meaningful change. You can browse the timeline, save labeled checkpoints, restore any version in place, or branch a new copy from any version.
When versions are captured
| Trigger | Source | What happens |
|---|---|---|
| AI build turn completes | AI turn |
A snapshot is taken automatically at the end of every successful turn that changed something. Identical snapshots are skipped. |
| You click Save current version | Saved |
A manual checkpoint, with an optional label. |
| You restore a version in place | Pre-restore + Restored |
The current state is auto-snapshotted before the restore (so every Replace is reversible), and the restored state is also snapshotted right after — so you can return to that exact moment later. |
Restore options
Every version row has a Restore button that opens a dialog with two choices:
- Replace this app/agent — overwrites the current state. A pre-restore snapshot is saved first.
- Duplicate from this version — clones the chosen version into a new app or agent. The current one is untouched.
Owners (and platform Admins) can use Replace. Anyone with Design-level access or higher can browse history and use Duplicate.
What's included in a snapshot
Apps: properties (name, slug, description, categories, form factor, safe mode, enabled flag), all files, and integration points. Sharing, deployments, conversations and statistics are not included — restoring never affects who can see your app or where it's deployed. A small thumbnail of the app's home screen is also captured at the end of every AI build turn and shown next to each version in the timeline (and as the app's tile thumbnail), so you can recognise versions visually.
Agents: all configuration (name, instructions, capabilities, icon, greeting, reasoning level, MCP servers, identifier, base agent) and the agent's optimization data. Sharing is not included.
Labels and retention
- Versions you give a label are kept forever.
- Unlabeled versions are auto-pruned: only the 50 most recent unlabeled versions per app/agent are kept.
- Click the pencil next to a version to add or change its label at any time.
- Each AI-turn version also shows a short preview of your prompt (the user message that triggered the turn), trimmed to 140 characters — so you can recognise versions by what you asked for, not by what the AI replied.
Where to find it
- App Builder → Properties tab → Version history card.
- Agent Builder → top right of the panel → History button.