# Export and import an agent as a file

> Back up an agent's settings as a JSON file and transfer them to another agent. What the file contains and what happens on import.

Source: https://docs.qutee.ai/en/agenten/agent-exportieren-importieren/

You can download an agent's settings as a file and upload them into another agent. This helps if you want to use a well set-up agent as a template for another location, or back up a state before larger changes.

The file is a JSON file. You don't need to edit it. If you know JSON, you can also change texts in it directly.

## Before you start

- You need the **Company Admin** role. With the **User** role you don't see the **Agents** area.
- For the import you need an existing agent to load the file into. The import doesn't create a new agent. We set up new agents and phone numbers for you; write to [hey@qutee.ai](mailto:hey@qutee.ai).

## What the file contains

| In the file | Not in the file |
| --- | --- |
| From the **Personality** tab: name, internal note, role, task, persona, **Default greeting**, **Scheduled greetings**, organization, organization description, additional instructions and the **Voice** | **Phone number** |
| Whether the agent is active | From the **Availability** tab: timezone, **Activity schedule**, behavior outside activity hours and the notification settings |
| All actions of type **Forwarding**, **FAQ** and **Information capture**, with their schedules and the email recipients of the information capture | Actions of type **Appointment booking** |
| | **Silence detection**, greeting speed and the settings for several languages |

The file contains phone numbers from your forwardings and email addresses of your recipients. Only share it with people who are allowed to see this data.

## Export an agent

1. Open **Agents** and select the agent at the top.
2. To the right of the tabs, click the download icon (**Download agent**).

Your browser downloads a file with a name like `qutee-ai_agent_Reception_2026-11-11_14-30-00.json`. The app shows, for example, **Agent "Reception" downloaded successfully.**

## Import an agent

Before anything changes, the import shows you what it would change on the agent. You decide for each change whether it is applied.

1. Open **Agents** and select the agent you want to load the file into at the top.
2. To the right of the tabs, click the upload icon (**Upload agent**).
3. Choose the JSON file.
4. The **Review import** window lists every change with **Before** and **New**. Everything is ticked. Untick anything you do not want to apply.
5. Click **Apply changes** (the button names the number, for example **Apply 3 changes**).

The app shows **Agent uploaded successfully. Data will be refreshed.** and reloads the page. If the file already matches the agent, the app shows "The file matches the current agent. There is nothing to change." and nothing happens.

> **Tip:** Before the import, qutee saves the current state. If you don't like the result, restore the old state in the [agent history](https://docs.qutee.ai/en/agenten/verlauf-und-wiederherstellen/).

### What happens on import

- The fields from the **Personality** tab get the values from the file, as far as you leave them ticked.
- Whether the agent is active can also come from the file. If it is in the list, check the **Agent active** switch in the **Availability** tab after the import.
- Forwardings, FAQs and information captures are matched by their name: an action with the same name is updated, new ones are added. Actions of these three kinds that are not in the file are listed as **Removed** and are ticked. Untick them if they should stay.
- The phone number, the other settings in the **Availability** tab, **Appointment booking** actions and the selected email templates stay as they are.
- If the file names a voice that isn't unlocked for your company, the import proposes the default voice. Check the **Voice** after the import.

## If the import is rejected

If the file doesn't meet the agent editor's rules, the app shows the **Import not possible** window with the file name and a list of the entries that don't fit. For each entry it shows where it is, what is wrong and the path in the JSON file. Nothing was changed on the agent in that case.

Common reasons:

- **The file is not valid JSON.**: The file was damaged while editing, for example a comma or a bracket is missing. Export the agent again or check the position shown.
- **Too long**: A text exceeds the allowed length. The message tells you by how many characters to shorten it.
- **Not a valid phone number**: Numbers from Germany, Austria or Switzerland in the format +491711234567 are allowed.
- **This file version is not supported.**: The file doesn't come from the export or is outdated. Export the agent again.

Correct the file, close the window with **Close** and upload it again.

## Check that it works

1. Go through the **Personality** and **Action** tabs and check whether texts and actions are right.
2. In the **Availability** tab, check the **Agent active** switch.
3. Call the agent's number and make a short test call.

## Next steps

- [Check and test your agent](https://docs.qutee.ai/en/erste-schritte/agenten-pruefen-und-testen/)
- [Undo changes to an agent](https://docs.qutee.ai/en/agenten/verlauf-und-wiederherstellen/)
- [Set your agent's voice and speaking pace](https://docs.qutee.ai/en/agenten/stimme-und-sprechtempo/)
