---
title: "Start Link"
method: POST
path: "/auth/link/{provider}"
---

# Start Link

`POST /auth/link/{provider}`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/auth/link/{provider}`
- Auth: none declared

Start linking `provider` to the signed-in account. Needs a sign-in within the last 10 minutes, on
the callback host (409 `wrong_host` elsewhere, with the URL to go to). Returns `{url}` — the SPA
navigates the browser there (a top-level navigation, so the provider redirect is not a form action),
and the cookie set here proves it is the same browser, at the hand-off and again at the callback.

## Path parameters

- `provider` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)