Connection and Agent Statuses
Connections and Agents each have their own status taxonomy. This page defines every status and what it means.
Last updated
Was this helpful?
Connections and Agents each have their own status taxonomy. This page defines every status and what it means.
Cakewalk Agent Access tracks two parallel status taxonomies. Connection statuses describe the health of a User's credential for a downstream app. Agent statuses describe an Agent's wiring to the MCP Gateway and recent activity.
Connection status: The health of one User's credential for one downstream app.
Agent status: The lifecycle state of an Agent in the org. Derived from session activity.
💡 Why this matters: Connection statuses tell you whether a User's credential for an app is usable. Agent statuses tell you whether an AI client is wired up and active. The two are independent. An Agent can be Active even if one of its Connections is in Error.
A Connection has one of four statuses.
Active
Authenticated and ready to use. Credential is in the vault.
Error
Token expired or sync failed. Reconnect to restore.
Paused
The User deliberately paused this Connection. Credential preserved; Agent access blocked until resumed.
Not Connected
The User has not authenticated to this app yet.
An Agent has one of three statuses.
Active
Agent is wired to the MCP Gateway and has recent sessions.
Inactive
No sessions in the last 30 days.
Not Connected
Pre-registered or never connected. No sessions yet.
The Three Actors: Connections and Agents in the User-Agent-Connection model
Roles and Permissions: what Admins and Members can do
Last updated
Was this helpful?
Was this helpful?