# Connection and Agent Statuses

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.

***

### 📖 Key Concepts

* **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.

:bulb: *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.

***

### 🔗 Connection Statuses

A Connection has one of four statuses.

| Status            | Meaning                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------- |
| **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.                                                         |

***

### 🤖 Agent Statuses

An Agent has one of three statuses.

| Status            | Meaning                                                    |
| ----------------- | ---------------------------------------------------------- |
| **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.        |

***

### Related Concepts

* [The Three Actors](/docs/ai-agent-access/concepts/the-three-actors.md): Connections and Agents in the User-Agent-Connection model
* [Roles and Permissions](/docs/ai-agent-access/concepts/roles-and-permissions.md): what Admins and Members can do


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.cakewalk.security/docs/ai-agent-access/concepts/connection-and-agent-statuses.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.