---
title: "Begin Oauth"
method: GET
path: "/api/hf-auth/oauth/begin"
---

# Begin Oauth

`GET /api/hf-auth/oauth/begin`

One-shot OAuth entry point for the mobile setup flow.

Creates a session and 302-redirects the browser straight to Hugging Face's
authorize page, so the phone only has to open this single URL. The existing
/oauth/callback finishes the job (exchange → store token → start relay).

## Response `200`

Successful Response

- unknown

## Changes

- **2026-06-12** `c8e88388bc6b` — 1 info
  - endpoint added
- **2026-03-03** `8d430e48a90a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api/changes/api/hf-auth/oauth/begin/get.md)

---

[API](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api.md) · [All operations](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pollen-robotics/reachy-mini-rest-api/revisions/7f5f936a81cc/schema)