> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brilo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rename or delete an agent

> Rename a Brilo agent, understand what deleting one actually removes, and know what to do instead when you only want it to stop answering calls.

Both live in the **Configure** tab. Renaming is safe and instant. Deleting is permanent, and most of
the time it is not what you actually want, so this page covers the alternative first.

## Before you start

* An agent. See [Create your first agent](/agents/create-your-first-agent).
* One minute to rename. Five minutes to think before you delete.
* If you are deleting, check what is attached to the agent first: phone numbers, campaigns, and
  anything pointing a webhook at it.
* You will be working in your agent's **Configure** tab.

## Rename an agent

<Steps>
  <Step title="Open the Configure tab">
    Open your agent and go to **Configure**. **Name** is the first field under **Agent Information**.
  </Step>

  <Step title="Type the new name and save">
    The name is for you, not for callers. Your agent never says it. What callers hear is your greeting.
    See [Set your greeting](/agents/set-your-greeting).
  </Step>
</Steps>

Name agents after the job they do rather than the product, because you will end up with several. "After
hours cover" and "Reception, main line" tell you which is which at a glance. "Agent 2" does not.

## Turn it off instead of deleting it

If your goal is "stop this answering calls", do not delete it. Take it off the air and keep it:

* **Detach the phone number.** No number, no calls, and the agent and all its setup stay put. See
  [Assign a number to an agent](/phone-numbers/assign-a-number-to-an-agent).
* **Turn the agent off.** See [Turn your agent on](/go-live/turn-your-agent-on).
* **Pause the campaign** if it only makes outbound calls. See
  [What is a campaign](/campaigns/what-is-a-campaign).

All three are reversible in seconds. Deleting is not reversible at all.

## Delete an agent

<Warning>
  Deleting an agent permanently removes its personalised data, voice profile, and integrations. There is
  no undo and support cannot restore it.
</Warning>

<Steps>
  <Step title="Detach anything attached to it">
    Move or release its phone number, and stop any campaign using it. Deleting an agent that is still
    handling live calls means those calls have nowhere to go.
  </Step>

  <Step title="Save anything you want to keep">
    Copy the instructions out into a document if there is wording you worked hard on. Your knowledge
    files live in your workspace rather than on the agent, so those survive.
  </Step>

  <Step title="Open the High Risk Zone">
    Scroll to the bottom of the **Configure** tab. **High Risk Zone** is the last block on the page.
  </Step>

  <Step title="Delete and confirm">
    Click delete and confirm in the dialog. The agent disappears from your agent list immediately.
  </Step>
</Steps>

## What deleting does and does not remove

**Removed with the agent:** its instructions, its configuration, its voice and language choices, its
actions, and its integrations.

**Kept in your workspace:** your call history and recordings for calls that already happened, your
contacts, your knowledge files, and your phone numbers. A deleted agent does not take your call
records with it, and it does not release your numbers.

## If it did not work

**Delete is greyed out or fails.** Something is still attached. Detach the phone number and stop any
running campaign, then try again.

**You deleted the wrong agent.** It cannot be restored. Rebuild it from your call recordings and any
copy of the instructions you kept, and check whether an agent version exists that you can copy from.
See [Save and switch agent versions](/agents/versions).

**Calls are failing after a delete.** A number is still pointing at the agent you removed. Point it at
a live agent. See [Assign a number to an agent](/phone-numbers/assign-a-number-to-an-agent).

**You wanted to stop calls, not lose the setup.** Detach the number instead. See the section above.

## FAQ

<AccordionGroup>
  <Accordion title="Can I undo deleting a Brilo agent?">
    No. Deleting is permanent and support cannot restore it. If you only want the agent to stop
    answering, detach its phone number or turn it off instead, both of which are reversible.
  </Accordion>

  <Accordion title="Do callers ever hear my agent's name?">
    No. The name is a label in your dashboard. What callers hear is your greeting and your
    instructions. See [Set your greeting](/agents/set-your-greeting).
  </Accordion>

  <Accordion title="What happens to my call history if I delete the agent?">
    It stays. Recordings, transcripts, and call records for calls that already happened remain in your
    workspace, along with your contacts and knowledge files.
  </Accordion>

  <Accordion title="Do I lose my phone number when I delete an agent?">
    No. The number belongs to your workspace, not the agent, so it stays yours and can be pointed at a
    different agent. See
    [Assign a number to an agent](/phone-numbers/assign-a-number-to-an-agent).
  </Accordion>

  <Accordion title="How do I stop my agent answering calls without deleting it?">
    Detach its phone number, or turn the agent off. Either takes seconds and leaves every bit of your
    setup intact, which is what you want if there is any chance you will switch it back on.
  </Accordion>

  <Accordion title="Does deleting an agent affect my plan or billing?">
    Your plan stays as it is. Deleting an agent frees an agent slot on plans that limit how many you
    can run. See [Cancel or change your plan](/account/cancel-or-change-your-plan).
  </Accordion>
</AccordionGroup>

## Related

* [Turn your agent on](/go-live/turn-your-agent-on) to take it off the air reversibly
* [Assign a number to an agent](/phone-numbers/assign-a-number-to-an-agent) to detach the number
* [Save and switch agent versions](/agents/versions) to keep a copy before big changes
* [Set your greeting](/agents/set-your-greeting) for what callers actually hear
* [Cancel or change your plan](/account/cancel-or-change-your-plan) for agent limits