- Created swagger.yml to define Swagger UI and JSON endpoints. - Implemented swagger.ts to serve Swagger UI HTML and JSON specifications. - Updated swagger.json with detailed API documentation, including paths, components, and schemas for various requests and responses.
951 lines
33 KiB
JSON
951 lines
33 KiB
JSON
{
|
|
"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" }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|