> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/en/advanced-features/backup-transfer-and-deletion.md).

# Backup, transfer and deletion of an Agent

AIsuru lets you download a backup of an Agent, transfer ownership to another user, or permanently delete it. These operations are irreversible, so it's important to proceed with care.

### How to access the management options

To transfer or delete an Agent, **go to** **Settings >** **Manage** for your Agent. From there you can choose to delete or transfer your Agent.

### Backing up an Agent

AIsuru offers two complementary methods for backing up your Agents:

#### 1. Full Agent export

The full export lets you export the entire Agent as a zip file, including all settings and associated media:

1. Go to **Settings > Manage** for your Agent
2. In the "Export this Agent" section, click the **EXPORT** button
3. Wait for the zip file to download

The exported zip file contains:

* A JSONL file with all the Agent's settings and configurations
* A "media" folder with all the media files attached to your content

This backup method is ideal for:

* Creating complete backups of your Agent
* Transferring an identical Agent to another AIsuru instance
* Running A/B tests by creating modified copies of the same Agent

| Data kept in the zip file | Data not kept in the zip file             |
| ------------------------- | ----------------------------------------- |
| Roles                     | Layouts (only the default layout is kept) |
| Content                   | Followers                                 |
| Dictionary                | Conversations                             |
| Functions                 | MCP                                       |
| Import history            | Statistics                                |

#### 2. CSV content export

For a lighter backup focused only on text content:

1. Go to the Agent management panel
2. Navigate to the **Import / Export** section
3. Select the **"Export CSV"** tab

#### **Export configuration**

Before exporting, you can customize various aspects of the resulting CSV file:

* Open the **"Advanced"** section on the export page
* Configure the following options as needed:
  * CSV column separator
  * Question variant separator
  * Column names for Question, Response, Required Topics, and Topics to Set

#### **Running the backup**

Once you've configured your options:

1. Find the "Export" button at the bottom of the page
2. Click "Export" to start downloading the CSV file

Your browser will automatically save the file to the default downloads folder.

#### **Using the backup file**

The exported CSV is a versatile tool you can use to:

* Create a backup of your Agent's text content
* Easily transfer content between different Agents or external platforms
* Analyze and edit content using spreadsheets
* Share the knowledge base with your team or other stakeholders

#### **Limitations of CSV backup**

Backing up your Agent in CSV format has some limitations:

* It doesn't include media, links, or other content customizations
* It only contains question, question variants, response, other responses, set topics, required topics, and tags
* It doesn't save your Agent's instructions or functional and aesthetic settings

### Importing a full Agent

To import a previously exported Agent:

1. Go to the platform homepage where your list of Agents is shown
2. Click the **Import** button in the top right, above your Agents
3. A popup will open to upload the zip file
4. After uploading, you'll see a "Upload completed successfully" message
5. A popup will appear where you can name the new Agent
6. Click "Import" to start the process

During the import:

* A notification in the top right will keep you updated on progress
* You'll first see an "In progress" message followed by the number of items processed out of the total
* When complete, the notification will show "Import completed"
* You can manage your new Agent by clicking "Manage" in the notification

{% hint style="warning" %} <mark style="color:orange;">If the import fails (e.g., corrupted zip file or an Agent name that already exists), the top right notification will show "Import failed".</mark>
{% endhint %}

### How to import the CSV file

To import the CSV file into an Agent, you can:

### Ownership transfer

To transfer an Agent to another user:

1. Click the **"TRANSFER"** button
2. In the popup that appears, select the platform. By default, the current platform is shown ([www.aisuru.com](http://www.aisuru.com) or your [PaaS](/en/paas.md) address)
3. Enter the recipient's username or email
4. Confirm the operation by typing the exact name of the Agent (case sensitive)
5. Click "Transfer" to complete the operation

{% hint style="danger" %} <mark style="color:red;">Once transferred, the Agent will no longer be accessible from your account.</mark> <mark style="color:red;">**If you want to keep managing it, you'll need to be**</mark> [<mark style="color:red;">**invited as an author**</mark>](/en/advanced-features/user-management/inviting-and-managing-authors.md) <mark style="color:red;">by the user you transferred it to.</mark>
{% endhint %}

Important notes on transfer:

* If you enter a username that doesn't exist or an email not associated with any account, the transfer will fail and you'll keep ownership of the Agent
* The transfer is irreversible: once complete, only the new owner can manage the Agent

### Deleting the Agent

To permanently delete an Agent:

1. Click the "DELETE" button
2. In the confirmation popup, type the exact name of the Agent (case-sensitive)
3. Click "Delete" to confirm

{% hint style="danger" %} <mark style="color:red;">Once deleted, the Agent</mark> <mark style="color:red;">**cannot be recovered in any way**</mark><mark style="color:red;">.</mark>
{% endhint %}

Before proceeding with deletion, consider:

* **Making a backup** of the content if you want to keep it
* **Verifying that no other user or service depends on this Agent**
