Admin Key

Open in CMS

Every 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:

ActionWhat it does
Set / ReplaceType a new key and click Save. It replaces any key stored before.
RemoveLeave 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.