# Api:Authentication

**Page:** api/api-authentication

[Download Raw Markdown](./api/api-authentication.md)

---

## API Endpoints Summary

- **POST** `/api/v1/users/auth/login` — Login with username and password
- **POST** `/api/v1/users/auth/refresh` — Refresh access token
- **GET** `/api/v1/users/auth/me` — Get current user profile
- **POST** `/api/v1/users/auth/logout` — Logout
- **POST** `/api/v1/auth/signup` — Sign up with email and password
- **POST** `/api/v1/auth/verify-email` — Verify email address
- **POST** `/api/v1/auth/resend-verification` — Resend verification email
- **POST** `/api/v1/auth/forgot-password` — Request password reset
- **POST** `/api/v1/auth/reset-password` — Reset password
- **GET** `/api/v1/auth/available-regions` — Get available server regions
- **GET** `/api/v1/auth/github` — Redirect to GitHub OAuth
- **GET** `/api/v1/auth/github/callback` — GitHub OAuth callback
- **GET** `/api/v1/auth/google` — Redirect to Google OAuth
- **GET** `/api/v1/auth/google/callback` — Google OAuth callback

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```