Admin Key
Open in CMSEvery agent can have an Admin Key — a secret that unlocks admin-level debug commands inside a chat session. This page explains what it's for and where to manage it now that it has moved out of the agent's own Availability page.
Who can manage the Admin Key? Only Owner and Admin, at the organization level.
What the Admin Key is for
The Admin Key is an operational, support-oriented credential — not an access-control setting. Whoever knows it can type debug commands into a live chat session (for example, to inspect the conversation's raw context) without those commands being treated as normal user input.
It has nothing to do with who is allowed to chat with the agent — that's what Availability and Required Login control instead.
Why this moved to Organization
The Admin Key used to live on the agent's own Availability page, next to Required Login. Bundling it there mixed two different concerns: Availability is about who may enter a conversation, while the Admin Key is a support credential. Splitting them makes Availability a cleaner "who can access this agent" page, and puts the credential where operational/support responsibility already sits — with the organization's Admins and Owners.
Where to find it
Open the Organizations page → select your organization → Manage (gear icon) on the agent's card → Admin Key tile (Set admin key).
Managing the key
The Admin key dialog has one field and a Save button:
| Action | What it does |
|---|---|
| Set / Replace | Type a new key and click Save. It replaces any key stored before. |
| Remove | Leave the field empty and click Save. Admin debug commands stop working for this agent until a new key is set. |
The field always opens empty: the stored key is never shown again, so keep a copy where your support team can find it.
Treat the Admin Key like any other credential: share it only with people who need it for support, and rotate it if you suspect it has leaked.
Next step
Return to Agents in an Organization to manage agents, or see Deleting an Agent for the other action that moved here.