URL: https://help.carbonvoice.app/ai-agents/managing-an-agent
Source: https://raw.githubusercontent.com/PhononX/carbon-voice-docs/main/docs/ai-agents/managing-an-agent.md

# Managing an agent

Open **AI Agents**, tap an agent, and go to its settings.

## Name, picture and voice

- **Name** — tap to edit. Changing it doesn't change the username.
- **Username** — how people @mention and find the agent. Tap to copy it.
- **Picture** — tap the avatar to replace it, the same as your own profile picture.
- **Voice** — which text-to-speech voice the agent uses when someone plays back a message
  it sent as text.

## Details

The settings screen also shows the **Agent ID**, the **Creator ID**, and when the agent was
created and last updated. The Agent ID is what you'll need if you're wiring things up
against the API by hand.

## Tokens and webhooks

**Manage tokens** and **Webhook subscriptions** live here too. See
[Connect your agent](https://help.carbonvoice.app/ai-agents/connect-your-agent) for what they do and how to create them.

Revoking a token stops it working immediately, which is the fastest way to cut off an agent
that's misbehaving without deleting anything.

## Retiring an agent

When an agent has served its purpose, tap **Retire Agent** in its settings.

> Retiring is permanent. The agent's access stops immediately and it can't be brought back.
> Its conversations remain, but nothing can post as that agent again.

If you only want to pause an agent, revoke its tokens instead. That stops it acting while
leaving the account in place.

## Related

- [Connect your agent](https://help.carbonvoice.app/ai-agents/connect-your-agent)
- [Talk to your agent](https://help.carbonvoice.app/ai-agents/talk-to-your-agent)