> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/operate/connections/inside-a-connection.md).

# Inside a connection

The connection detail page: who and what the connection is, its token and activity, Reconnect, and Disconnect.

`/integrations/connections/<connection-id>`. Click a row on the [Connections](https://docs.fastn.ai/operate/connections.md) page to open it.

### Header

The connector's name and icon, the connection's name (for example `Default`), its **status** badge and a one-line explanation of the status, for example *Authorised, but the credential has expired. Reconnecting usually clears it.* **Reconnect** (top right) repairs the connection. The **←** arrow returns to the list.

### Connection

| Field             | Meaning                                                                                                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Customer**      | *The customer this credential belongs to.* For your own connections, this is your organization.                                                                                           |
| **Connector**     | *Opens the connector this connection uses.* Click it to go to the [connector detail page](https://docs.fastn.ai/build/integrations/connectors/inside-a-connector.md).                     |
| **Auth method**   | How the connection was authorized, for example **OAuth 2.0** (*Your customer signed in and approved access.*). See [Auth types](https://docs.fastn.ai/operate/connections/auth-types.md). |
| **Scope**         | **Account level**: *Shared across your whole workspace rather than one project.*                                                                                                          |
| **Connection ID** | *Pass this to the API to act as this customer.* The copy button copies it.                                                                                                                |

### Token and activity

| Field              | Meaning                                                                                                                                                                                                                                                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Expires**        | How long until the current credential expires, with the date (for example *3 days* and the date). *fastn renews this automatically before it runs out.* Once the date has passed, it reads *Expired* with the date. For connections that are not OAuth, it reads *Not applicable*; for an OAuth token with no expiry, *Does not expire*. |
| **Last refreshed** | *The last time fastn renewed this credential.*                                                                                                                                                                                                                                                                                           |
| **Last used**      | When a call last went through this connection, or *Never*.                                                                                                                                                                                                                                                                               |
| **Created**        | *When your customer authorised it.*                                                                                                                                                                                                                                                                                                      |
| **Updated**        | *The last change to this connection record.*                                                                                                                                                                                                                                                                                             |

Use this panel to tell whether a refresh is still succeeding. An **Expires** date in the past together with an old **Last refreshed** date usually means the token could not be renewed, and the account has to sign in again.

### Recent activity

The latest calls made through this connection. **View all** opens [Activity](https://docs.fastn.ai/operate/operate.md) on its **Events** tab, which is not filtered to this connection. Until something has run, it reads *Nothing has come through this connection yet. Calls appear here as soon as your customer starts using it.*

### Reconnect

**Reconnect** (in the header, or in the row's **⋯** menu on the Connections page, alongside **Rename** and **Disconnect**) runs the sign-in again for the same connector and replaces the stored credential. Use it for `Expired` and `Failed` connections, or after the account's password or key changed.

### Disconnect

The last panel, **Disconnect this customer**, reads:

> Syncing stops immediately and the credential is deleted. Anything running against this connection stops working until it is connected again.

**Disconnect** asks for confirmation first:

Confirm only when the connection is no longer needed. Workflows and triggers that use it stop working until someone connects again. To fix a broken connection, use **Reconnect** instead.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fastn.ai/operate/connections/inside-a-connection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
