# Preview what a connection transfer would touch

> Source: https://elaichi.ai/docs/api-reference/connections/connection/previewconnectiontransfer/

`GET /connection/{id}/transfer-preview`

Resource: **Connection** · API: **Connections**

## Path parameters

- **`id`** _(string, required)_
  Connection id (`conn_…`).

## Response body

- **`affected_toolbox_count`** _(integer)_
  Exact number of toolboxes with an entry pinned to this connection.
- **`broken_delegation_count`** _(integer)_
  Exact number of the above that the CALLER pinned, and so the number at risk if they end up below `use`. Not narrowed by `keeps_access_without_retaining` — read the two together.
- **`affected_toolboxes`** _(array<object>)_
  At most five, breaking ones first. A preview — read the counts, not this length.
  - **`toolbox_id`** _(string)_
  - **`toolbox_name`** _(string)_
  - **`kind`** _(string)_
    Allowed: `toolbox`
  - **`breaks_without_retained_access`** _(boolean)_
    The outgoing owner pinned at least one of this toolbox's entries on the connection.
- **`keeps_access_without_retaining`** _(boolean)_
  The caller already reaches this connection through a grant of their own (org-wide, or a team they are in), so handing it over costs them nothing even without `retain_access` and nothing they pinned breaks. Computed server-side because `access: "owner"` outranks and hides whatever grant is underneath it — a client cannot derive this.

## Code examples

### curl

```bash
curl -X GET 'https://api.elaichi.ai/connection/<id>/transfer-preview' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
```

### JavaScript

```javascript
const response = await fetch('https://api.elaichi.ai/connection/<id>/transfer-preview', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
```

### Python

```python
import os
import requests

url = "https://api.elaichi.ai/connection/<id>/transfer-preview"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())
```