signup
Register a new user account. Sends a verification email to the provided address.Input Parameters
Valid email address (5-40 characters)
Password (8-24 characters). Must contain:
- At least one uppercase letter
- At least one lowercase letter
- At least one number
- At least one special character (!@#$%^&*()_+-=[];’:”|,.<>/?)
Response
Confirmation message asking user to check their email
The email address that was registered
verifyEmail
Verify a user’s email address using the token sent via email.Input Parameters
Verification token from the email
Response
JWT authentication token (expires in 1 hour)
resendVerification
Resend the email verification link to a user.Input Parameters
Email address to resend verification to
Response
Confirmation message (doesn’t reveal if account exists for security)
login
Authenticate with email and password.Input Parameters
User’s email address
User’s password
Response
JWT authentication token (expires in 1 hour)
Error Codes
NOT_FOUND- User not found or invalid credentialsFORBIDDEN- Email not verified yetUNAUTHORIZED- Invalid password
githubAuth
Authenticate using GitHub OAuth.Input Parameters
Authorization code from GitHub OAuth flow
Optional state parameter for CSRF protection
Response
JWT authentication token (expires in 1 hour)
me
Get the authenticated user’s profile information.This endpoint requires authentication.
Response
User’s unique identifier
User’s email address
User’s display name
URL to user’s avatar image