Authentication

User authentication operations

Register New User

post

Creates a new user account. Admin registration requires whitelisted email.

Body
emailstring · email · max: 50Required

User's email address

passwordstring · min: 8Write-onlyRequired

User's password

rolestring · enumOptional

User role (optional for registration)

Possible values:
Responses
post
/auth/register

Login User

post

Authenticates a user and returns tokens.

Body
emailstring · email · max: 50Required

User's email address

passwordstring · min: 8Write-onlyRequired

User's password

rolestring · enumOptional

User role (optional for registration)

Possible values:
Responses
200

Login successful. Sets refreshToken cookie.

application/json
post
/auth/login

Refresh Access Token

post

Generates a new access token using the refresh token cookie.

cookie
refreshTokenstring · jwtRequired

HTTP-only refresh token cookie.

Responses
200

Access token refreshed successfully.

application/json
post
/auth/refresh-token

Logout User

post

Invalidates the refresh token and clears the cookie. Requires both access and refresh tokens.

Authorizations
AuthorizationstringRequired

JWT Access Token obtained via login/register/refresh

cookie
refreshTokenstring · jwtRequired

HTTP-only refresh token cookie.

Responses
200

Logout successful. Clears refreshToken cookie.

application/json
post
/auth/logout

Last updated

Was this helpful?