---
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

---

[API](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api.md) · [All operations](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollen-robotics/reachy-mini-rest-api/versions/9843f2902e88/schema)