IdeaForge is a full-stack MERN SaaS productivity platform that helps teams manage projects, tasks, meetings, notifications, and analytics — all in one place. The backend is built with Node.js, Express.js, MongoDB/Mongoose, JWT cookie-based authentication, and supports Google OAuth for third-party sign-in and productivity integrations (Gmail, Google Calendar).
\nAll endpoints are prefixed with /api. Set the baseUrl collection variable to https://crmideaforge.onrender.com before running requests.
IdeaForge uses HTTP-only JWT cookies for session management.
\nPOST /api/users) or Login (POST /api/users/login) sets a cookie named jwt automatically in your browser or Postman cookie jar.jwt cookie will be stored and sent with all subsequent requests automatically.POST /api/users/logout), which clears the cookie.\n\nNote: Google Gmail and Google Calendar routes additionally require the user to have completed Google OAuth sign-in via
\nGET /api/auth/googlebefore use.
The following variables are defined at the collection level. Copy IDs from create/list responses and paste them into your Postman environment or collection variables:
\nFollow this sequence for a smooth end-to-end test run:
\njwt cookie)_id as projectId_id as taskId_id as meetingId_id as teamIdThis collection is organized into 11 folders:
\nThis API collection demonstrates the following capabilities:
\nhttps://crmideaforge.onrender.com with a production-ready configuration\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"IdeaForge MERN SaaS API","slug":"ideaforge-mern-saas-api"}],"owner":"50839203","collectionId":"eaca26c0-1192-42db-87da-dcbf5cf4052d","publishedId":"2sBXqKoKkY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-02T05:14:41.000Z"},"item":[{"name":"Health","item":[{"name":"API Health Check","id":"bd5ca60d-c3c8-475f-80a2-9f4ca6219caa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://crmideaforge.onrender.com/api","description":"This collection is structured for evaluator review. Each folder groups related endpoints logically, and every request includes descriptive documentation, example payloads, and expected responses.
\n
Purpose: Verify that the IdeaForge API server is running and reachable. Use this as the very first request in any test run.
\nMethod & Path: GET /api
Authentication Required: No
\nRequest Body: None
\nGET https://crmideaforge.onrender.com/api\n{\n \"message\": \"IdeaForge API is running\"\n}\nStatus: 200 OK
Contains a single endpoint to verify that the IdeaForge API server is running and reachable.
\nUse this as the first request in any test run to confirm the backend is live before proceeding with authenticated routes.
\nAuthentication required: No
\nEndpoints:
\nGET /api — API Health CheckPurpose: Create a new user account. On success, sets an HTTP-only jwt cookie that authenticates all subsequent requests.
Method & Path: POST /api/users
Authentication Required: No
\nRequest Body: application/json
{\n \"name\": \"Alex Johnson\",\n \"email\": \"alex@example.com\",\n \"password\": \"securePass123\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"name\": \"Alex Johnson\",\n \"email\": \"alex@example.com\",\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 201 Created
The jwt cookie is set automatically.
Purpose: Authenticate an existing user with email and password. Sets an HTTP-only jwt cookie on success.
Method & Path: POST /api/users/login
Authentication Required: No
\nRequest Body: application/json
{\n \"email\": \"alex@example.com\",\n \"password\": \"securePass123\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"name\": \"Alex Johnson\",\n \"email\": \"alex@example.com\"\n}\nStatus: 200 OK
Purpose: Retrieve the authenticated user's profile information.
\nMethod & Path: GET /api/users/profile
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nGET https://crmideaforge.onrender.com/api/users/profile\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"name\": \"Alex Johnson\",\n \"email\": \"alex@example.com\",\n \"avatar\": \"https://example.com/avatar.jpg\",\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 200 OK
Purpose: Update the authenticated user's profile details such as name, email, or password.
\nMethod & Path: PUT /api/users/profile
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
{\n \"name\": \"Alex J.\",\n \"email\": \"alexj@example.com\",\n \"password\": \"newSecurePass456\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"name\": \"Alex J.\",\n \"email\": \"alexj@example.com\"\n}\nStatus: 200 OK
Purpose: End the current user session by clearing the jwt HTTP-only cookie.
Method & Path: POST /api/users/logout
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPOST https://crmideaforge.onrender.com/api/users/logout\n{\n \"message\": \"Logged out successfully\"\n}\nStatus: 200 OK
Handles user registration, login, profile management, and logout. IdeaForge uses HTTP-only JWT cookies for session management — no Bearer tokens are needed.
\njwt in your Postman cookie jar automatically.Authentication required: No for Register/Login; Yes for Profile, Update Profile, Logout
\nEndpoints:
\nPOST /api/users — Register UserPOST /api/users/login — Login UserGET /api/users/profile — Get ProfilePUT /api/users/profile — Update ProfilePOST /api/users/logout — Logout UserPurpose: Initiate the Google OAuth 2.0 sign-in flow. Redirects the user to Google's consent screen.
\nMethod & Path: GET /api/auth/google
Authentication Required: No
\n\n\nImportant: Open this URL directly in a browser to complete the OAuth consent flow. After authorization, Google redirects back to the app and sets the session cookie. You must complete this before using Gmail or Calendar endpoints.
\n
Request Body: None
\nGET https://crmideaforge.onrender.com/api/auth/google\nRedirects to Google's OAuth consent screen. After user grants permission, redirects back and establishes a session.
\nPurpose: Verify the Google OAuth configuration on the server. Returns details about the current OAuth setup, useful for diagnosing sign-in issues.
\nMethod & Path: GET /api/auth/google/debug
Authentication Required: No
\nRequest Body: None
\nGET https://crmideaforge.onrender.com/api/auth/google/debug\n{\n \"clientId\": \"configured\",\n \"callbackUrl\": \"https://crmideaforge.onrender.com/api/auth/google/callback\",\n \"status\": \"OAuth credentials loaded\"\n}\nStatus: 200 OK
Handles Google OAuth 2.0 sign-in flow. Users who sign in with Google gain access to Google Productivity features (Gmail and Google Calendar).
\nAuthentication required: No (initiates the OAuth flow)
\nEndpoints:
\nGET /api/auth/google — Start Google OAuth (redirects to Google consent screen)GET /api/auth/google/debug — Google OAuth Debug (verify OAuth config)Purpose: Retrieve all projects associated with a specific team.
\nMethod & Path: GET /api/projects?team=
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters:
\nGET https://crmideaforge.onrender.com/api/projects?team=664a1b2c3d4e5f6789abc000\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"title\": \"IdeaForge MVP\",\n \"team\": \"664a1b2c3d4e5f6789abc000\",\n \"status\": \"in-progress\"\n }\n]\nStatus: 200 OK
Purpose: Create a new project. After creation, copy the returned _id and set it as the projectId collection variable.
Method & Path: POST /api/projects
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
{\n \"title\": \"IdeaForge MVP\",\n \"description\": \"Build the core SaaS platform features\",\n \"status\": \"planning\",\n \"dueDate\": \"2026-06-30T00:00:00.000Z\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"title\": \"IdeaForge MVP\",\n \"status\": \"planning\",\n \"owner\": \"664a1b2c3d4e5f6789abc111\",\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 201 Created
Copy _id and set it as projectId in your collection variables.
Purpose: Retrieve a single project by its ID, including associated tasks and team details.
\nMethod & Path: GET /api/projects/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nGET https://crmideaforge.onrender.com/api/projects/664a1b2c3d4e5f6789abcdef\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"title\": \"IdeaForge MVP\",\n \"description\": \"Build the core SaaS platform features\",\n \"status\": \"in-progress\",\n \"owner\": { \"_id\": \"664a1b2c3d4e5f6789abc111\", \"name\": \"Alex Johnson\" },\n \"tasks\": [],\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 200 OK
Purpose: Update an existing project's details. Only include the fields you want to change.
\nMethod & Path: PUT /api/projects/
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json — include only fields to update
Path Parameters:
\n{\n \"status\": \"in-progress\",\n \"title\": \"IdeaForge MVP - Phase 1\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"title\": \"IdeaForge MVP - Phase 1\",\n \"status\": \"in-progress\"\n}\nStatus: 200 OK
Purpose: Permanently delete a project by ID. This action cannot be undone.
\nMethod & Path: DELETE /api/projects/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nDELETE https://crmideaforge.onrender.com/api/projects/664a1b2c3d4e5f6789abcdef\n{\n \"message\": \"Project deleted successfully\"\n}\nStatus: 200 OK
Full CRUD operations for managing projects. Projects are the top-level organizational unit in IdeaForge — tasks and teams are associated with projects.
\nAfter creating a project, copy the _id from the response and set it as the projectId collection variable. This is required for Get, Update, Delete, and task/team filtering endpoints.
Authentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/projects — List all projects for the authenticated userGET /api/projects?team= — List projects filtered by teamPOST /api/projects — Create a new projectGET /api/projects/ — Get a project by IDPUT /api/projects/ — Update a projectDELETE /api/projects/ — Delete a projectPurpose: Retrieve all tasks for the authenticated user across all projects.
\nMethod & Path: GET /api/tasks
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None (use List Project Tasks or List Team Tasks for filtered views)
\nGET https://crmideaforge.onrender.com/api/tasks\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc222\",\n \"title\": \"Design login page\",\n \"isCompleted\": false,\n \"priority\": \"high\",\n \"project\": \"664a1b2c3d4e5f6789abcdef\",\n \"assignedTo\": \"664a1b2c3d4e5f6789abc111\",\n \"dueDate\": \"2026-05-15T00:00:00.000Z\"\n }\n]\nStatus: 200 OK
Purpose: Retrieve all tasks belonging to a specific project.
\nMethod & Path: GET /api/tasks?project=
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters:
\nGET https://crmideaforge.onrender.com/api/tasks?project=664a1b2c3d4e5f6789abcdef\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc222\",\n \"title\": \"Design login page\",\n \"isCompleted\": false,\n \"project\": \"664a1b2c3d4e5f6789abcdef\"\n }\n]\nStatus: 200 OK
Purpose: Retrieve incomplete tasks for a specific team. Useful for tracking outstanding work across a team.
\nMethod & Path: GET /api/tasks?team=&isCompleted=false
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters:
\nGET https://crmideaforge.onrender.com/api/tasks?team=664a1b2c3d4e5f6789abc000&isCompleted=false\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc222\",\n \"title\": \"Design login page\",\n \"isCompleted\": false,\n \"team\": \"664a1b2c3d4e5f6789abc000\"\n }\n]\nStatus: 200 OK
Purpose: Create a new task and associate it with a project and/or team. After creation, copy the returned _id and set it as the taskId collection variable.
Method & Path: POST /api/tasks
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
{\n \"title\": \"Design login page\",\n \"description\": \"Create wireframes and implement the login UI\",\n \"project\": \"664a1b2c3d4e5f6789abcdef\",\n \"priority\": \"high\",\n \"dueDate\": \"2026-05-15T00:00:00.000Z\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc222\",\n \"title\": \"Design login page\",\n \"isCompleted\": false,\n \"priority\": \"high\",\n \"project\": \"664a1b2c3d4e5f6789abcdef\",\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 201 Created
\n\nCopy
\n_idand set it astaskIdin your collection variables.
Purpose: Update an existing task's details such as title, status, priority, or assignee.
\nMethod & Path: PUT /api/tasks/
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json — include only fields to update
Path Parameters:
\n{\n \"isCompleted\": true,\n \"priority\": \"medium\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc222\",\n \"title\": \"Design login page\",\n \"isCompleted\": true,\n \"priority\": \"medium\"\n}\nStatus: 200 OK
Purpose: Permanently delete a task by ID. This action cannot be undone.
\nMethod & Path: DELETE /api/tasks/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nDELETE https://crmideaforge.onrender.com/api/tasks/664a1b2c3d4e5f6789abc222\n{\n \"message\": \"Task deleted successfully\"\n}\nStatus: 200 OK
Full CRUD operations for managing tasks. Tasks belong to projects and can be assigned to team members. Supports filtering by project, team, and completion status.
\nAfter creating a task, copy the _id from the response and set it as the taskId collection variable.
GET /api/tasks?project=GET /api/tasks?team=&isCompleted=falseAuthentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/tasks — List all tasksGET /api/tasks?project= — List tasks by projectGET /api/tasks?team=&isCompleted=false — List incomplete team tasksPOST /api/tasks — Create a new taskPUT /api/tasks/ — Update a taskDELETE /api/tasks/ — Delete a taskPurpose: Retrieve all meetings for the authenticated user.
\nMethod & Path: GET /api/meetings
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/meetings\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc333\",\n \"title\": \"Sprint Planning\",\n \"date\": \"2026-05-10T09:00:00.000Z\",\n \"agenda\": \"Plan tasks for Sprint 3\",\n \"team\": \"664a1b2c3d4e5f6789abc000\",\n \"attendees\": [\"664a1b2c3d4e5f6789abc111\"]\n }\n]\nStatus: 200 OK
Purpose: Schedule a new meeting. After creation, copy the returned _id and set it as the meetingId collection variable.
Method & Path: POST /api/meetings
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
{\n \"title\": \"Sprint Planning\",\n \"date\": \"2026-05-10T09:00:00.000Z\",\n \"agenda\": \"Plan tasks for Sprint 3\",\n \"team\": \"664a1b2c3d4e5f6789abc000\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc333\",\n \"title\": \"Sprint Planning\",\n \"date\": \"2026-05-10T09:00:00.000Z\",\n \"agenda\": \"Plan tasks for Sprint 3\",\n \"team\": \"664a1b2c3d4e5f6789abc000\",\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 201 Created
\n\nCopy
\n_idand set it asmeetingIdin your collection variables.
Purpose: Update an existing meeting's details such as title, date, or agenda.
\nMethod & Path: PUT /api/meetings/
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json — include only fields to update
Path Parameters:
\n{\n \"title\": \"Sprint Planning - Revised\",\n \"date\": \"2026-05-11T10:00:00.000Z\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc333\",\n \"title\": \"Sprint Planning - Revised\",\n \"date\": \"2026-05-11T10:00:00.000Z\"\n}\nStatus: 200 OK
Purpose: Permanently delete a meeting by its ID.
\nMethod & Path: DELETE /api/meetings/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nDELETE https://crmideaforge.onrender.com/api/meetings/664a1b2c3d4e5f6789abc333\n{\n \"message\": \"Meeting deleted successfully\"\n}\nStatus: 200 OK
Full CRUD operations for scheduling and managing meetings. Meetings can be associated with teams and include details such as title, date/time, agenda, and attendees.
\nAfter creating a meeting, copy the _id from the response and set it as the meetingId collection variable.
Authentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/meetings — List all meetingsPOST /api/meetings — Create a new meetingPUT /api/meetings/ — Update a meetingDELETE /api/meetings/ — Delete a meetingPurpose: Retrieve all teams that the authenticated user belongs to.
\nMethod & Path: GET /api/teams
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/teams\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc000\",\n \"name\": \"Engineering\",\n \"description\": \"Core engineering team\",\n \"members\": [\n { \"user\": \"664a1b2c3d4e5f6789abc111\", \"role\": \"admin\" }\n ],\n \"createdAt\": \"2026-04-01T00:00:00.000Z\"\n }\n]\nStatus: 200 OK
Purpose: Create a new team. After creation, copy the returned _id and set it as the teamId collection variable.
Method & Path: POST /api/teams
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
{\n \"name\": \"Engineering\",\n \"description\": \"Core engineering team\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc000\",\n \"name\": \"Engineering\",\n \"description\": \"Core engineering team\",\n \"members\": [\n { \"user\": \"664a1b2c3d4e5f6789abc111\", \"role\": \"admin\" }\n ],\n \"createdAt\": \"2026-05-02T04:00:00.000Z\"\n}\nStatus: 201 Created
\n\nCopy
\n_idand set it asteamIdin your collection variables.
Purpose: Retrieve full details of a specific team, including its members and their roles.
\nMethod & Path: GET /api/teams/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nGET https://crmideaforge.onrender.com/api/teams/664a1b2c3d4e5f6789abc000\n{\n \"_id\": \"664a1b2c3d4e5f6789abc000\",\n \"name\": \"Engineering\",\n \"description\": \"Core engineering team\",\n \"members\": [\n { \"user\": { \"_id\": \"664a1b2c3d4e5f6789abc111\", \"name\": \"Alice\" }, \"role\": \"admin\" },\n { \"user\": { \"_id\": \"664a1b2c3d4e5f6789abc222\", \"name\": \"Bob\" }, \"role\": \"member\" }\n ],\n \"createdAt\": \"2026-04-01T00:00:00.000Z\"\n}\nStatus: 200 OK
Purpose: Add a user to an existing team with a specified role.
\nMethod & Path: POST /api/teams//members
Authentication Required: Yes (JWT cookie)
\nRequest Body: application/json
Path Parameters:
\n{\n \"userId\": \"664a1b2c3d4e5f6789abc222\",\n \"role\": \"member\"\n}\n{\n \"_id\": \"664a1b2c3d4e5f6789abc000\",\n \"name\": \"Engineering\",\n \"members\": [\n { \"user\": \"664a1b2c3d4e5f6789abc111\", \"role\": \"admin\" },\n { \"user\": \"664a1b2c3d4e5f6789abc222\", \"role\": \"member\" }\n ]\n}\nStatus: 200 OK
Update the role of an existing member within a team. Allows a team owner or admin to promote or demote a member. Method: PUT /api/teams//members/. Authentication required via JWT cookie. Send a JSON body with a role field set to either admin or member. Path variables: teamId is the team _id, memberUserId is the target user _id. Returns 200 OK with the updated team object on success. Returns 400 for invalid role, 401 if not authenticated, 403 if insufficient permissions, and 404 if team or member is not found.
\n","urlObject":{"path":["api","teams","","members",""],"host":["https://crmideaforge.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9e3cc740-819c-4a06-9a8f-dbb3e8256cad"},{"name":"Remove Team Member","id":"ed7810d4-90ed-4dce-b12b-3919836436b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://crmideaforge.onrender.com/api/teams//members/","description":"Purpose: Remove a user from a team. The user will lose access to team projects and tasks.
\nMethod & Path: DELETE /api/teams//members/
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nDELETE https://crmideaforge.onrender.com/api/teams/664a1b2c3d4e5f6789abc000/members/664a1b2c3d4e5f6789abc444\n{\n \"message\": \"Member removed successfully\"\n}\nStatus: 200 OK
Manage teams and team membership. Teams group users together for collaborative work on projects and tasks. Each team member can be assigned a role (e.g., admin, member, viewer) to control access.
\n_id and set it as teamId._id and set it as memberUserId.The Update Member Role endpoint allows team admins to change a member's role, enabling fine-grained access control across the platform.
\nAuthentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/teams — List all teams for the authenticated userPOST /api/teams — Create a new teamGET /api/teams/ — Get a team by IDPOST /api/teams//members — Add a member to a teamPUT /api/teams//members/ — Update a member's roleDELETE /api/teams//members/ — Remove a member from a teamPurpose: Retrieve aggregated statistics for the authenticated user's workspace. Returns summary counts and metrics for projects, tasks, meetings, and team activity.
\nMethod & Path: GET /api/dashboard/stats
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/dashboard/stats\n{\n \"totalProjects\": 5,\n \"totalTasks\": 23,\n \"completedTasks\": 14,\n \"pendingTasks\": 9,\n \"totalMeetings\": 3,\n \"totalTeams\": 2,\n \"recentActivity\": []\n}\nStatus: 200 OK
Purpose: Retrieve detailed reporting data for the authenticated user's workspace. Useful for generating progress reports and productivity breakdowns.
\nMethod & Path: GET /api/reports
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/reports\n{\n \"taskCompletionRate\": 60.87,\n \"projectsByStatus\": {\n \"planning\": 1,\n \"in-progress\": 3,\n \"completed\": 1\n },\n \"tasksByPriority\": {\n \"high\": 8,\n \"medium\": 10,\n \"low\": 5\n },\n \"meetingsThisMonth\": 3\n}\nStatus: 200 OK
Provides aggregated analytics and reporting data for the authenticated user's workspace. Use these endpoints to get a high-level overview of project progress, task completion rates, team activity, and more.
\nAuthentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/dashboard/stats — Dashboard Stats (summary counts and metrics)GET /api/reports — Reports Data (detailed breakdown for reporting)Purpose: Retrieve all in-app notifications for the authenticated user. Notifications are generated by platform events such as task assignments, project updates, and team invitations.
\nMethod & Path: GET /api/notifications
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/notifications\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abc555\",\n \"message\": \"You have been assigned a new task: Design login page\",\n \"isRead\": false,\n \"createdAt\": \"2026-05-02T03:00:00.000Z\"\n }\n]\nStatus: 200 OK
\n\nCopy a notification
\n_idand set it asnotificationIdin your collection variables to use the Mark Notification Read endpoint.
Purpose: Mark all of the authenticated user's notifications as read in a single operation.
\nMethod & Path: PUT /api/notifications/read-all
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPUT https://crmideaforge.onrender.com/api/notifications/read-all\n{\n \"message\": \"All notifications marked as read\"\n}\nStatus: 200 OK
Purpose: Mark a single notification as read by its ID.
\nMethod & Path: PUT /api/notifications//read
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nPath Parameters:
\nPUT https://crmideaforge.onrender.com/api/notifications/664a1b2c3d4e5f6789abc555/read\n{\n \"_id\": \"664a1b2c3d4e5f6789abc555\",\n \"message\": \"You have been assigned a new task: Design login page\",\n \"isRead\": true\n}\nStatus: 200 OK
Manage in-app notifications for the authenticated user. Notifications are generated automatically by platform events (e.g., task assignments, project updates, team invitations).
\nCopy a notification _id from the List Notifications response and set it as notificationId to use the Mark Notification Read endpoint.
Authentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/notifications — List all notifications for the current userPUT /api/notifications/read-all — Mark all notifications as readPUT /api/notifications//read — Mark a specific notification as readPurpose: Search across all entities in the IdeaForge platform — projects, tasks, meetings, teams, and users — using a single keyword query.
\nMethod & Path: GET /api/search?q=project
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters:
\nGET https://crmideaforge.onrender.com/api/search?q=sprint\n{\n \"projects\": [\n { \"_id\": \"664a1b2c3d4e5f6789abcdef\", \"title\": \"IdeaForge MVP\" }\n ],\n \"tasks\": [\n { \"_id\": \"664a1b2c3d4e5f6789abc222\", \"title\": \"Design login page\" }\n ],\n \"meetings\": [\n { \"_id\": \"664a1b2c3d4e5f6789abc333\", \"title\": \"Sprint Planning\" }\n ],\n \"teams\": [],\n \"users\": []\n}\nStatus: 200 OK
Global cross-entity search across the IdeaForge platform. A single query can return matching results from projects, tasks, meetings, teams, and users simultaneously.
\nPass a search term as the q query parameter. Example: GET /api/search?q=project
Replace project with any keyword relevant to your data.
Authentication required: Yes (JWT cookie)
\nEndpoints:
\nGET /api/search?q={{query}} — Global SearchPurpose: Fetch the most recent emails from the authenticated user's Gmail inbox via Google's Gmail API.
\nMethod & Path: GET /api/gmail/recent
Authentication Required: Yes — both IdeaForge JWT cookie AND Google OAuth session
\n\n\nPrerequisite: You must complete the Google OAuth sign-in flow (
\nGET /api/auth/google) before using this endpoint. Without a valid Google OAuth session, this request will return a 401 or 403 error.
Request Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/gmail/recent\n[\n {\n \"id\": \"18f3a2b1c4d5e6f7\",\n \"subject\": \"Welcome to IdeaForge\",\n \"from\": \"noreply@ideaforge.com\",\n \"date\": \"2026-05-01T08:00:00.000Z\",\n \"snippet\": \"Thank you for signing up...\"\n }\n]\nStatus: 200 OK
Purpose: Retrieve upcoming events from the authenticated user's Google Calendar.
\nMethod & Path: GET /api/calendar/upcoming
Authentication Required: Yes — both IdeaForge JWT cookie AND Google OAuth session
\n\n\nPrerequisite: You must complete the Google OAuth sign-in flow (
\nGET /api/auth/google) before using this endpoint.
Request Body: None
\nQuery Parameters: None
\nGET https://crmideaforge.onrender.com/api/calendar/upcoming\n[\n {\n \"id\": \"abc123xyz\",\n \"summary\": \"Sprint Planning\",\n \"start\": { \"dateTime\": \"2026-05-10T09:00:00+05:30\" },\n \"end\": { \"dateTime\": \"2026-05-10T10:00:00+05:30\" },\n \"location\": \"Google Meet\"\n }\n]\nStatus: 200 OK
Purpose: Retrieve all Google Calendar events for a specific month and year.
\nMethod & Path: GET /api/calendar/month?year=2026&month=5
Authentication Required: Yes — both IdeaForge JWT cookie AND Google OAuth session
\n\n\nPrerequisite: You must complete the Google OAuth sign-in flow (
\nGET /api/auth/google) before using this endpoint.
Request Body: None
\nQuery Parameters:
\nGET https://crmideaforge.onrender.com/api/calendar/month?year=2026&month=5\n[\n {\n \"id\": \"abc123xyz\",\n \"summary\": \"Sprint Planning\",\n \"start\": { \"dateTime\": \"2026-05-10T09:00:00+05:30\" },\n \"end\": { \"dateTime\": \"2026-05-10T10:00:00+05:30\" }\n },\n {\n \"id\": \"def456uvw\",\n \"summary\": \"Team Retrospective\",\n \"start\": { \"dateTime\": \"2026-05-24T14:00:00+05:30\" },\n \"end\": { \"dateTime\": \"2026-05-24T15:00:00+05:30\" }\n }\n]\nStatus: 200 OK
Integrates with Google's APIs to surface Gmail messages and Google Calendar events directly within IdeaForge.
\n\n\nYou must complete Google OAuth sign-in first. Navigate to
\nGET /api/auth/googlein the Google OAuth folder and complete the consent flow before using any endpoints in this folder.
Authentication required: Yes — both IdeaForge JWT cookie AND Google OAuth session
\nEndpoints:
\nGET /api/gmail/recent — Recent Gmail EmailsGET /api/calendar/upcoming — Upcoming Calendar EventsGET /api/calendar/month?year=2026&month=5 — Monthly Calendar Events (adjust year/month as needed)Purpose: Retrieve all projects belonging to the authenticated user.
\nMethod & Path: GET /api/projects
Authentication Required: Yes (JWT cookie)
\nRequest Body: None
\nQuery Parameters: None (use List Team Projects to filter by team)
\nGET https://crmideaforge.onrender.com/api/projects\n[\n {\n \"_id\": \"664a1b2c3d4e5f6789abcdef\",\n \"title\": \"IdeaForge MVP\",\n \"description\": \"Build the core SaaS platform\",\n \"status\": \"in-progress\",\n \"team\": \"664a1b2c3d4e5f6789abc000\",\n \"createdAt\": \"2026-05-01T10:00:00.000Z\"\n }\n]\nStatus: 200 OK