Suspend, deprecate or move an agent¶
Agents come and go. Stop one in an incident, retire one on a set day while its replacement takes over, or move one to the team that now runs it. Its keys follow its state, and what it did stays in the audit log.
Before you start¶
You're an admin of the team the agent belongs to (or an organisation admin). Owners can't change an agent's state or team.
Steps¶
- Open Applications & agents and choose the agent.
- Choose what to do:
- Change state › Suspended: its keys stop now. Change state › Active brings them back.
- Change state › Deprecated: it keeps working until a day you choose, then it's suspended automatically. It gets no new keys meanwhile, and its page says the day it's suspended.
- Move: to another team or the whole organisation. You need to be an admin of both.
- Delete: its keys are revoked for good, it leaves every application, and the roles on it end.
- Confirm.
Check it worked¶
The agent's header shows its state. Its keys say Its agent is suspended while it is. A deprecated agent with working keys is listed on Home's Needs attention, with how many keys and when it's suspended.
Good to know¶
- Moving an agent changes who pays for its next calls; past calls stay charged where they were.
- Deleting an agent can't be undone. What it did stays in the audit log.
- A caller using a suspended agent's key is refused by the gateway, and Request logs says what stopped it.