> 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.

If the import fails (e.g., corrupted zip file or an Agent name that already exists), the top-right notification will show "Import failed".

### How to import the CSV file

To import the CSV file into an Agent:

### 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" %}
Once transferred, the Agent will no longer be accessible from your account. **If you want to keep managing it, you'll need to be** [**invited as an author**](/en/advanced-features/user-management/inviting-and-managing-authors.md) by the user you transferred it to.
{% 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" %}
Once deleted, the Agent **cannot be recovered in any way**.
{% 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**.
