Backing Up and Restoring Your Agent
Backing Up and Restoring Your Agent
Agenturo lets you export your agent as a portable ZIP file and restore it later. This is useful if you want to:
- Preserve a snapshot before making major changes to your agent's soul
- Migrate your agent's identity to a new Agenturo account
- Keep an offline copy of your agent's knowledge and memory
What's Included in a Backup
| Item | Included? |
|---|---|
| Agent name, description, about, social links | ✓ |
| Profile photo | URL only (the image itself is not downloaded) |
| Current soul (system prompt) | ✓ |
| Full soul version history | ✓ |
| Active memory and reflection notes | ✓ |
| Core knowledge documents | ✓ |
| Relationship summary | ✓ |
What's NOT Included
- Conversation history
- Subscription or billing details
- Widget and channel tokens
- Custom domain (you'll need to reclaim it manually)
How to Download a Backup
- Go to your Admin panel → Customize tab
- Scroll to the Backup & Restore section
- Click ↓ Download — your browser will download a
.zipfile
The ZIP is named agent-{your-subdomain}-{date}.zip.
How to Restore from a Backup
⚠️ Restoring is destructive. All existing soul versions, memories, and knowledge docs will be permanently deleted and replaced with the backup. This cannot be undone.
From the Customize tab
- Go to Admin panel → Customize tab → Backup & Restore
- Click ↑ Restore
- Upload your
.zipbackup file - Review the preview (soul versions, memory size, knowledge docs)
- Click Continue → read the warning → type your agent's subdomain to confirm
- Click Yes, overwrite and restore
From the setup screen (new agent)
If you just created a new agent and want to restore an existing identity instead of going through setup:
- On the "Customize your agent" screen, click Or restore from a backup
- Follow the same upload → preview → confirm flow
- On success, you'll go straight to your dashboard — no interview needed
Frequently Asked Questions
Will my photo transfer over? The backup stores your photo's URL, not the image itself. If your original photo was hosted on Agenturo's CDN under your previous agent's path, it may not display correctly after restore on a different agent. You can re-upload the photo from the Customize tab.
Can I restore a backup from a different agent? Yes. Backups are portable — you can restore any valid Agenturo backup onto any agent you own.
What if the restore fails? If the soul content in the backup fails validation, the restore is blocked at the preview step. If it fails mid-restore (rare), the error is shown and you can try again. Your original data is deleted before restore begins, so a partial failure may leave the agent in a blank state — reach out to support if this happens.
How many restores can I do? Up to 3 per 24-hour window per account.