---
title: connection operations
---

The exact fields each `connection.*` operation takes and returns.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Every op is `POST /v1/<op>` over HTTP and the MCP tool `loom_<op>`. The identity fields (`org`, `namespace`, `agent`, `user_id`, `session_id`) are filled from the token and the MCP session when a transport can; for an HTTP call with no token on a single-user server, the install's org on every op but `code.*` and `tracker.*` (which keep their plane's), and on [some ops](/docs/pt-BR/reference/http-api#request) its namespace and agent; see [identities and namespaces](/docs/pt-BR/concepts/identities-and-namespaces). The [operations index](/docs/pt-BR/reference/operations) explains role, kind and the MCP `all` listing. Unknown input fields are served and named in `ignored_args`.

<!-- prettier-ignore-start -->

## `connection.disconnect`

Disconnect the caller's own provider account and stop its connected sources.

`POST /v1/connection.disconnect` · MCP `loom_connection_disconnect` · role `viewer` · idempotent · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The caller's organization. |
| `kind` | `Literal['gdrive', 'notion', 'linear']` | required | The connected provider to disconnect. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `disconnected` | `bool` |  |

## `connection.list`

List the signed-in caller's own connected provider accounts.

`POST /v1/connection.list` · MCP `loom_connection_list` · role `viewer` · read · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The caller's organization. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `connections` | `list[ConnectionEntry]` |  |

<!-- prettier-ignore-end -->
