Authorization: Bearer <jwt_token>

POST /api/auth/register
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "strong_password",
  "name": "Full Name"
}

POST /api/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "password"
}

GET /api/auth/github   # Redirects to GitHub OAuth
GET /api/auth/google   # Redirects to Google OAuth

GET /api/categories

GET /api/categories/{category_id}

GET /api/categories/{category_id}/prompts

GET /api/search?q=query

GET /api/skills
Authorization: Bearer <token>

GET /api/skills/{skill_id}
Authorization: Bearer <token>

GET /api/skills/search?q=query
Authorization: Bearer <token>

GET /api/user/me
Authorization: Bearer <token>

GET /api/user/subscription
Authorization: Bearer <token>

GET /api/user/favorites
POST /api/user/favorites {"prompt_id": "uuid"}
DELETE /api/user/favorites/{prompt_id}
Authorization: Bearer <token>

POST /api/user/tokens
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "My Dev Machine",
  "expires_in_days": 90
}

GET /api/user/tokens
Authorization: Bearer <token>

DELETE /api/user/tokens/{token_id}
Authorization: Bearer <token>

GET /api/optimizer/modes

POST /api/optimizer/optimize
Authorization: Bearer <token>
Content-Type: application/json

{
  "prompt": "Original prompt text",
  "mode": "enhance"
}

GET /api/optimizer/history
Authorization: Bearer <token>

POST /api/payments/checkout
Authorization: Bearer <token>
Content-Type: application/json

{
  "tier": "starter" | "pro" | "lifetime"
}

POST /api/payments/paypal/checkout
Authorization: Bearer <token>
Content-Type: application/json

{
  "tier": "lifetime"
}