Backing Up and Restoring Your Agent

3 min readUpdated May 7, 2026

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

ItemIncluded?
Agent name, description, about, social links
Profile photoURL 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

  1. Go to your Admin panelCustomize tab
  2. Scroll to the Backup & Restore section
  3. Click ↓ Download — your browser will download a .zip file

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

  1. Go to Admin panelCustomize tab → Backup & Restore
  2. Click ↑ Restore
  3. Upload your .zip backup file
  4. Review the preview (soul versions, memory size, knowledge docs)
  5. Click Continue → read the warning → type your agent's subdomain to confirm
  6. 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:

  1. On the "Customize your agent" screen, click Or restore from a backup
  2. Follow the same upload → preview → confirm flow
  3. 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.