{"info":{"_postman_id":"a3c8539f-0c9b-4a66-9435-bf4f64f75ba6","name":"Smart AI Jobber API","description":"

Smart AI Jobber is an AI recommendation system that helps users get the jobs they are qualified for without going through the stress and hassle of sifting through tons of irrelevant jobs.

Users can get AI recommendations straight to their emails. It uses MySQL with Sequelize ORM, JWT authentication, account verification, password recovery, job cache and rate limiter.EndFragment

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"45030267","collectionId":"a3c8539f-0c9b-4a66-9435-bf4f64f75ba6","publishedId":"2sB3WpQ11D","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-31T15:20:26.000Z"},"item":[{"name":"User / Admin Auth","item":[{"name":"Register User","id":"24a5c7c5-16f0-4576-87f7-59e9b77c0572","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Smart\",\r\n \"email\": \"ogbeuwa@gmail.com\",\r\n \"password\": \"1234567\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/register","description":"

Endpoint: POST /api/auth/register

Registers a new user by accepting their name, email, and password. On successful registration, an OTP (One-Time Password) is sent to the provided email address for verification.

Request Body

Content-Type: application/json
\n
Fields:
\n
- name (string, required): User's full name.
  \n
- email (string, required): User's email address. Must be unique.
  \n
- password (string, required): User's password (minimum requirements may apply).
  \n
\n

Sample Request Body:

{\n  \"name\": \"Smart\",\n  \"email\": \"ogbeuwa@gmail.com\",\n  \"password\": \"1234567\"\n}\n\n

Successful Response

Status: 201 Created
\n

Body:

      { \"message\": \"OTP sent to your email\" }\n\n

Error Responses

400 Bad Request:
\n
- Missing or invalid fields in the request body.
  \n
- Example: { \"error\": \"Email is required\" }
  \n
\n
409 Conflict:
\n
- Email already registered.
  \n
- Example: { \"error\": \"Invalid credentials\" }
  \n
\n

Usage Notes

The baseURL variable should be set in your environment to target the correct API server.
\n
After registration, the user must complete the OTP verification flow to activate their account.
\n
Ensure the email provided is accessible to receive the OTP.
\n

\n","urlObject":{"path":["api","auth","register"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"24a5c7c5-16f0-4576-87f7-59e9b77c0572"},{"name":"verifyOtp","id":"009cff31-272b-4db2-8f97-e5df2bdd6afa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"ogbeuwa@gmail.com\",\r\n \"otp\": \"986675\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/verify","description":"

Verify User Account

This POST request is used to verify a user's account by validating the provided email address and one-time password (OTP). It is typically called after a user registers or requests account verification, and has received an OTP via email.

Purpose

To confirm the user's identity and activate their account by verifying the OTP sent to their email address.

Request Body Parameters

email (string, required): The email address of the user to be verified. Example: user@example.com
otp (string, required): The one-time password sent to the user's email. Example: 123456

Example Request Body

{\n  \"email\": \"user@example.com\",\n  \"otp\": \"123456\"\n}\n

Expected Successful Response

Status Code: 200 OK
Response Body:
- On successful verification, the response will be:
```
Account verification was successful\n
```
\n

If the OTP is invalid or expired, an error response will be returned.

Endpoint: POST /api/auth/verify

\n","urlObject":{"path":["api","auth","verify"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"009cff31-272b-4db2-8f97-e5df2bdd6afa"},{"name":"resend otp","id":"ed280ad4-575e-4260-beb7-d8f880fa2f2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Matthew\",\r\n \"email\": \"ogbeuwa@gmail.com\",\r\n \"password\": \"1234567\"\r\n}"},"url":"/api/auth/send-otp","description":"

Purpose: Resend a one-time password (OTP) to the user’s email for verification purposes (e.g., during signup or login verification).

Method: GET

URL: /api/auth/send-otp

Required Params/Body:

Path params: none
Query params: none

Example Success Response:

Status: 201 Created
Body:\n{\n \"message\": \"OTP sent to your email\"\n}

Usage Notes:

Ensure the baseURL variable is set in your active environment.
This request is part of the \"User / Admin Auth\" folder in the \"Smart AI Jobber API\" collection.
If you intend to resend the OTP to a specific user, ensure the email value is correct and corresponds to an existing user/session state on the server.

\n","urlObject":{"path":["api","auth","send-otp"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"ed280ad4-575e-4260-beb7-d8f880fa2f2a"},{"name":"forgot password","id":"1705477e-c5ab-40e7-99cd-e7e977b12288","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"ogbeuwa@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/forgot","description":"

Initiates the password reset process by submitting the user’s email address. When a valid, registered email is provided, the server sends a password reset email to that address.

HTTP

Method: POST
URL: /api/auth/forgot

Request body

Content-Type: application/json
Schema: { \"email\": \"string\" }
Example:\n{\n \"email\": \"user@example.com\"\n}

Successful response

Status: 200 OK
Typical body:\n{\n \"message\": \"Password reset email has been sent to your email address.\"\n}

Notes

Ensure is set in your environment.

\n","urlObject":{"path":["api","auth","forgot"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"1705477e-c5ab-40e7-99cd-e7e977b12288"},{"name":"reset password","id":"fafab65c-4716-4a22-b0ed-22532927e70c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"ogbeuwa@gmail.com\",\r\n \"newPassword\": \"7654321\",\r\n \"otp\": \"545701\" \r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/reset","description":"

Password Reset (POST)

This endpoint allows a user to reset their account password using a one-time password (OTP) sent to their email address. It is typically used after the user initiates a 'forgot password' flow and receives an OTP.

Request URL

POST /api/auth/reset

Request Body Parameters

Send a JSON object in the request body with the following fields:

email (string, required): The email address associated with the user's account.
newPassword (string, required): The new password the user wishes to set.
otp (string, required): The one-time password sent to the user's email for verification.

Example Request Body:

{\n  \"email\": \"user@example.com\",\n  \"newPassword\": \"yourNewPassword123\",\n  \"otp\": \"123456\"\n}\n

Successful Response

Status Code: 201 Created

Response Body:

{\n  \"message\": \"Password reset was successful.\"\n}\n

Notes

Ensure the OTP is valid and has not expired.
If the OTP or email is invalid, an error response will be returned.

\n","urlObject":{"path":["api","auth","reset"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"fafab65c-4716-4a22-b0ed-22532927e70c"},{"name":"login","id":"ddd37126-4c94-4615-b5e1-379519c07ad1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"easydatabundle@gmail.com\",\r\n \"password\": \"1234567\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/login","description":"

Summary: Authenticate a user and return an access token and message.

Purpose: Use this endpoint to log users into the system using email and password credentials. Successful authentication returns a JSON response with a success message and (optionally) an access token to be used in subsequent authenticated requests.

Request URL and method: POST /api/auth/login

Path/Variable: baseURL - Base URL of the API environment (use the Beta or Production environment).

Headers:

Content-Type: application/json
Accept: application/json

Request body schema:\n{\"type\":\"object\",\"properties\":{\"email\":{\"type\":\"string\"},\"password\":{\"type\":\"string\"}},\"required\":[\"email\",\"password\"]}

Example request body:\n{\"email\":\"user@example.com\",\"password\":\"yourPassword123\"}

Expected responses:

200 OK\nExample: {\"message\":\"Login successful\"}

Notes:

Ensure Content-Type is application/json.

\n","urlObject":{"path":["api","auth","login"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"ddd37126-4c94-4615-b5e1-379519c07ad1"},{"name":"change password logged in users","id":"7a9be73a-c61b-4e11-83f8-5770baea57f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"oldPassword\": \"7654321\",\r\n \"newPassword\": \"0987654321\" \r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/change-password","description":"

Purpose\nChange the password for the currently authenticated user.

HTTP

Method: POST
URL: /api/auth/change-password
Auth: Typically requires token. Ensure the user is logged in.

Request Body (JSON)\n{\n \"oldPassword\": \"string\", // The user’s current password (required)\n \"newPassword\": \"string\" // The desired new password (required)\n}

Validation and Notes

Both fields are required.
newPassword should meet your server-side password policy (length/complexity/history/reuse rules).
On failure (e.g., wrong old password, policy violation), the API may return a 4xx response with an error message.

Successful Response

Status: 201 Created
Body:\n{\n\"message\": \"Password change was successful.\"\n}

Example\nRequest body:\n{\n \"oldPassword\": \"7654321\",\n \"newPassword\": \"0987654321\"\n}

Expected 201 response:\n{\n \"message\": \"Password change was successful.\"\n}

\n","urlObject":{"path":["api","auth","change-password"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"7a9be73a-c61b-4e11-83f8-5770baea57f8"},{"name":"logout","id":"5405f501-3b49-4645-b254-9be999c7289d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"ogbeuwa@gmail.com\",\r\n \"newPassword\": \"7654321\",\r\n \"otp\": \"545701\" \r\n}"},"url":"/api/auth/logout","description":"

Logout Endpoint

This endpoint logs out a user from the application and is typically used to terminate the user's session securely.

Request

Method: GET
URL: /api/auth/logout

Successful Response

Status Code: 200 OK
Response Body:
- message (string): Confirmation message indicating successful logout.
\n

Example Response:

{\n  \"message\": \"Log out successful.\"\n}\n

Notes:

This endpoint may be used as part of a password reset or security flow.

\n","urlObject":{"path":["api","auth","logout"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"5405f501-3b49-4645-b254-9be999c7289d"},{"name":"register admin","id":"b04643d7-d469-48e8-ac33-8fab12b52118","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Matthew\",\r\n \"email\": \"easydatabundle@gmail.com\",\r\n \"password\": \"1234567\",\r\n \"role\": \"admin\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/auth/register","description":"

Purpose\nRegister a new admin user in the system. This endpoint creates a user record and sends an OTP to the provided email address for verification. Use this endpoint during initial admin onboarding or when adding additional admin accounts.

Method and URL\nPOST /api/auth/register

Required headers

Content-Type: application/json (required)
Accept: application/json (optional)

URL variables

baseURL: Base URL of the API (set via environment). Example: https://api.example.com

Request body (JSON)\nExample\n{\n \"name\": \"Matthew\",\n \"email\": \"easydatabundle@gmail.com\",\n \"password\": \"strongP@ssw0rd\",\n \"role\": \"admin\"\n}

JSON schema\n{\n \"type\": \"object\",\n \"required\": [\"name\", \"email\", \"password\", \"role\"],\n \"properties\": {\n \"name\": { \"type\": \"string\", \"description\": \"Full name of the admin user\", \"example\": \"Matthew\" },\n \"email\": { \"type\": \"string\", \"format\": \"email\", \"description\": \"Admin's email address where OTP will be sent\", \"example\": \"easydatabundle@gmail.com\" },\n \"password\": { \"type\": \"string\", \"description\": \"Password for the account (min length 6)\", \"example\": \"strongP@ssw0rd\" },\n \"role\": { \"type\": \"string\", \"enum\": [\"admin\", \"user\"], \"description\": \"Role assigned to the account (must be 'admin' for this endpoint)\", \"example\": \"admin\" }\n }\n}

Successful response\nStatus: 201\nBody\n{\n \"message\": \"OTP sent to your email\"\n}

Error responses

400 Validation error - missing or invalid fields
\n
}
\n

\n","urlObject":{"path":["api","auth","register"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"f028916c-0073-4a20-91b9-c1143a35efcb","name":"Successful registration","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Matthew\",\"email\":\"easydatabundle@gmail.com\",\"password\":\"1234567\",\"role\":\"admin\"}"},"url":"/api/auth/register"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","enabled":true},{"key":"Accept","value":"application/json","description":"","enabled":true}],"cookie":[],"responseTime":null,"body":"{\"message\":\"OTP sent to your email\"}"}],"_postman_id":"b04643d7-d469-48e8-ac33-8fab12b52118"}],"id":"f7ed0983-3a33-43e0-a10c-b85ed3d6a3a3","_postman_id":"f7ed0983-3a33-43e0-a10c-b85ed3d6a3a3","description":""},{"name":"User Profile","item":[{"name":"create profile","id":"e6e375b8-3f36-4493-84b2-05ada6a986c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Abuja","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Nigeria","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (2).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/api/profile/create","description":"

Purpose:\nCreates a new user profile in the system.

HTTP Method & URL:

POST /api/profile/create
is a variable for the API base URL.

Required Headers:

Content-Type: multipart/form-data
`Authorization: \"token\" saved in cookies

Body Parameters (form-data):

skills (array of strings): List of skills. Example: [\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]
isRemotePreferred (boolean): Whether remote work is preferred. Example: true
job_titles (string): Desired job title(s). Example: Junior Web Developer
preferred_location (string): Preferred job location. Example: Abuja
country (string): Country of residence. Example: Nigeria
resume (doc file): Add resume file. Example: resume.pdf
profileImage (image file): Add profile image. Example: image.png

Expected Successful Response:

Status: 201 Created
Body Example:

{\n  \"title\": \"Profile Created\",\n  \"profile\": {\n    \"id\": \"<uuid>\",\n    \"skills\": \"[\\\"python\\\", \\\"React\\\", ...]\",\n    \"isRemotePreferred\": true,\n    \"job_titles\": \"Junior Web Developer\",\n    \"preferred_location\": \"Abuja\",\n    \"country\": \"Nigeria\",\n    \"resumeUrl\": \"http://localhost:3000/uploads/resume-...\",\n    \"profileImageUrl\": \"http://localhost:3000/uploads/profileIma...\",\n    \"userId\": 4,\n    \"updatedAt\": \"2025-10-31T12:23:56.239Z\",\n    \"createdAt\": \"2025-10-31T12:23:56.239Z\"\n  },\n  \"message\": \"Profile created successfully!\"\n}\n

Common Errors:

400 Bad Request: Missing or invalid fields in the request body.
401 Unauthorized: Missing or invalid token.
500 Internal Server Error: Server encountered an unexpected condition.

\n","urlObject":{"path":["api","profile","create"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"e6e375b8-3f36-4493-84b2-05ada6a986c3"},{"name":"get profile","id":"5105edd9-1492-4ace-a8eb-87f072e42e8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Abuja","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Nigeria","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (2).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/api/profile/","description":"

Get User Profile

This request retrieves the authenticated user's profile information from the API.

Endpoint: GET /api/profile/

Purpose

Use this endpoint to fetch the current user's profile details, including personal information, skills, job preferences, and associated resources such as resume and profile image URLs.

Typical Response Structure

A successful response (200 OK) returns a JSON object with the following structure:

{\n  \"title\": \"Your Profile\",\n  \"userProfile\": {\n    \"id\": 4,\n    \"name\": \"Smart\",\n    \"email\": \"ogbeuwa@gmail.com\",\n    \"role\": \"user\",\n    \"verified\": true,\n    \"createdAt\": \"2025-10-31T12:12:59.000Z\",\n    \"updatedAt\": \"2025-10-31T12:14:25.000Z\",\n    \"Profile\": {\n      \"id\": \"c406da8d-53fc-457e-9251-1b0fb3d7e6b8\",\n      \"skills\": \"[\\\"python\\\", \\\"React\\\", ...]\",\n      \"isRemotePreferred\": true,\n      \"job_titles\": \"Junior Web Developer\",\n      \"preferred_location\": \"Abuja\",\n      \"country\": \"Nigeria\",\n      \"resumeUrl\": \"http://localhost:3000/uploads/resume-...\",\n      \"profileImageUrl\": \"http://localhost:3000/uploads/profileIma...\",\n      \"createdAt\": \"2025-10-31T12:23:56.000Z\",\n      \"updatedAt\": \"2025-10-31T12:29:14.000Z\",\n      \"userId\": 4\n    }\n  }\n}\n

Key Fields

id, name, email, role, verified: Basic user info.
Profile: Nested object with skills, job preferences, resume/profile image URLs, and timestamps.

Usage Notes

Ensure authentication is set up as required by the API.
The response provides all profile details for the currently authenticated user.

\n","urlObject":{"path":["api","profile",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"5105edd9-1492-4ace-a8eb-87f072e42e8d"},{"name":"update profile","id":"c380d2c4-aa66-4c15-a591-15a3e4a74012","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Ottawa","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Canada","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (1).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/api/profile/update","description":"

Purpose:\nThis POST request updates the profile information of an existing user.

Endpoint:\nPOST /api/profile/update

Body Parameters (multipart/form-data):

skills (array of strings): List of the user's skills. Example: [\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]
isRemotePreferred (boolean): Indicates if the user prefers remote work. Example: true
job_titles (string): The user's job title(s). Example: Junior Web Developer
preferred_location (string): The user's preferred work location. Example: Ottawa
country (string): The user's country. Example: Canada
resume (doc file): Add resume file. Example: resume.pdf
profileImage (image file): Add profile image. Example: image/png

Successful Response (200 OK):\nReturns a JSON object containing:

title: Confirmation title (e.g., \"Profile Updated\").
message: Success message (e.g., \"Profile updated successfully!\").
profile: The updated profile object, including fields such as id, skills, isRemotePreferred, job_titles, preferred_location, country, resumeUrl, profileImageUrl, createdAt, updatedAt, and userId.

Example Response:

{\n  \"title\": \"Profile Updated\",\n  \"message\": \"Profile updated successfully!\",\n  \"profile\": {\n    \"id\": \"bc87efbc-9796-46a8-b657-aded08e22d4a\",\n    \"skills\": \"[\\\"python\\\", \\\"React\\\", \\\"Expressjs\\\", \\\"sql\\\", ...]\",\n    \"isRemotePreferred\": true,\n    \"job_titles\": \"Junior Web Developer\",\n    \"preferred_location\": \"Ottawa\",\n    \"country\": \"Canada\",\n    \"resumeUrl\": \"http://localhost:3000/uploads/resume-...\",\n    \"profileImageUrl\": \"http://localhost:3000/uploads/profileIma...\",\n    \"createdAt\": \"2025-10-31T11:54:36.000Z\",\n    \"updatedAt\": \"2025-10-31T12:09:01.693Z\",\n    \"userId\": 1\n  }\n}\n

\n","urlObject":{"path":["api","profile","update"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"c380d2c4-aa66-4c15-a591-15a3e4a74012"},{"name":"delete profile","id":"c5128942-fc24-4349-8a94-d342023f73f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Ottawa","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Canada","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (1).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/api/profile/delete","description":"

Purpose: Permanently delete the authenticated user's profile and associated profile data.

Method & URL: DELETE /api/profile/delete

Authentication: Requires a valid \"token\" in the cookies.

Expected Response:

200 OK {\"sucess\": true, \"message\": \"Account deleted successfully\"}

\n","urlObject":{"path":["api","profile","delete"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"c5128942-fc24-4349-8a94-d342023f73f4"}],"id":"8cdb786f-62bb-4c70-9d10-52e59377a8cc","_postman_id":"8cdb786f-62bb-4c70-9d10-52e59377a8cc","description":""},{"name":"Single Uploads (Resume / Profile Image)","item":[{"name":"upload resume","id":"8ed00959-6582-4573-b5b3-31cbd0660ff4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"resume","type":"file","uuid":"b98cf956-41c6-443b-bfff-8bed3f0132e5","src":"/C:/Users/USER/Downloads/ticket-SMFest Osazuwa.pdf"}]},"url":"/api/uploads/resume","description":"

Endpoint: POST /api/uploads/resume

Purpose:\nThis endpoint allows users to upload a resume file to the server.

Request Body:

Content-Type: multipart/form-data
Form Data:
- resume (file, required): The resume file to be uploaded. Supported formats typically include PDF, DOC, or DOCX.
\n

Example Request:

POST /api/uploads/resume\nContent-Type: multipart/form-data\n\nForm Data:\n  resume: <file>\n

Successful Response:

Status: 201 Created
Content-Type: application/json

Body:

{\n  \"message\": \"Resume uploaded successfully\",\n  \"resumeUrl\": \"http://localhost:3000/uploads/resume-<unique-id>\"\n}\n

Notes:

The resumeUrl in the response provides a direct link to the uploaded resume file.
Ensure that the resume field is included in the form data and contains a valid file.
Authentication is required

\n","urlObject":{"path":["api","uploads","resume"],"host":[""],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"8ed00959-6582-4573-b5b3-31cbd0660ff4"},{"name":"upload pofile image","id":"207de17c-e189-4209-b674-eab1ef0154a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"profileImage","type":"file","uuid":"af165a6b-a946-4599-9307-b9f5922daba3","src":"/C:/Users/USER/Downloads/score-card.png"}]},"url":"/api/uploads/profile-image","description":"

Purpose:\nUploads a user's profile image to the server.

URL:\nPOST /api/uploads/profile-image

Method:\nPOST

Required Form-Data Fields:

profileImage (file, required): The image file to upload as the user's profile picture.

Expected Responses:

201 Created

{\n  \"message\": \"ProfileImage uploaded successfully\",\n  \"profileImageUrl\": \"http://localhost:3000/uploads/profileImage.jpg\"\n}\n

Common Errors:

400 Bad Request: Missing or invalid file

\n","urlObject":{"path":["api","uploads","profile-image"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"207de17c-e189-4209-b674-eab1ef0154a2"}],"id":"f0af2adc-bd7b-4f79-b539-513abeccc135","_postman_id":"f0af2adc-bd7b-4f79-b539-513abeccc135","description":""},{"name":"Job Recommendations","item":[{"name":"recommend jobs","id":"f559e0c3-ec48-4d22-95a1-52d6a14383f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/api/recommend","description":"

Purpose:
This endpoint retrieves a list of recommended jobs tailored to the user's profile or preferences powered with AI.

Endpoint:
GET /api/recommend

Query Parameters:

No required or optional query parameters are explicitly documented. The endpoint uses the variable, which should be set in your environment.

Authentication:

User must be logged in with JWT token in cookies \"token\"

Expected Response:

On success (200 OK), returns a JSON object with:
\n
- success (boolean): Indicates if the request was successful.
  \n
- message (string): Status or informational message.
  \n
- jobs (array): List of recommended jobs. Each job object contains:
  \n
  - job_id (string): Unique identifier for the job.
    \n
  - title (string): Job title.
    \n
  - company (string): Company name.
    \n
  - location (string): Job location (may be empty).
    \n
  - link (string): URL to the job posting.
    \n
  - match_score (integer): Match score (0-100) indicating relevance.
    \n
  - reason (string): Explanation for the recommendation.
    \n
  \n
\n

Example Response:

{\n  \"success\": true,\n  \"message\": \"Job recommendations fetched successfully.\",\n  \"jobs\": [\n    {\n      \"job_id\": \"Z6d7dVef7rD01lS5AAAAAA==\",\n      \"title\": \"Junior Backend Developer (Python)\",\n      \"company\": \"MasterBorn\",\n      \"location\": \"\",\n      \"link\": \"https://up2staff.com/backend-developer-python\",\n      \"match_score\": 90,\n      \"reason\": \"Excellent match for 'Junior Web Developer' skills.\"\n    }\n    // ...more jobs\n  ]\n}\n\n

Example Use Case:
A user wants to see AI job recommendations based on their uploaded profile. This endpoint returns a curated list of jobs with match scores and reasons for each recommendation.

\n","urlObject":{"path":["api","recommend"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"f559e0c3-ec48-4d22-95a1-52d6a14383f3"}],"id":"17ca70bc-4534-46d7-a2a7-35d2b8a254c3","_postman_id":"17ca70bc-4534-46d7-a2a7-35d2b8a254c3","description":""},{"name":"Admin Actions","item":[{"name":"get all users","id":"a5db3b74-fc32-4343-b3be-daeb94e7a8a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Abuja","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Nigeria","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (2).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/admin/users","description":"

Purpose: Retrieve all user accounts for administrative review, including optional profile information.

Endpoint: /admin/users\nMethod: GET

Path params: None.\nQuery params: None (endpoint returns all users). If the API later supports filtering (e.g., ?role=admin&verified=true), document them here.

Authentication: Logged in admin account

Successful response (200) summary:\n{\n success: boolean,\n message: string,\n users: [\n {\n id: number,\n name: string,\n email: string,\n role: \"user\" | \"admin\" | string,\n verified: boolean,\n createdAt: ISODateString,\n updatedAt: ISODateString,\n Profile: null | {\n id: string,\n skills: string | string[],\n isRemotePreferred: boolean,\n job_titles: string,\n preferred_location: string,\n country: string,\n resumeUrl?: string,\n profileImageUrl?: string,\n createdAt: ISODateString,\n updatedAt: ISODateString,\n userId: number\n }\n }\n ]\n}

Common status codes:

200 OK: Users retrieved successfully.
401 Unauthorized: Missing/invalid token.
403 Forbidden: Authenticated but not authorized (requires admin).
500 Internal Server Error: Unexpected server error.

Usage notes:

No request body is needed for GET; remove or ignore body to avoid confusion.
Use environment variable baseURL to target different stages (local, staging, prod).

\n","urlObject":{"path":["admin","users"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"a5db3b74-fc32-4343-b3be-daeb94e7a8a8"},{"name":"get single user","id":"c8c01796-e41e-478b-a6fa-ac3b36138bb5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Abuja","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Nigeria","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (2).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/admin/users/4","description":"

Purpose:\nFetch details for a single user by their unique ID (admin access required).

Endpoint:\nGET /admin/users/:id

Path Parameter: id (integer) — The unique identifier of the user to retrieve. In this request, the value is 4.
Environment Variable: baseURL — The base URL for the API, set in your active environment.

Authentication:\nThis endpoint is restricted to admin users. Ensure you are authenticated as an admin

Expected 200 Response:\nReturns a JSON object with user details and a nested Profile object.

Response Shape:

{\n  \"success\": true,\n  \"message\": \"User detail retrieved\",\n  \"user\": {\n    \"id\": 4,\n    \"name\": \"Smart\",\n    \"email\": \"ogbeuwa@gmail.com\",\n    \"role\": \"user\",\n    \"verified\": true,\n    \"createdAt\": \"2025-10-31T12:12:59.000Z\",\n    \"updatedAt\": \"2025-10-31T12:14:25.000Z\",\n    \"Profile\": {\n      \"id\": \"...\",\n      \"skills\": \"[\\\"python\\\", \\\"React\\\", ...]\",\n      \"isRemotePreferred\": true,\n      \"job_titles\": \"Junior Web Developer\",\n      \"preferred_location\": \"Abuja\",\n      \"country\": \"Nigeria\",\n      \"resumeUrl\": \"...\",\n      \"profileImageUrl\": \"...\",\n      \"createdAt\": \"...\",\n      \"updatedAt\": \"...\",\n      \"userId\": 4\n    }\n  }\n}\n

Example Response Fields:

user.id — User's unique ID
user.name — Full name
user.email — Email address
user.role — User role (e.g., 'user', 'admin')
user.verified — Email verification status
user.Profile.skills — Array of skills (as JSON string)
user.Profile.isRemotePreferred — Remote work preference
user.Profile.job_titles — Job title(s)
user.Profile.preferred_location — Preferred location
user.Profile.country — Country
user.Profile.resumeUrl — Link to resume
user.Profile.profileImageUrl — Link to profile image

Notes:

Ensure the baseURL environment variable is set correctly.
Only accessible to admin users.

\n","urlObject":{"path":["admin","users","4"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"c8c01796-e41e-478b-a6fa-ac3b36138bb5"},{"name":"get users statistics","id":"60163e5b-e8ca-41e0-ae18-2df3a7b5c632","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/admin/stats","description":"

Purpose:\nRetrieves aggregated statistics about users and profiles in the Smart AI Jobber system. Useful for admin dashboards and analytics.

Request URL:\nGET /admin/stats

Parameters:

This endpoint does not require any query or path parameters.
Requires appropriate admin authentication.

Example Response:

{\n  \"success\": true,\n  \"message\": \"Smart AI Jobber stats fetched successfully\",\n  \"stats\": {\n    \"success\": true,\n    \"message\": \"Users statistics retrieved successfully\",\n    \"stats\": {\n      \"users\": {\n        \"total\": 2,\n        \"verified\": 1,\n        \"unverified\": 1\n      },\n      \"profiles\": {\n        \"total\": 1,\n        \"withImage\": 1,\n        \"withoutImage\": 0,\n        \"withResume\": 1,\n        \"withoutResume\": 0\n      }\n    }\n  }\n}\n

Expected Status Codes:

200 OK: Statistics successfully retrieved.
401 Unauthorized: Authentication required or failed.
403 Forbidden: Insufficient permissions.
500 Internal Server Error: Unexpected server error.

\n","urlObject":{"path":["admin","stats"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"60163e5b-e8ca-41e0-ae18-2df3a7b5c632"},{"name":"delete user account","id":"4bd294f6-24a5-4877-98eb-7df2cd5d01ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"formdata","formdata":[{"key":"skills","value":"[\"python\", \"React\", \"Expressjs\", \"sql\", \"web3\"]","type":"text","uuid":"b7cd6b93-bdeb-4f41-a271-458a8b447749"},{"key":"isRemotePreferred","value":"true","type":"text","uuid":"054a3ddd-665d-43d9-99de-576212b6e184"},{"key":"job_titles","value":"Junior Web Developer","type":"text","uuid":"91054aa7-8515-4a23-b467-55ae67e32715"},{"key":"preferred_location","value":"Abuja","type":"text","uuid":"78b37920-b700-44fb-8207-c723a6c824d1"},{"key":"country","value":"Nigeria","type":"text","uuid":"f4a5264a-61b3-4396-8a08-f03850f62990"},{"key":"resume","type":"file","uuid":"cfac197b-9cea-4a81-aee4-b794cf083355","src":"/C:/Users/USER/Downloads/roles (2).pdf"},{"key":"profileImage","type":"file","uuid":"2648f933-3fe3-4f01-bc2c-0ad444b18f8e","src":"/C:/Users/USER/Downloads/WhatsApp Image 2025-10-24 at 10.04.27 PM.jpeg"}]},"url":"/admin/users/5","description":"

Purpose:\nDeletes a user account by user ID.

HTTP Method & URL:\nDELETE /admin/users/:userId

Path Parameter:

userId (string or integer): The unique identifier of the user to delete. Example: 5

Expected Success Response:

Status: 200 OK
Body:

{\n  \"success\": true,\n  \"message\": \"User 5 deleted successfully\"\n}\n

Common Error Responses:

401 Unauthorized: Authentication required or invalid credentials.
404 Not Found: User does not exist.
500 Internal Server Error: Unexpected server error.

Usage Notes:

The baseURL is an environment variable and should be set in your active Postman environment.
This endpoint is part of the 'Smart AI Jobber API' collection.

\n","urlObject":{"path":["admin","users","5"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"4bd294f6-24a5-4877-98eb-7df2cd5d01ae"}],"id":"7e2d7fa6-c39d-439b-af99-10f80307c7b2","_postman_id":"7e2d7fa6-c39d-439b-af99-10f80307c7b2","description":""}],"variable":[{"key":"baseURL","value":"","type":"default"}]}