---
title: "Start Oauth"
method: GET
path: "/api/hf-auth/oauth/start"
---

# Start Oauth

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

Start a new OAuth authorization session.

Returns the auth_url to redirect the user to HuggingFace.

Args:
    request: The incoming HTTP request.
    use_localhost: When True, use localhost:8000 as the OAuth callback URL.
        Passed by the desktop app which proxies localhost:8000 to the robot.

## Query parameters

- `use_localhost` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-08** `9865d8a46445` — 2 info
  - added the new optional `query` request parameter `use_localhost`
  - added the non-success response with the status `422`
- **2026-03-03** `8d430e48a90a` — 1 warning, 1 info
  - deleted the `query` request parameter `use_localhost`
  - removed the non-success response with the status `422`

[Change history](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api/changes/api/hf-auth/oauth/start/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)