v1.0.0

Auth service

Authentication service API

---

Default

Operations

POST/auth/loginPOST/auth/registerPOST/auth/refreshPOST/auth/validatePOST/auth/forgot/:emailPOST/auth/reset

---

Authenticate a user

POST

/auth/login

User login

Request Body

application/json

{

"email": "string",

"password": "string"

}

Responses

User logged in successfully

Content-Type

application/json

{

"accessToken": "string",

"id": "string",

"email": "string",

"name": "string"

}

POST

/auth/login

Playground

Body

Samples

cURL

JavaScript

PHP

Python

---

Register a new user

POST

/auth/register

User registration

Request Body

application/json

{

"email": "string",

"name": "string",

"password": "string"

}

Responses

User registered successfully

Content-Type

application/json

{

"accessToken": "string",

"id": "string",

"email": "string",

"name": "string"

}

POST

/auth/register

Playground

Body

Samples

cURL

JavaScript

PHP

Python

---

Refresh the access token using refresh token

POST

/auth/refresh

Refresh user token

Responses

Token refreshed successfully

Content-Type

application/json

{

"token": "string"

}

POST

/auth/refresh

Playground

Samples

cURL

JavaScript

PHP

Python

---

Check if the token is valid

POST

/auth/validate

Validate user token

Request Body

application/json

{

"token": "string"

}

Responses

Token validated successfully

Content-Type

application/json

{

"user": {

"id": "string",

"email": "string",

"name": "string"

}

}

POST

/auth/validate

Playground

Body

Samples

cURL

JavaScript

PHP

Python

---

Send password reset link

POST

/auth/forgot/:email

Forgot password

Parameters

Path Parameters

email*

Typestring

Required

formatemail

Responses

Password reset link sent

POST

/auth/forgot/:email

Playground

Variables

Key

Value

email*

Samples

cURL

JavaScript

PHP

Python

---

Reset the user password

POST

/auth/reset

Reset password

Request Body

application/json

{

"token": "string",

"password": "string"

}

Responses

Password reset successfully

POST

/auth/reset

Playground

Body

Samples

cURL

JavaScript

PHP

Python

---

Powered by VitePress OpenAPI