> ## Documentation Index
> Fetch the complete documentation index at: https://swapnice.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connection sessions

> Short-lived sessions that link a partner customer to a Swapnice account.

Create a session, open `connection_url` for the user, and poll until `authorized` or `completed`. Sessions expire. `DELETE` cancels an unused session.

This is the Plaid-Link-style step. You do not need the user's global Swapnice id to start.

## Endpoints in this group

| Method   | Path                                                                                 | Scope               |
| -------- | ------------------------------------------------------------------------------------ | ------------------- |
| `POST`   | [`/v1/connection-sessions`](/partners/api-reference/connections-create)              | `connections:write` |
| `GET`    | [`/v1/connection-sessions/{session_id}`](/partners/api-reference/connections-get)    | `connections:read`  |
| `DELETE` | [`/v1/connection-sessions/{session_id}`](/partners/api-reference/connections-delete) | `connections:write` |

Statuses: `created`, `authorized`, `completed`, `expired`, `revoked`.

After the user accepts, record a [consent receipt](/partners/api/consent). Narrative: [consent and account linking](/partners/consent).