Get a link token to start an OAuth or Cloud Link connection
First step of an OAuth flow: returns a short-lived token scoped to the member + provider. Pass the token to `GET /v1/devices/{slug}/oauth-url` (for the standard OAuth redirect flow) or to a hosted link UI (for Cloud Link).
Authorization
MemberBearer Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.
In: header
Path Parameters
uuidHeader Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/devices/auth/token" \ -H "Content-Type: application/json" \ -d '{ "provider_slug": "string", "redirect_uri": "string" }'{
"data": {
"token": "string",
"expires_at": "2019-08-24T14:15:22Z"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Register a native health platform (Apple Health / Health Connect)
Called after the partner's app obtains OS-level health permissions. Creates the user link with the underlying health-data service and triggers the historical backfill. Partners poll `GET /v1/users/{user_id}/devices/{provider_slug}/status` to track backfill completion.
OAuth provider callback (per-user) — server-side proxy to Junction
Browser-redirect target after the user authorizes at the provider. Per plan §6.0, coach proxies to Junction's `/v2/link/connect/{slug}` server-side and mirrors Junction's response so junction.com never appears in the user's URL bar.