---
title: "Preview what a connection transfer would touch"
method: GET
path: "/connection/{id}/transfer-preview"
tags: ["Connections"]
---

# Preview what a connection transfer would touch

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

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/connection/{id}/transfer-preview`
- Auth: HTTP bearer

Previews what `POST /connection/{id}/transfer` would break, before anything is written, so you can show the consequence while the decision is still open. It is a summary, not a list: exact counts plus at most five named toolboxes, breaking ones first, so it takes no `limit` or `cursor`. Gated on exactly what the transfer itself is gated on, so it never advertises something that would 403.

## Path parameters

- `id` string, required

## Headers

- `X-Organization-Id` string

## Response `200`

OK

- object
  - `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` object[]: At most five, breaking ones first. A preview — read the counts, not this length.
    - `toolbox_id` string
    - `toolbox_name` string
    - `kind` '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.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/elaichi/apis/elaichi-api.md) · [All operations](https://skmtc.dev/elaichi/apis/elaichi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elaichi/apis/elaichi-api/revisions/b22cfb7b6d15?raw)