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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/en/advanced-features/backup-transfer-and-deletion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.