{
  "openapi": "3.0.0",
  "info": {
    "title": "Minglar API",
    "description": "Serverless Backend API for Minglar - Host Management, Admin, and Prepopulate Services",
    "version": "1.0.0",
    "contact": {
      "name": "Minglar Team"
    }
  },
  "servers": [
    {
      "url": "/",
      "description": "Local Development (serverless-offline)"
    },
    {
      "url": "https://your-api-gateway-url.execute-api.ap-south-1.amazonaws.com/dev",
      "description": "AWS API Gateway (dev)"
    }
  ],
  "tags": [
    {
      "name": "Host - Onboarding",
      "description": "Host registration, login, and onboarding endpoints"
    },
    {
      "name": "Host - Activity Hub",
      "description": "Host activity and PQQ management"
    },
    {
      "name": "Minglar Admin - Auth",
      "description": "Minglar admin authentication endpoints"
    },
    {
      "name": "Minglar Admin - Host Hub",
      "description": "Admin host management endpoints"
    },
    {
      "name": "Minglar Admin - Settings",
      "description": "Admin settings and teammate management"
    },
    {
      "name": "Prepopulate",
      "description": "Reference data and lookup endpoints"
    },
    {
      "name": "PQQ",
      "description": "Pre-Qualification Questionnaire endpoints"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "SignUpRequest": {
        "type": "object",
        "required": ["firstName", "lastName", "emailAddress"],
        "properties": {
          "firstName": { "type": "string", "example": "John" },
          "lastName": { "type": "string", "example": "Doe" },
          "emailAddress": { "type": "string", "format": "email", "example": "john@example.com" },
          "isdCode": { "type": "string", "example": "+91" },
          "mobileNumber": { "type": "string", "example": "9876543210" }
        }
      },
      "LoginRequest": {
        "type": "object",
        "required": ["emailAddress", "password"],
        "properties": {
          "emailAddress": { "type": "string", "format": "email", "example": "john@example.com" },
          "password": { "type": "string", "example": "password123" }
        }
      },
      "VerifyOTPRequest": {
        "type": "object",
        "required": ["emailAddress", "otp"],
        "properties": {
          "emailAddress": { "type": "string", "format": "email" },
          "otp": { "type": "string", "example": "123456" }
        }
      },
      "CreatePasswordRequest": {
        "type": "object",
        "required": ["password", "confirmPassword"],
        "properties": {
          "password": { "type": "string", "minLength": 8 },
          "confirmPassword": { "type": "string", "minLength": 8 }
        }
      },
      "BankDetailsRequest": {
        "type": "object",
        "required": ["bankXid", "bankBranchXid", "accountNumber", "accountHolderName", "ifscCode", "currencyXid"],
        "properties": {
          "bankXid": { "type": "integer" },
          "bankBranchXid": { "type": "integer" },
          "accountNumber": { "type": "string" },
          "accountHolderName": { "type": "string" },
          "ifscCode": { "type": "string" },
          "currencyXid": { "type": "integer" }
        }
      },
      "CompanyDetailsRequest": {
        "type": "object",
        "properties": {
          "companyName": { "type": "string" },
          "companyAddress": { "type": "string" },
          "companyDocuments": { "type": "array", "items": { "type": "string" } }
        }
      },
      "ActivityRequest": {
        "type": "object",
        "required": ["activityTypeXid", "activityName"],
        "properties": {
          "activityTypeXid": { "type": "integer" },
          "activityName": { "type": "string" },
          "description": { "type": "string" }
        }
      },
      "PQQAnswerRequest": {
        "type": "object",
        "required": ["questionXid", "answer"],
        "properties": {
          "questionXid": { "type": "integer" },
          "answer": { "type": "string" },
          "activityXid": { "type": "integer" }
        }
      },
      "InviteTeammateRequest": {
        "type": "object",
        "required": ["emailAddress", "roleXid"],
        "properties": {
          "emailAddress": { "type": "string", "format": "email" },
          "roleXid": { "type": "integer" },
          "firstName": { "type": "string" },
          "lastName": { "type": "string" }
        }
      },
      "SuggestionRequest": {
        "type": "object",
        "required": ["hostXid", "suggestion"],
        "properties": {
          "hostXid": { "type": "integer" },
          "suggestion": { "type": "string" }
        }
      },
      "AssignAMRequest": {
        "type": "object",
        "required": ["hostXid", "amXid"],
        "properties": {
          "hostXid": { "type": "integer" },
          "amXid": { "type": "integer" }
        }
      },
      "LoginResponse": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "firstName": { "type": "string" },
          "lastName": { "type": "string" },
          "emailAddress": { "type": "string" },
          "mobileNumber": { "type": "string" },
          "isActive": { "type": "boolean" },
          "roleXid": { "type": "integer" },
          "accessToken": { "type": "string" },
          "refreshToken": { "type": "string" }
        }
      },
      "SuccessResponse": {
        "type": "object",
        "properties": {
          "success": { "type": "boolean", "example": true },
          "message": { "type": "string" },
          "data": { "type": "object" }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "success": { "type": "boolean", "example": false },
          "message": { "type": "string" },
          "error": { "type": "string" }
        }
      },
      "PaginatedResponse": {
        "type": "object",
        "properties": {
          "success": { "type": "boolean" },
          "data": { "type": "array", "items": { "type": "object" } },
          "pagination": {
            "type": "object",
            "properties": {
              "page": { "type": "integer" },
              "limit": { "type": "integer" },
              "total": { "type": "integer" },
              "totalPages": { "type": "integer" }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/host": {
      "get": {
        "tags": ["Host - Onboarding"],
        "summary": "Get all hosts",
        "description": "Retrieve a list of all hosts with pagination",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 10 } }
        ],
        "responses": {
          "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse" } } } },
          "401": { "description": "Unauthorized" }
        }
      }
    },
    "/host/Host_Admin/onboarding/registration": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Host Sign Up",
        "description": "Register a new host account",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignUpRequest" } } }
        },
        "responses": {
          "201": { "description": "Host registered successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } },
          "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
        }
      }
    },
    "/host/Host_Admin/onboarding/verify-otp": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Verify OTP",
        "description": "Verify OTP sent to host email",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyOTPRequest" } } }
        },
        "responses": {
          "200": { "description": "OTP verified successfully" },
          "400": { "description": "Invalid OTP" }
        }
      }
    },
    "/host/Host_Admin/onboarding/login": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Host Login",
        "description": "Authenticate host and get access tokens",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }
        },
        "responses": {
          "200": { "description": "Login successful", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginResponse" } } } },
          "401": { "description": "Invalid credentials" }
        }
      }
    },
    "/host/Host_Admin/onboarding/create-password": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Create Password",
        "description": "Create password after OTP verification",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePasswordRequest" } } }
        },
        "responses": {
          "200": { "description": "Password created successfully" },
          "400": { "description": "Password mismatch" }
        }
      }
    },
    "/host/Host_Admin/onboarding/add-payment-details": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Add Bank/Payment Details",
        "description": "Add bank account details for host",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BankDetailsRequest" } } }
        },
        "responses": {
          "200": { "description": "Payment details added successfully" },
          "400": { "description": "Invalid details" }
        }
      }
    },
    "/host/Host_Admin/onboarding/add-company-details": {
      "patch": {
        "tags": ["Host - Onboarding"],
        "summary": "Submit Company Details",
        "description": "Submit company information with documents",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/CompanyDetailsRequest" } } }
        },
        "responses": {
          "200": { "description": "Company details submitted successfully" }
        }
      }
    },
    "/host/Host_Admin/onboarding/accept-agreement": {
      "patch": {
        "tags": ["Host - Onboarding"],
        "summary": "Accept Agreement",
        "description": "Host accepts the terms and agreement",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Agreement accepted" }
        }
      }
    },
    "/host/getById": {
      "get": {
        "tags": ["Host - Onboarding"],
        "summary": "Get Host By ID",
        "description": "Get host details by ID",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "hostXid", "in": "query", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Host details retrieved" },
          "404": { "description": "Host not found" }
        }
      }
    },
    "/host/get-suggestion": {
      "get": {
        "tags": ["Host - Onboarding"],
        "summary": "Show Suggestions",
        "description": "Get suggestions for host",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Suggestions retrieved" }
        }
      }
    },
    "/stepper": {
      "get": {
        "tags": ["Host - Onboarding"],
        "summary": "Get Stepper Info",
        "description": "Get onboarding stepper progress",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Stepper info retrieved" }
        }
      }
    },
    "/resend-otp": {
      "post": {
        "tags": ["Host - Onboarding"],
        "summary": "Resend OTP",
        "description": "Resend OTP to email",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "type": "object", "properties": { "emailAddress": { "type": "string", "format": "email" } } } } }
        },
        "responses": {
          "200": { "description": "OTP sent successfully" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/add-activity": {
      "post": {
        "tags": ["Host - Activity Hub"],
        "summary": "Save Activity for PQQ",
        "description": "Save new activity for pre-qualification questionnaire",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivityRequest" } } }
        },
        "responses": {
          "200": { "description": "Activity saved successfully" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/create-activity": {
      "post": {
        "tags": ["Host - Activity Hub"],
        "summary": "Create Activity and Questions",
        "description": "Create activity entry with all questions",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivityRequest" } } }
        },
        "responses": {
          "200": { "description": "Activity created successfully" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/get-pqq-question-details": {
      "get": {
        "tags": ["Host - Activity Hub"],
        "summary": "Get PQQ By Question ID",
        "description": "Get PQQ question details by ID",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "questionXid", "in": "query", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Question details retrieved" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/get-latest-pqq-question-details": {
      "get": {
        "tags": ["Host - Activity Hub"],
        "summary": "Get Latest PQQ Question",
        "description": "Get the last updated PQQ question",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Latest question retrieved" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/prepopulate-new-activity": {
      "get": {
        "tags": ["Host - Activity Hub"],
        "summary": "Prepopulate New Activity",
        "description": "Get all activity types for prepopulation",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Activity types retrieved" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/get-all-host-activity": {
      "get": {
        "tags": ["Host - Activity Hub"],
        "summary": "Get All Host Activities",
        "description": "Get all activities for a host",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Activities retrieved" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/submit-pqq-answer": {
      "patch": {
        "tags": ["Host - Activity Hub"],
        "summary": "Submit PQQ Answer",
        "description": "Submit answer for PQQ question",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PQQAnswerRequest" } } }
        },
        "responses": {
          "200": { "description": "Answer submitted" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/submit-pq-answer": {
      "patch": {
        "tags": ["Host - Activity Hub"],
        "summary": "Submit PQ Answer",
        "description": "Submit pre-qualification answer",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PQQAnswerRequest" } } }
        },
        "responses": {
          "200": { "description": "Answer submitted" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/submit-final-pqq-answer": {
      "post": {
        "tags": ["Host - Activity Hub"],
        "summary": "Submit Final PQQ Answer",
        "description": "Submit final PQQ answer and get score",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Final answer submitted" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/submit-pqq-for-review": {
      "patch": {
        "tags": ["Host - Activity Hub"],
        "summary": "Submit PQQ for Review",
        "description": "Submit PQQ for admin review",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Submitted for review" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/get-all-pqq-ques-submited-ans": {
      "get": {
        "tags": ["Host - Activity Hub"],
        "summary": "Get All PQQ with Submitted Answers",
        "description": "Get all PQQ questions with submitted answers",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "activityXid", "in": "query", "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "PQQ with answers retrieved" }
        }
      }
    },
    "/host/Activity_Hub/OnBoarding/update-suggestion-reviewed": {
      "patch": {
        "tags": ["Host - Activity Hub"],
        "summary": "Update Suggestion as Reviewed",
        "description": "Mark suggestion as reviewed by host",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Suggestion marked as reviewed" }
        }
      }
    },
    "/minglaradmin/registration": {
      "post": {
        "tags": ["Minglar Admin - Auth"],
        "summary": "Admin Registration",
        "description": "Register a new Minglar admin",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignUpRequest" } } }
        },
        "responses": {
          "201": { "description": "Admin registered successfully" }
        }
      }
    },
    "/minglaradmin/login": {
      "post": {
        "tags": ["Minglar Admin - Auth"],
        "summary": "Admin Login",
        "description": "Authenticate Minglar admin",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }
        },
        "responses": {
          "200": { "description": "Login successful", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginResponse" } } } }
        }
      }
    },
    "/minglaradmin/create-password": {
      "post": {
        "tags": ["Minglar Admin - Auth"],
        "summary": "Create Admin Password",
        "description": "Create password for Minglar admin",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePasswordRequest" } } }
        },
        "responses": {
          "200": { "description": "Password created" }
        }
      }
    },
    "/minglaradmin/update-profile": {
      "patch": {
        "tags": ["Minglar Admin - Auth"],
        "summary": "Update Admin Profile",
        "description": "Update Minglar admin profile with image",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "profileImage": { "type": "string", "format": "binary" } } } } }
        },
        "responses": {
          "200": { "description": "Profile updated" }
        }
      }
    },
    "/minglaradmin/prepopulate-Roles": {
      "get": {
        "tags": ["Minglar Admin - Auth"],
        "summary": "Prepopulate Roles",
        "description": "Get all available roles",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Roles retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/get-host-details/{host_xid}": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get Host Details By ID",
        "description": "Get detailed host information for admin",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "host_xid", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Host details retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/get-all-host-applications-am": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get All Host Applications for AM",
        "description": "Get all host applications for Account Manager",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "page", "in": "query", "schema": { "type": "integer" } },
          { "name": "limit", "in": "query", "schema": { "type": "integer" } },
          { "name": "status", "in": "query", "schema": { "type": "string" } }
        ],
        "responses": {
          "200": { "description": "Applications retrieved" }
        }
      }
    },
    "/minglaradmin/get-all-activity-of-host/{id}": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get All Host Activities for Admin",
        "description": "Get all activities of a specific host",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Activities retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/get-all-host-applications-admin": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get All Onboarding Host Applications",
        "description": "Get all onboarding host applications for admin",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "page", "in": "query", "schema": { "type": "integer" } },
          { "name": "limit", "in": "query", "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Applications retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/get-all-host-applications-admin-new": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get New Onboarding Applications",
        "description": "Get new onboarding host applications",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "New applications retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/add-suggestion": {
      "post": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Add Suggestion",
        "description": "Add suggestion for host",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuggestionRequest" } } }
        },
        "responses": {
          "200": { "description": "Suggestion added" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/assign-am": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Assign AM to Host",
        "description": "Assign Account Manager to host",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignAMRequest" } } }
        },
        "responses": {
          "200": { "description": "AM assigned" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/edit-agreement-accept-host": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Edit Agreement and Accept Host",
        "description": "Edit agreement details and accept host application",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Agreement updated and host accepted" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/get-all-pqq-ques-ans-for-am": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get All PQQ for AM",
        "description": "Get all PQQ questions and answers for Account Manager",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "activityXid", "in": "query", "schema": { "type": "integer" } },
          { "name": "hostXid", "in": "query", "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "PQQ retrieved" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/accept-host-application": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Accept Host Application",
        "description": "Accept a host application",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "content": { "application/json": { "schema": { "type": "object", "properties": { "hostXid": { "type": "integer" } } } } }
        },
        "responses": {
          "200": { "description": "Application accepted" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/reject-pq-by-am/{activityId}": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Reject PQQ by AM",
        "description": "Reject PQQ by Account Manager",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "activityId", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "requestBody": {
          "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "type": "string" } } } } }
        },
        "responses": {
          "200": { "description": "PQQ rejected" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/accept-pq-by-am/{activityId}": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Accept PQ by AM",
        "description": "Accept pre-qualification by Account Manager",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "activityId", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "PQ accepted" }
        }
      }
    },
    "/minglaradmin/hosthub/onboarding/reject-host-application": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Reject Host Application",
        "description": "Reject a host application by admin",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "content": { "application/json": { "schema": { "type": "object", "properties": { "hostXid": { "type": "integer" }, "reason": { "type": "string" } } } } }
        },
        "responses": {
          "200": { "description": "Application rejected" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/reject-host-application-am": {
      "patch": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Reject Host Application by AM",
        "description": "Reject host application by Account Manager",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Application rejected" }
        }
      }
    },
    "/minglaradmin/hosthub/hosts/add-Pqq-suggestion": {
      "post": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Add PQQ Suggestion",
        "description": "Add suggestion for PQQ",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Suggestion added" }
        }
      }
    },
    "/minglaradmin/hosthub/pqp/pqp-details-for-am/{activityXid}": {
      "get": {
        "tags": ["Minglar Admin - Host Hub"],
        "summary": "Get PQP Details for AM",
        "description": "Get pre-qualification profile details for Account Manager",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "activityXid", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "PQP details retrieved" }
        }
      }
    },
    "/minglaradmin/settings/teammates/invite-teammate": {
      "post": {
        "tags": ["Minglar Admin - Settings"],
        "summary": "Invite Teammate",
        "description": "Invite a new teammate (co-admin or AM)",
        "security": [{ "bearerAuth": [] }],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InviteTeammateRequest" } } }
        },
        "responses": {
          "200": { "description": "Invitation sent" }
        }
      }
    },
    "/minglaradmin/settings/teammates/get-all-invitation-details": {
      "get": {
        "tags": ["Minglar Admin - Settings"],
        "summary": "Get All Invitation Details",
        "description": "Get all pending invitations",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Invitations retrieved" }
        }
      }
    },
    "/minglaradmin/settings/teammates/get-all-coadmin-am": {
      "get": {
        "tags": ["Minglar Admin - Settings"],
        "summary": "Get All Co-admin and AM",
        "description": "Get all co-admins and account managers",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Teammates retrieved" }
        }
      }
    },
    "/minglaradmin/settings/teammates/get-all-invited-coadmin-am": {
      "get": {
        "tags": ["Minglar Admin - Settings"],
        "summary": "Get All Invited Co-admin and AM",
        "description": "Get all invited co-admins and account managers",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Invited teammates retrieved" }
        }
      }
    },
    "/minglaradmin/settings/teammates/get-am-details-by-id/{amXid}": {
      "get": {
        "tags": ["Minglar Admin - Settings"],
        "summary": "Get AM Details by ID",
        "description": "Get Account Manager details by ID",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          { "name": "amXid", "in": "path", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "AM details retrieved" }
        }
      }
    },
    "/prepopulate/get-all-bank-currency-details": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get All Bank and Currency Details",
        "description": "Get all bank and currency reference data",
        "responses": {
          "200": { "description": "Bank and currency details retrieved" }
        }
      }
    },
    "/prepopulate/get-city-by-state": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get Cities by State",
        "description": "Get all cities for a given state",
        "parameters": [
          { "name": "stateXid", "in": "query", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Cities retrieved" }
        }
      }
    },
    "/prepopulate/get-branch-by-bank": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get Branches by Bank",
        "description": "Get all branches for a given bank",
        "parameters": [
          { "name": "bankXid", "in": "query", "required": true, "schema": { "type": "integer" } }
        ],
        "responses": {
          "200": { "description": "Branches retrieved" }
        }
      }
    },
    "/prepopulate/get-all-doc-country": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get All Document Country State City Details",
        "description": "Get all document types with country, state, city data",
        "responses": {
          "200": { "description": "Document details retrieved" }
        }
      }
    },
    "/prepopulate/get-all-pqq-ques-ans": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get All PQQ Questions and Answers",
        "description": "Get all PQQ questions with possible answers",
        "responses": {
          "200": { "description": "PQQ questions retrieved" }
        }
      }
    },
    "/prepopulate/get-all-Frequencies": {
      "get": {
        "tags": ["Prepopulate"],
        "summary": "Get All Frequencies",
        "description": "Get all activity frequencies",
        "responses": {
          "200": { "description": "Frequencies retrieved" }
        }
      }
    }
  }
}