---
title: "R1's session hand-off: the daemon's stored pre-R1 session, for a one-time code the page redeems"
method: POST
path: "/v1/devices/session-handoff"
tags: ["devices"]
---

# R1's session hand-off: the daemon's stored pre-R1 session, for a one-time code the page redeems

`POST /v1/devices/session-handoff`

## Request

- Base URL: `https://api.sixminute.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sixminute.ai/v1/devices/session-handoff`
- Auth: HTTP bearer

A device route, and only under the credential the handover's exchange issued (any other is 409 `session-handoff-refused`, as is a device whose code was redeemed already). The refresh token is refreshed with WorkOS with the client secret: a refused token is 401, another person's 403, another firm's 403. Answers a code that works once, for a minute, at `POST /v1/auth/page/session-handoff`; a new code may be asked until one is redeemed. Nothing of the token is stored. Deleted at phase 7.

## Request body

- object
  - `refresh_token` string, required
  - `organization_id` string, nullable, required

## Response `201`

The code and when it stops working.

- object
  - `code` string, required
  - `expires_at` string, date-time, required

## Other responses

- `400`: The body, query or path did not validate; `errors` lists the fields.
- `401`: No bearer token, or one that does not verify or has expired.
- `403`: The token verified but may not do this: no organisation, not provisioned, wrong role, or a device problem.
- `409`: The id or the email already belongs to something else.
- `502`: An upstream this service depends on failed or answered nonsense.
- `503`: A capability this service was not configured with, or a practice system that could not be reached; the `type` says which.

---

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