---
title: "POST /v1/oauth/session-handoff"
method: POST
path: "/v1/oauth/session-handoff"
tags: ["OAuth"]
---

# POST /v1/oauth/session-handoff

`POST /v1/oauth/session-handoff`

Create a one-time OAuth consent handoff from an authenticated user session

## Request body

- object
  - `clientId` string, required
  - `redirectUri` string, required
  - `scopes` string[], required
  - `codeChallenge` string
  - `resource` string, required

## Response `200`

Default Response

- object
  - `handoff` string
  - `expires_in` number

## Other responses

- `401` — Default Response

## Changes

- **2026-08-20** `6fe5e0368cb0` — 6 info
  - added the new `files:read` enum value to the request property `scopes/items/`
  - added the new `files:write` enum value to the request property `scopes/items/`
  - added the new `host:pair` enum value to the request property `scopes/items/`
  - added the new `print-jobs:read` enum value to the request property `scopes/items/`
  - …2 more
- **2026-07-26** `750c8a136307` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/oauth/session-handoff/post.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/daa5509d053e/schema)