{ "openapi": "3.0.0", "info": { "title": "LWS_PORTAL_STG", "description": "API documentation", "version": "v1.5.6 (04/09/2025)" }, "servers": [ { "url": "https://lwsportal-stg.w3suga.com:8443", "description": "" } ], "paths": { "/api/v1/admin/me": { "get": { "tags": [ "Admin / Account" ], "summary": "Get My Profile", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Account" ], "summary": "Edit My Profile", "requestBody": { "content": { "application/json": { "schema": { "properties": { "avatar": { "type": "string" }, "signature": { "type": "string", "format": "uri", "example": "https://example.com/file.jpg" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/me/password": { "put": { "tags": [ "Admin / Account" ], "summary": "Change My Password", "requestBody": { "content": { "application/json": { "schema": { "required": [ "password", "current_password" ], "properties": { "code": { "type": "string" }, "password": { "type": "string" }, "current_password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Success!" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/admins": { "get": { "tags": [ "Admin / Admin" ], "summary": "Get List Admins", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "department_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "except_ids", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "integer", "example": 1 } } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Admin" ], "summary": "Create New Admin", "requestBody": { "content": { "application/json": { "schema": { "required": [ "firstname", "lastname", "email", "phone", "data_center_ids", "department_id", "role_ids" ], "properties": { "firstname": { "type": "string" }, "lastname": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "data_center_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "department_id": { "type": "integer" }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/admins/{id}": { "get": { "tags": [ "Admin / Admin" ], "summary": "Get Admin Information", "parameters": [ { "name": "id", "in": "path", "description": "Admin ID", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Admin" ], "summary": "Edit Admin", "parameters": [ { "name": "id", "in": "path", "description": "Admin ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "firstname": { "type": "string" }, "lastname": { "type": "string" }, "phone": { "type": "string" }, "data_center_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "department_id": { "type": "integer" }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "is_active": { "type": "integer", "enum": [ 0, 1 ] }, "is_display_code": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/admins/admin-emails/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Admin Emails", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/admins/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Admins", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "department_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at", "name" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/attribute-service": { "get": { "tags": [ "Admin / Service / Attribute" ], "summary": "Get List Attribute-Service", "parameters": [ { "name": "service_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "attribute_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "sort_index", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Service / Attribute" ], "summary": "Create Attribute Service", "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "attributes" ], "properties": { "service_id": { "type": "number" }, "attributes": { "type": "array", "items": { "type": "number" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/attribute-service/{id}": { "get": { "tags": [ "Admin / Service / Attribute" ], "summary": "Get Attribute Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Attribute Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service / Attribute" ], "summary": "Edit Attribute Service", "parameters": [ { "name": "id", "in": "path", "description": "Attribute Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "is_quotation_required", "is_sales_required", "is_published" ], "properties": { "is_quotation_required": { "type": "number", "enum": [ 0, 1 ] }, "is_sales_required": { "type": "number", "enum": [ 0, 1 ] }, "is_published": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Service / Attribute" ], "summary": "Delete Attribute Service", "parameters": [ { "name": "id", "in": "path", "description": "Attribute Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/attribute-service/sort-index": { "put": { "tags": [ "Admin / Service / Attribute" ], "summary": "Sort Attribute Service", "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "attributes" ], "properties": { "service_id": { "type": "number", "example": 1 }, "attributes": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/audit-logs": { "get": { "tags": [ "Admin / Audit Log" ], "summary": "Get List Audit Logs", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "module", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "activity_types[]", "in": "query", "required": false, "style": "form", "schema": { "type": "array", "items": { "type": "string", "example": "create.admin" } } }, { "name": "from_date", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to_date", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/audit-logs/modules/public": { "get": { "tags": [ "Admin / Audit Log" ], "summary": "Get List Audit Logs Modules", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/audit-logs/activity-types/public": { "get": { "tags": [ "Admin / Audit Log" ], "summary": "Get List Audit Logs Activity Types", "parameters": [ { "name": "module", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/billing-accounts": { "get": { "tags": [ "Admin / Customer / Billing Account" ], "summary": "Get List Billing Account", "parameters": [ { "name": "customer_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Customer / Billing Account" ], "summary": "Create New Billing Account", "requestBody": { "content": { "application/json": { "schema": { "required": [ "ref_code", "customer_id", "admin_firstname", "admin_email", "admin_phone_number", "billing_firstname", "billing_email", "billing_phone_number", "is_same_billing", "technical_firstname", "technical_email", "technical_phone_number", "is_same_technical" ], "properties": { "ref_code": { "type": "string" }, "customer_id": { "type": "number" }, "admin_firstname": { "type": "string" }, "admin_lastname": { "type": "string" }, "admin_email": { "type": "string", "format": "email" }, "admin_phone_number": { "type": "string" }, "billing_firstname": { "type": "string" }, "billing_lastname": { "type": "string" }, "billing_email": { "type": "string", "format": "email" }, "billing_phone_number": { "type": "string" }, "is_same_billing": { "type": "number", "enum": [ 0, 1 ] }, "technical_firstname": { "type": "string" }, "technical_lastname": { "type": "string" }, "technical_email": { "type": "string", "format": "email" }, "technical_phone_number": { "type": "string" }, "is_same_technical": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/billing-accounts/{id}": { "get": { "tags": [ "Admin / Customer / Billing Account" ], "summary": "Get Billing Account Information", "parameters": [ { "name": "id", "in": "path", "description": "Billing Account ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Customer / Billing Account" ], "summary": "Edit Billing Account", "parameters": [ { "name": "id", "in": "path", "description": "Billing Account ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "is_default", "ref_code", "customer_id", "admin_firstname", "admin_email", "admin_phone_number", "billing_firstname", "billing_email", "billing_phone_number", "is_same_billing", "technical_firstname", "technical_email", "technical_phone_number", "is_same_technical" ], "properties": { "ref_code": { "type": "string" }, "customer_id": { "type": "number" }, "admin_firstname": { "type": "string" }, "admin_lastname": { "type": "string" }, "admin_email": { "type": "string", "format": "email" }, "admin_phone_number": { "type": "string" }, "billing_firstname": { "type": "string" }, "billing_lastname": { "type": "string" }, "billing_email": { "type": "string", "format": "email" }, "billing_phone_number": { "type": "string" }, "is_same_billing": { "type": "number", "enum": [ 0, 1 ] }, "technical_firstname": { "type": "string" }, "technical_lastname": { "type": "string" }, "technical_email": { "type": "string", "format": "email" }, "technical_phone_number": { "type": "string" }, "is_same_technical": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Customer / Billing Account" ], "summary": "Delete Billing Account", "parameters": [ { "name": "id", "in": "path", "description": "Billing Account ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/billing-accounts/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Billing Account", "parameters": [ { "name": "customer_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/business-units": { "get": { "tags": [ "Admin / Customer / Business Unit" ], "summary": "Get List Business Unit", "parameters": [ { "name": "customer_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Customer / Business Unit" ], "summary": "Create New BusinessUnit", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "customer_id" ], "properties": { "name": { "type": "string" }, "customer_id": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/business-units/{id}": { "get": { "tags": [ "Admin / Customer / Business Unit" ], "summary": "Get Business unit Information", "parameters": [ { "name": "id", "in": "path", "description": "Business Unit ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Customer / Business Unit" ], "summary": "Edit Business Unit", "parameters": [ { "name": "id", "in": "path", "description": "Business Unit ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "properties": { "name": { "type": "string" }, "is_active": { "type": "integer", "enum": [ 0, 1 ] }, "is_default": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Customer / Business Unit" ], "summary": "Delete Business Unit", "parameters": [ { "name": "id", "in": "path", "description": "Business Unit ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/business-units/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Business Unit Public", "parameters": [ { "name": "customer_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/categories": { "get": { "tags": [ "Admin / Category" ], "summary": "Get List Categories", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "product_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Category" ], "summary": "Create New Category", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code", "product_id" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "product_id": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/categories/{id}": { "get": { "tags": [ "Admin / Category" ], "summary": "Get Category Information", "parameters": [ { "name": "id", "in": "path", "description": "Category ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Category" ], "summary": "Edit Category", "parameters": [ { "name": "id", "in": "path", "description": "Category ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code", "product_id" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "product_id": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Category" ], "summary": "Delete Category", "parameters": [ { "name": "id", "in": "path", "description": "Category ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/categories/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Categories Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "product_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/{id}/contractors": { "get": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Get List Contractor Access Pass Requests", "operationId": "058021755f6e28783b945284deab1157", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/contractors/{id}/login": { "put": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Approve Contractor Access Pass Request", "operationId": "adae074876b6da9085588b60cd38cd34", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "access_pass" ], "properties": { "access_pass": { "type": "string", "example": "ACDC02222" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/contractors/{id}/logout": { "put": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Log Out Contractor Access Pass Contractor", "operationId": "52fba95c4dc7120e1036c94a42ef6489", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/{id}/contractor-logs": { "get": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Get List Contractor Access Pass Requests", "operationId": "6b4fb0b1f2bed23880867411fc545829", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "log_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests": { "get": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Get List Contractor Access Pass Requests", "operationId": "4817b022dfda6c3f7f5d8b03d65fe0b7", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "visit_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/{id}": { "get": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Get Contractor Access Pass Request Detail", "operationId": "f81b7377c46727b9f2a5a67fd942a497", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Update Contractor Access Pass Request", "operationId": "f0734c0cb6e5802ac7492adeb9a278c2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "host_account_id" ], "properties": { "host_account_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/{id}/approve": { "put": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Approve Contractor Access Pass Request", "operationId": "c7e386422cd56c7845573b3c9db3d134", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "is_confirmed" ], "properties": { "is_confirmed": { "type": "integer", "example": 1 } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/contractor-access-pass-requests/{id}/reject": { "put": { "tags": [ "Admin / Request / Contractor Access Pass Requests" ], "summary": "Reject Contractor Access Pass Request", "operationId": "2f5d0b458a29b3d404e1fbb75d4ab9bd", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "rejection_reason" ], "properties": { "rejection_reason": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/costs/{id}": { "get": { "tags": [ "Admin / Service / Cost" ], "summary": "Get Cost Information", "parameters": [ { "name": "id", "in": "path", "description": "Cost ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service / Cost" ], "summary": "Edit Cost", "parameters": [ { "name": "id", "in": "path", "description": "Cost ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "nrc", "mrc", "arc" ], "properties": { "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/currencies": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Currencies", "parameters": [ { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Setting" ], "summary": "Edit Rate of List Currency", "requestBody": { "content": { "application/json": { "schema": { "properties": { "rates": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "rate": { "type": "number" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Setting" ], "summary": "Create New Currency", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code", "rate", "symbol" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "rate": { "type": "number" }, "symbol": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/currencies/{id}": { "put": { "tags": [ "Admin / Setting" ], "summary": "Edit Status of the Currency (active, default)", "parameters": [ { "name": "id", "in": "path", "description": "Currency ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "is_default": { "type": "number" }, "is_active": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/currencies/{id}/currency-histories": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Currency History", "parameters": [ { "name": "id", "in": "path", "description": "Currency ID", "required": true, "schema": { "type": "integer" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/currencies/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Currencies", "parameters": [ { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/access-pass-quotas": { "get": { "tags": [ "Admin / Customer" ], "summary": "Get Customer Access Pass Quotas", "operationId": "ac9cf2bf1431c2b3d5ea014939d7b890", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "integer" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created_at", "updated_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/access-pass-quotas/{id}": { "put": { "tags": [ "Admin / Customer" ], "summary": "Update Customer Access Pass Quota", "operationId": "70899dfe04e90d0d5151782113673f12", "parameters": [ { "name": "id", "in": "path", "description": "Customer Access Pass Quota ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "assigned_quota" ], "properties": { "assigned_quota": { "type": "integer", "example": 100 } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/contact-info": { "put": { "tags": [ "Admin / Customer" ], "summary": "Edit Customer Contact Info", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "email": { "type": "string", "format": "email" }, "phone_number": { "type": "string" }, "address": { "type": "string" }, "country": { "type": "string" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers": { "get": { "tags": [ "Admin / Customer" ], "summary": "Get List Customers", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "corporate", "individual" ] } }, { "name": "kyc", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pending", "verifying", "verified" ] } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Customer" ], "summary": "Create New Customer", "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_type", "email" ], "properties": { "customer_type": { "type": "string", "enum": [ "corporate", "individual" ] }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "fullname": { "type": "string" }, "company_name": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}": { "get": { "tags": [ "Admin / Customer" ], "summary": "Get Customer Information", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Customer" ], "summary": "Edit Customer", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "is_active": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Customer" ], "summary": "Delete Customer", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/report-detail": { "get": { "tags": [ "Admin / Customer" ], "summary": "Get Customer Information", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/verify": { "put": { "tags": [ "Admin / Customer" ], "summary": "Verify Customer", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "kyc": { "type": "string", "enum": [ "verified" ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/others-info": { "put": { "tags": [ "Admin / Customer" ], "summary": "Edit Customer Others Info", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "credit_limit": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/send-info": { "post": { "tags": [ "Admin / Customer" ], "summary": "Send Customer Information", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/sync-xero": { "post": { "tags": [ "Admin / Customer" ], "summary": "Sync Customer to Xero", "description": "This API has two usage scenarios: 1) Request to Sync. 2) Send auth code after the required login is completed.", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "description": "Only required right after login success with Xero", "type": "string", "example": "4X2Y6XEACAcCucnJQ-yrwDG-yAy0i0w6HfYaat4xXFI" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response indicating the type of operation. Check schema below", "content": { "application/json": { "schema": { "oneOf": [ { "properties": { "type": { "type": "string", "example": "request_to_login" }, "login_url": { "type": "string", "example": "https://login.xero.com/..." } }, "type": "object" }, { "properties": { "type": { "type": "string", "example": "success" }, "xero_data": { "properties": { "contact_id": { "type": "string", "example": "20f0a73f-9006-49bd-a8b2-f5fefe6d8c57" }, "name": { "type": "string", "example": "Company A" } }, "type": "object" } }, "type": "object" } ] } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/company/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Company Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "kyc", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Customer Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "corporate", "individual" ] } }, { "name": "kyc", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/{id}/customer-info": { "put": { "tags": [ "Admin / Customer" ], "summary": "Edit Customer Info", "parameters": [ { "name": "id", "in": "path", "description": "Customer ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "company_name": { "type": "string" }, "uen": { "type": "string" }, "previous_uen": { "type": "string" }, "company_type": { "type": "string" }, "previous_company_name": { "type": "string" }, "activity": { "type": "string" }, "registration_date": { "type": "string", "format": "date" }, "company_capital": { "type": "string" }, "uen_docs": { "type": "array", "items": { "type": "string", "format": "url" } }, "company_email": { "type": "string", "format": "email" }, "phone_number": { "type": "string" }, "fullname": { "type": "string" }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "nric_passport_docs": { "type": "array", "items": { "type": "string", "format": "url" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/data-centers": { "get": { "tags": [ "Admin / Data Center" ], "summary": "Get List Data Centers", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "ref_code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Data Center" ], "summary": "Create New Data Center", "requestBody": { "content": { "application/json": { "schema": { "required": [ "ref_code", "name" ], "properties": { "ref_code": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/data-centers/{id}": { "get": { "tags": [ "Admin / Data Center" ], "summary": "Get Data Center Information", "parameters": [ { "name": "id", "in": "path", "description": "Data Center ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Data Center" ], "summary": "Edit Data Center", "parameters": [ { "name": "id", "in": "path", "description": "Data Center ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "ref_code", "name" ], "properties": { "ref_code": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Data Center" ], "summary": "Delete Data Center", "parameters": [ { "name": "id", "in": "path", "description": "Data Center ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/data-centers/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Data Centers Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "ref_code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/data-centers/access-pass-locations": { "get": { "tags": [ "Admin / Data Center" ], "summary": "Get List Data Centers for Access Pass Location", "operationId": "06b8f7da106fb5bb74089b69492f0551", "parameters": [ { "name": "customer_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "expired_date", "in": "query", "required": false, "schema": { "type": "date", "format": "Y-m-d" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "ref_code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders": { "get": { "tags": [ "Admin / Delivery Order" ], "summary": "Get List Delivery Orders", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sales_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "original_do_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "completed" ] } }, { "name": "service_status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "delivering", "delivered", "returned", "redelivery" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "created_at", "delivery_order_code" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Delivery Order" ], "summary": "Create New Delivery Orders", "requestBody": { "content": { "application/json": { "schema": { "required": [ "sales_id", "contact_account_id", "services", "terms_conditions" ], "properties": { "sales_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "original_do_id": { "type": "number" }, "remarks": { "type": "string" }, "address": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "city": { "type": "string" }, "services": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "serial_number": { "type": "string" }, "quantity": { "type": "number" } }, "type": "object" } }, "terms_conditions": { "type": "array", "items": { "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/{id}": { "get": { "tags": [ "Admin / Delivery Order" ], "summary": "Get Delivery Order Information", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Delivery Order" ], "summary": "Update Delivery Order", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "sales_id", "contact_account_id", "services", "terms_conditions" ], "properties": { "sales_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "original_do_id": { "type": "number" }, "remarks": { "type": "string" }, "address": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "city": { "type": "string" }, "services": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "serial_number": { "type": "string" }, "quantity": { "type": "number" } }, "type": "object" } }, "terms_conditions": { "type": "array", "items": { "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Delivery Order" ], "summary": "Delete Delivery Order", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/{id}/template": { "get": { "tags": [ "Admin / Delivery Order" ], "summary": "Get Delivery Order Information", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/{id}/complete": { "put": { "tags": [ "Admin / Delivery Order" ], "summary": "Complete a Delivery Order", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/{id}/sign": { "put": { "tags": [ "Admin / Delivery Order" ], "summary": "Sign a Delivery Order", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "signature", "signatory_name" ], "properties": { "signature": { "type": "string" }, "signatory_name": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Delivery Orders", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sales_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "original_do_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "completed" ] } }, { "name": "service_status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "delivering", "delivered", "returned", "redelivery" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "created_at", "delivery_order_code" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/delivery-orders/services/{id}": { "put": { "tags": [ "Admin / Delivery Order" ], "summary": "Return Service of the Delivery Order", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "quantity" ], "properties": { "quantity": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/departments": { "get": { "tags": [ "Admin / Department" ], "summary": "Get List Departments", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Department" ], "summary": "Create New Department", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/departments/{id}": { "get": { "tags": [ "Admin / Department" ], "summary": "Get Department Information", "parameters": [ { "name": "id", "in": "path", "description": "Department ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Department" ], "summary": "Edit Department", "parameters": [ { "name": "id", "in": "path", "description": "Department ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Department" ], "summary": "Delete Department", "parameters": [ { "name": "id", "in": "path", "description": "Department ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/departments/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Departments Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/discounts": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Discounts", "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "from_date", "to_date", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Setting" ], "summary": "Create New Discount", "requestBody": { "content": { "application/json": { "schema": { "required": [ "discount", "from_date", "to_date" ], "properties": { "discount": { "type": "number" }, "from_date": { "type": "string" }, "to_date": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/discounts/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get the Valid Discount", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes": { "get": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Get List Facility Access Passes", "operationId": "8ba67405abe5e8612fe242b941155559", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pending", "in_used", "issued", "terminating", "terminated", "replacing", "replaced" ] } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "activated", "deactivated" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Create Facility Access Pass", "operationId": "05ff656a8d283421bfd2d783c895258a", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "code", "customer_id", "business_unit_id", "user_id", "data_center_id", "firstname", "lastname", "is_changed", "is_confirmed" ], "properties": { "code": { "type": "string" }, "customer_id": { "type": "integer" }, "business_unit_id": { "type": "integer" }, "image": { "type": "string", "format": "url" }, "user_id": { "type": "integer" }, "data_center_id": { "type": "integer" }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "phone": { "type": "string" }, "is_changed": { "type": "integer", "enum": [ 0, 1 ] }, "is_confirmed": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}": { "get": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Get Facility Access Pass", "operationId": "bdd791a4b012f39a34ad4a3dd23c1438", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Edit Facility Access Pass", "operationId": "1cb19453582e415985878aeac95c6d32", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "code", "image", "user_id", "data_center_id", "firstname", "lastname", "is_changed", "is_confirmed" ], "properties": { "code": { "type": "string" }, "image": { "type": "string", "format": "url" }, "user_id": { "type": "integer" }, "business_unit_id": { "type": "integer" }, "data_center_id": { "type": "integer" }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "phone": { "type": "string" }, "is_changed": { "type": "integer", "enum": [ 0, 1 ] }, "is_confirmed": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/issue": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Issue Facility Access Pass", "operationId": "2467d67f37e093dc1bbab4a4ed8fafe6", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "code", "pick_up_location_id" ], "properties": { "code": { "type": "string" }, "pick_up_location_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/cancel-issue": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Cancel Facility Access Pass", "operationId": "d635ff925716d6a9d83825d5fdb474aa", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/release": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Release Facility Access Pass", "operationId": "f33c9389aa9e7804636a8c2ee0be1918", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/update": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Update Facility Access Pass", "operationId": "060f86a6889a9abf78dfbf7050236dc6", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/replace": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Replace Facility Access Pass", "operationId": "4ecd0f43eef50c94866cfbd3cda2fb85", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "replace_code" ], "properties": { "replace_code": { "type": "string" }, "pick_up_location_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/cancel-replace": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Cancel Replace Facility Access Pass", "operationId": "9ad86ce9299b5a22a0f5a67422618c95", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/terminate": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Terminate Facility Access Pass", "operationId": "3c2aed46ca029595acdf8b84aeedd014", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/facility-access-passes/{id}/collect": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Collect Facility Access Pass", "operationId": "6ad7e6dc3a2c280b359ea9b3e42e7e2e", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests": { "get": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Get List Facility Access Pass Request", "operationId": "fbb50b4ffc82762583d7df7913cc629b", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "submitted", "processing", "rejected", "completed", "canceled", "card_issued", "card_deactivated" ] } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "new", "update", " replace", "terminate" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/{id}": { "get": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Get Facility Access Pass Request Detail", "operationId": "d3716c5973d7e43ca594eb5da3e79356", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/{id}/approve": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Approve Facility Access Pass Request", "operationId": "ca8030dcf3a0739e481350ab1458bd1a", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/{id}/reject": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Reject Facility Access Pass Request", "operationId": "63dc9b99e4178c976db47537e11784b5", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "rejection_reason" ], "properties": { "rejection_reason": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/{id}/complete": { "put": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Complete Facility Access Pass Request", "operationId": "20a3208e59197be90f0a8aafe8f62ffd", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/facility-access-pass-requests/check-facility-access-pass": { "get": { "tags": [ "Admin / Request / Facility Access Pass Request" ], "summary": "Check if Facility Access Pass is ready for processing", "operationId": "387d0b29a01ad96c254ac1f54d5ca9dd", "parameters": [ { "name": "facility_access_pass_request_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "facility_access_pass_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/upload-docs": { "post": { "tags": [ "Admin / File Management" ], "summary": "Upload an encrypted file", "description": "Upload a file to the server", "operationId": "uploadFile", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "customer_id": { "description": "Customer ID", "type": "integer" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] }, "is_encrypt": { "description": "Encrypt or Not Encrypt", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "file": { "type": "string" }, "path": { "type": "string" } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/decrypt-file": { "get": { "tags": [ "Admin / File Management" ], "summary": "Get Content Encrypt File", "operationId": "ddc12b92a17867536862da0f7aacddfe", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/upload-avatar": { "post": { "tags": [ "Admin / File Management" ], "summary": "Upload an avatar image", "description": "Upload a media to the server", "operationId": "5a161dbd87c8523d25ad22d0f5511539", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "file": { "type": "string" }, "path": { "type": "string" } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/single-upload": { "post": { "tags": [ "Admin / File Management" ], "summary": "Upload a file", "description": "Upload a media to the server", "operationId": "955160b2585f29179203384081590d4b", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility", "type" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] }, "type": { "description": "purpose", "type": "string", "enum": [ "avatar", "signature", "company_logo", "quotation", "sales" ] }, "customer_id": { "description": "Customer ID", "type": "integer" }, "is_encrypt": { "description": "Encrypt or Not Encrypt", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "file": { "type": "string" }, "path": { "type": "string" } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/multi-upload": { "post": { "tags": [ "Admin / File Management" ], "summary": "Upload multiple files", "description": "Upload multiple files to the server", "operationId": "87ce6dffeee28e878b78dcf0c7556f35", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "files[]", "visibility", "type" ], "properties": { "files[]": { "description": "The files to upload", "type": "array", "items": { "type": "string", "format": "binary" } }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] }, "type": { "description": "purpose", "type": "string", "enum": [ "avatar", "signature", "company_logo", "quotation", "sales", "facility_access_pass", "remote_hand_support", "nric_passport_docs", "uen_docs" ] }, "customer_id": { "description": "Customer ID", "type": "integer" }, "is_encrypt": { "description": "Encrypt or Not Encrypt", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Files uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "files": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "array", "items": { "type": "string" } } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/storage/single-view": { "get": { "tags": [ "Admin / File Management" ], "summary": "Get Content Private File", "operationId": "4eb1b8245c4767f65df57acead1ce234", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/permissions": { "get": { "tags": [ "Admin / Permission" ], "summary": "Get List Permissions", "parameters": [ { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/permissions/{id}": { "get": { "tags": [ "Admin / Permission" ], "summary": "Get Permission Information", "parameters": [ { "name": "id", "in": "path", "description": "Permission ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/permissions": { "get": { "tags": [ "Admin / Customer / Permission" ], "summary": "Get List Customer Permissions", "parameters": [ { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/prices": { "get": { "tags": [ "Admin / Service / Price" ], "summary": "Get List Prices", "parameters": [ { "name": "service_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Service / Price" ], "summary": "Create New Price", "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "nrc" ], "properties": { "service_id": { "type": "number" }, "term_value": { "type": "number" }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/prices/{id}": { "get": { "tags": [ "Admin / Service / Price" ], "summary": "Get Price Information", "parameters": [ { "name": "id", "in": "path", "description": "Price ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service / Price" ], "summary": "Edit Price", "parameters": [ { "name": "id", "in": "path", "description": "Price ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "term_value", "nrc" ], "properties": { "term_value": { "type": "number" }, "is_default": { "type": "number", "enum": [ 0, 1 ] }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Service / Price" ], "summary": "Delete Price", "parameters": [ { "name": "id", "in": "path", "description": "Price ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/prices/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Price Public", "parameters": [ { "name": "service_id", "in": "query", "required": true, "schema": { "type": "number" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/products": { "get": { "tags": [ "Admin / Product" ], "summary": "Get List Products", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Product" ], "summary": "Create New Product", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/products/{id}": { "get": { "tags": [ "Admin / Product" ], "summary": "Get Product Information", "parameters": [ { "name": "id", "in": "path", "description": "Product ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Product" ], "summary": "Edit Product", "parameters": [ { "name": "id", "in": "path", "description": "Product ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Product" ], "summary": "Delete Product", "parameters": [ { "name": "id", "in": "path", "description": "Product ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/products/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Products Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/projects": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Projects", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Setting" ], "summary": "Create New Project", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/projects/{id}": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get Project Information", "parameters": [ { "name": "id", "in": "path", "description": "Project ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Setting" ], "summary": "Edit Project", "parameters": [ { "name": "id", "in": "path", "description": "Project ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "code" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Setting" ], "summary": "Delete Project", "parameters": [ { "name": "id", "in": "path", "description": "Project ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/projects/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Projects", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations": { "get": { "tags": [ "Admin / Quotation" ], "summary": "Get List Quotations", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "renewal_so_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "submitted", "verified", "rejected", "approved", "expired", "commented", "manager_rejected", "canceled" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Quotation" ], "summary": "Create New Quotation", "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_type", "customer_id", "currency", "rate" ], "properties": { "customer_type": { "type": "string", "enum": [ "corporate", "individual" ] }, "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "currency": { "type": "string" }, "rate": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}": { "get": { "tags": [ "Admin / Quotation" ], "summary": "Get Quotation Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Quotation" ], "summary": "Update a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_type", "customer_id", "currency", "rate" ], "properties": { "customer_type": { "type": "string", "enum": [ "corporate", "individual" ] }, "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "revision": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Quotation" ], "summary": "Delete Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/template": { "get": { "tags": [ "Admin / Quotation" ], "summary": "Get Quotation Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/submit": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Submit a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "department_id", "submit_to_admin" ], "properties": { "department_id": { "type": "number" }, "submit_to_admin": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/verify": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Verify a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/manager-reject": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Reject a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/cancel": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Cancel a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/approve": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Approve a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/reject": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Reject a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/convert-to-sales-order": { "put": { "tags": [ "Admin / Quotation" ], "summary": "Convert a Quotation to Sales", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/allowed-services": { "get": { "tags": [ "Admin / Quotation" ], "summary": "Show allowed service for Sales", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Quotations", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "submitted", "verified", "rejected", "approved", "expired", "commented", "manager_rejected", "canceled" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/attachments": { "get": { "tags": [ "Admin / Quotation / Attachment" ], "summary": "Get List Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Quotation / Attachment" ], "summary": "Create New Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "file_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/attachments/{id}": { "get": { "tags": [ "Admin / Quotation / Attachment" ], "summary": "Get Attachment Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Quotation / Attachment" ], "summary": "Delete Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/services/{id}/attributes": { "put": { "tags": [ "Admin / Quotation / Service" ], "summary": "Update Quotation Service Attribute", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "attributes": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "value": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/services": { "get": { "tags": [ "Admin / Quotation / Service" ], "summary": "Get Quotation Service List", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Quotation / Service" ], "summary": "Create New Quotation Service", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "quantity", "is_custom_price" ], "properties": { "service_id": { "type": "number", "example": 1 }, "is_waived": { "type": "number", "example": 1 }, "quantity": { "type": "number", "example": 1 }, "data_center_id": { "type": "number", "example": 1 }, "project_code_id": { "type": "number", "example": 1 }, "is_custom_price": { "type": "number", "example": 1 }, "term_value": { "type": "number", "example": 6 }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" }, "discount_value": { "type": "number" }, "discount_type": { "type": "string", "example": "%" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/services/{id}": { "get": { "tags": [ "Admin / Quotation / Service" ], "summary": "Get Quotation Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Quotation / Service" ], "summary": "Update Quotation Service", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "quantity", "is_custom_price" ], "properties": { "service_id": { "type": "number", "example": 1 }, "is_waived": { "type": "number", "example": 1 }, "quantity": { "type": "number", "example": 1 }, "data_center_id": { "type": "number", "example": 1 }, "project_code_id": { "type": "number", "example": 1 }, "is_custom_price": { "type": "number", "example": 1 }, "term_value": { "type": "number", "example": 6 }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" }, "discount_value": { "type": "number" }, "discount_type": { "type": "string", "example": "%" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Quotation / Service" ], "summary": "Delete Quotation Service", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/settings": { "get": { "tags": [ "Admin / Quotation / Setting" ], "summary": "Get Quotation Setting", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Quotation / Setting" ], "summary": "Update Quotation Service Setting", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/sign": { "get": { "tags": [ "Admin / Quotation / Sign" ], "summary": "Get Quotation Sign Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Quotation / Sign" ], "summary": "Sign Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "signature": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/invite-to-sign": { "put": { "tags": [ "Admin / Quotation / Sign" ], "summary": "Invite Sign Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "invite_user_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/unsigned": { "put": { "tags": [ "Admin / Quotation / Sign" ], "summary": "Delete Signature", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/terms-and-conditions": { "get": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Get List Terms Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "sort_index", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Create New Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "term_condition_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/terms-and-conditions/{id}": { "get": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Get Term Condition Information", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Update Quotation Service Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "title", "content" ], "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Delete Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Term and Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/quotations/{id}/terms-and-conditions/sort-index": { "put": { "tags": [ "Admin / Quotation / Terms and Conditions" ], "summary": "Sort Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "term_condition_ids" ], "properties": { "term_condition_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests": { "get": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "List Remote Hand Support Requests", "operationId": "9f843238f268c7fe541e859306e566b5", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50 } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "default": "id", "enum": [ "id", "scheduled_date", "created_at", "updated_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "equipment", "cabling", "connectivity", "data_hall_services" ] } }, { "name": "subtype", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "install", "relocate", "replace", "remove", "maintenance", "power_cycle", "move", "link_test", "remote_console", "housekeeping", "photography" ] } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "submitted", "processing", "completed", "rejected" ] } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "scheduled_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "low", "medium", "high", "urgent" ] } } ], "responses": { "200": { "description": "List of Remote Hand Support Requests", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}": { "get": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Show Remote Hand Support Request", "operationId": "006d2a26b951a42079cc32800df877d4", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Remote Hand Support Request details", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/approve": { "post": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Approve Remote Hand Support Request", "operationId": "43a94eedb8e985ee096fd85aa26640dd", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "is_confirmed" ], "properties": { "is_confirmed": { "description": "Confirmation status", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/reject": { "post": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Reject Remote Hand Support Request", "operationId": "3129d17bf0b1d7098c113248d1d30ba6", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "rejection_reason" ], "properties": { "rejection_reason": { "type": "string", "maxLength": 255 } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/update-scheduled-date": { "put": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Update Scheduled Date of Remote Hand Support Request", "operationId": "1258015b546f006398a15929768fe0fa", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "scheduled_date" ], "properties": { "scheduled_date": { "type": "string", "format": "date" }, "expected_start_time": { "description": "Expected start time in H:i:s format", "type": "string", "format": "time" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/update-remarks": { "put": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Update Remarks of Remote Hand Support Request", "operationId": "4f843b8ad5e6e4606e83100843f05ec5", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "remarks" ], "properties": { "remarks": { "type": "string", "maxLength": 9999 } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/upload-attachments": { "post": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Upload Attachment to Remote Hand Support Request", "operationId": "9fe8de30bb47957527840a0b14cf2b96", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "type", "attachments" ], "properties": { "type": { "description": "Confirmation status", "type": "string" }, "attachments": { "type": "array", "items": { "type": "string", "format": "uri" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/attachments/{id}": { "delete": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Remove Attachment from Remote Hand Support Request", "operationId": "dd43b304f8a5ecd8fc225bfba880a850", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/complete": { "post": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Complete Remote Hand Support Request", "operationId": "6d5b6c0a9219f8cc234e390a6a724783", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "comments": { "description": "Comments for completion", "type": "string", "maxLength": 9999 }, "is_confirmed": { "description": "Confirmation status", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/tasks": { "get": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Get All Tasks for Remote Hand Support Request", "operationId": "c707d69eadaddba90f8153cf90ea47bc", "parameters": [ { "name": "id", "in": "path", "description": "Remote Hand Support Request ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Tasks retrieved successfully", "content": { "application/json": { "schema": { "properties": { "tasks": { "type": "array", "items": { "type": "object" } }, "message": { "type": "string", "example": "Tasks retrieved successfully." } }, "type": "object" } } } }, "404": { "description": "Remote Hand Support Request not found", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Remote Hand Support Request not found." } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Create Tasks for Remote Hand Support Request", "operationId": "f8b97349362ffd2cc578127f9b24c1a2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 255 }, "description": { "nullable": true, "type": "string" }, "performers": { "type": "array", "items": { "type": "integer" } }, "time_trackings": { "type": "array", "items": { "properties": { "start_time": { "nullable": true, "type": "string", "format": "datetime" }, "end_time": { "nullable": true, "type": "string", "format": "datetime" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Tasks created successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/tasks/{taskId}": { "get": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Get Task by ID", "operationId": "85b805fc7e7bc1169608d22f82f34d06", "parameters": [ { "name": "id", "in": "path", "description": "Remote Hand Support Request ID", "required": true, "schema": { "type": "integer" } }, { "name": "taskId", "in": "path", "description": "Task ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Task retrieved successfully", "content": { "application/json": { "schema": { "properties": { "task": { "type": "object" }, "message": { "type": "string", "example": "Task retrieved successfully." } }, "type": "object" } } } }, "404": { "description": "Task not found", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Task not found." } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Update Task with Time Trackings", "operationId": "390c9eae6e39841059f43b3f33465625", "parameters": [ { "name": "id", "in": "path", "description": "Remote Hand Support Request ID", "required": true, "schema": { "type": "integer" } }, { "name": "taskId", "in": "path", "description": "Task ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "name": { "nullable": true, "type": "string", "maxLength": 255 }, "description": { "nullable": true, "type": "string" }, "performers": { "type": "array", "items": { "type": "integer" } }, "time_trackings": { "type": "array", "items": { "properties": { "start_time": { "nullable": true, "type": "string", "format": "datetime" }, "end_time": { "nullable": true, "type": "string", "format": "datetime" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Task updated successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Delete Task", "operationId": "34492017b4c4aa814806c8fda0a66c56", "parameters": [ { "name": "id", "in": "path", "description": "Remote Hand Support Request ID", "required": true, "schema": { "type": "integer" } }, { "name": "taskId", "in": "path", "description": "Task ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Task deleted successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/remote-hand-support-requests/{id}/service-charges": { "get": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Get service charges for a Remote Hand Support Request", "operationId": "60063789da1f19e43ffe836ac78bf985", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Service charges retrieved successfully", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "type": { "type": "string" }, "hours": { "type": "number" }, "charges": { "type": "number" } }, "type": "object" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Request / Remote Hand Support Requests" ], "summary": "Update service charges for a Remote Hand Support Request", "operationId": "9ee60c9eea488a62caddb8fdf046c56f", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "type": { "type": "string" }, "hours": { "type": "number" }, "charges": { "type": "number" } }, "type": "object" } } } } }, "responses": { "200": { "description": "Service charges updated successfully", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "type": { "type": "string" }, "hours": { "type": "number" }, "charges": { "type": "number" } }, "type": "object" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/roles": { "get": { "tags": [ "Admin / Role" ], "summary": "Get List Roles", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at", "level" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Role" ], "summary": "Create New Role", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "permission_ids" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "level": { "type": "integer", "example": 5 }, "permission_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/roles/{id}": { "get": { "tags": [ "Admin / Role" ], "summary": "Get Role Information", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Role" ], "summary": "Edit Role", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "permission_ids" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "level": { "type": "integer", "example": 2 }, "permission_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Role" ], "summary": "Delete Role", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/roles/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Roles Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at", "level" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/roles": { "get": { "tags": [ "Admin / Customer / Role" ], "summary": "Get List Customer Roles", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at", "level" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Customer / Role" ], "summary": "Create New Customer Role", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "permission_ids" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "level": { "type": "integer", "example": 5 }, "permission_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/roles/{id}": { "get": { "tags": [ "Admin / Customer / Role" ], "summary": "Get Customer Role Information", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Customer / Role" ], "summary": "Edit Customer Role", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "permission_ids" ], "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "level": { "type": "integer", "example": 2 }, "permission_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Customer / Role" ], "summary": "Delete Customer Role", "parameters": [ { "name": "id", "in": "path", "description": "Role ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/roles/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Customer Roles Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at", "level" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales": { "get": { "tags": [ "Admin / Sales" ], "summary": "Get List Sales", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "quotation_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "submitted", "approved", "processing", "completed", "canceled" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Sales" ], "summary": "Create New Sales", "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_type", "customer_id", "currency", "rate" ], "properties": { "customer_type": { "type": "string", "enum": [ "corporate", "individual" ] }, "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "billing_account_id": { "type": "number" }, "currency": { "type": "string" }, "rate": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}": { "get": { "tags": [ "Admin / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Sales" ], "summary": "Update a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_type", "customer_id", "currency", "rate" ], "properties": { "customer_type": { "type": "string", "enum": [ "corporate", "individual" ] }, "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "billing_account_id": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Sales" ], "summary": "Delete Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/template": { "get": { "tags": [ "Admin / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/delivery-detail": { "get": { "tags": [ "Admin / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/report-detail": { "get": { "tags": [ "Admin / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/renew": { "post": { "tags": [ "Admin / Sales" ], "summary": "Renew Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "services" ], "properties": { "services": { "type": "array", "items": { "properties": { "sales_service_id": { "type": "number" }, "quantity": { "type": "number" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/terminate": { "post": { "tags": [ "Admin / Sales" ], "summary": "Terminate Sales Service", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "services" ], "properties": { "services": { "type": "array", "items": { "properties": { "sales_service_id": { "type": "number" }, "quantity": { "type": "number" }, "service_code_index": { "type": "array", "items": { "type": "number" } } }, "type": "object" } }, "reason": { "type": "string" }, "submit_to_admin": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/submit": { "put": { "tags": [ "Admin / Sales" ], "summary": "Submit a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "department_id", "submit_to_admin" ], "properties": { "department_id": { "type": "number" }, "submit_to_admin": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/approve": { "put": { "tags": [ "Admin / Sales" ], "summary": "Approve a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/reject": { "put": { "tags": [ "Admin / Sales" ], "summary": "Reject a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/process": { "put": { "tags": [ "Admin / Sales" ], "summary": "Process a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/complete": { "put": { "tags": [ "Admin / Sales" ], "summary": "Complete a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/cancel": { "put": { "tags": [ "Admin / Sales" ], "summary": "Cancel a Sales", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Sales", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "is_full", "in": "query", "required": false, "schema": { "type": "number", "enum": [ "0", "1" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/attachments": { "get": { "tags": [ "Admin / Sales / Attachment" ], "summary": "Get List Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Sales / Attachment" ], "summary": "Create New Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "file_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/attachments/{id}": { "get": { "tags": [ "Admin / Sales / Attachment" ], "summary": "Get Attachment Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Sales / Attachment" ], "summary": "Delete Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/services/{id}/attributes": { "put": { "tags": [ "Admin / Sales / Service" ], "summary": "Update Sales Service Attribute", "parameters": [ { "name": "id", "in": "path", "description": "Sales Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "attributes": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "value": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/services": { "get": { "tags": [ "Admin / Sales / Service" ], "summary": "Get Sales Service List", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "description": "Service Status", "required": false, "schema": { "type": "integer" } }, { "name": "is_not_expired", "in": "query", "description": "Service Expired", "required": false, "schema": { "type": "integer" } }, { "name": "is_renewable", "in": "query", "description": "Service Renewable", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Sales / Service" ], "summary": "Create New Sales Service", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "quantity", "is_custom_price", "term_value", "from_date" ], "properties": { "service_id": { "type": "number", "example": 1 }, "is_waived": { "type": "number", "example": 1 }, "quantity": { "type": "number", "example": 1 }, "data_center_id": { "type": "number", "example": 1 }, "project_code_id": { "type": "number", "example": 1 }, "is_custom_price": { "type": "number", "example": 1 }, "term_value": { "type": "number", "example": 6 }, "from_date": { "type": "string" }, "to_date": { "type": "string" }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" }, "discount_value": { "type": "number" }, "discount_type": { "type": "string", "example": "%" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/services-termination": { "get": { "tags": [ "Admin / Sales / Service" ], "summary": "Get Sales Service List", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "description": "Service Status", "required": false, "schema": { "type": "integer" } }, { "name": "is_not_expired", "in": "query", "description": "Service Expired", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/services/{id}": { "get": { "tags": [ "Admin / Sales / Service" ], "summary": "Get Sales Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Sales / Service" ], "summary": "Update Sales Service", "parameters": [ { "name": "id", "in": "path", "description": "Sales Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "service_id", "quantity", "is_custom_price" ], "properties": { "service_id": { "type": "number", "example": 1 }, "is_waived": { "type": "number", "example": 1 }, "quantity": { "type": "number", "example": 1 }, "data_center_id": { "type": "number", "example": 1 }, "project_code_id": { "type": "number", "example": 1 }, "is_custom_price": { "type": "number", "example": 1 }, "term_value": { "type": "number", "example": 6 }, "from_date": { "type": "string" }, "to_date": { "type": "string" }, "nrc": { "type": "number" }, "mrc": { "type": "number" }, "arc": { "type": "number" }, "discount_value": { "type": "number" }, "discount_type": { "type": "string", "example": "%" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Sales / Service" ], "summary": "Delete Sales Service", "parameters": [ { "name": "id", "in": "path", "description": "Sales Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/settings": { "get": { "tags": [ "Admin / Sales / Setting" ], "summary": "Get Sales Setting", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Sales / Setting" ], "summary": "Update Sales Service Setting", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/terms-and-conditions": { "get": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Get List Terms Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "sort_index", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Create New Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "term_condition_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/terms-and-conditions/{id}": { "get": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Get Term Condition Information", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Update Sales Service Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Sales Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "title", "content" ], "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Delete Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Term and Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/terms-and-conditions/sort-index": { "put": { "tags": [ "Admin / Sales / Terms and Conditions" ], "summary": "Sort Terms and Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "term_condition_ids" ], "properties": { "term_condition_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-attributes": { "get": { "tags": [ "Admin / Service Attribute" ], "summary": "Get List Service Attributes", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "text", "option" ] } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "type", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Service Attribute" ], "summary": "Create New Service Attribute", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "type", "format" ], "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "format": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-attributes/{id}": { "get": { "tags": [ "Admin / Service Attribute" ], "summary": "Get Service Attribute Information", "parameters": [ { "name": "id", "in": "path", "description": "Attribute ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service Attribute" ], "summary": "Edit Attribute", "parameters": [ { "name": "id", "in": "path", "description": "Attribute ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "type", "format" ], "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "format": { "type": "string" }, "is_active": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Service Attribute" ], "summary": "Delete Attribute", "parameters": [ { "name": "id", "in": "path", "description": "Attribute ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-attributes/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Attributes Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "text", "option" ] } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "type", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services": { "get": { "tags": [ "Admin / Service" ], "summary": "Get List Services", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "primary", "vas" ] } }, { "name": "product_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "category_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Service" ], "summary": "Create New Service", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name", "type", "category_id", "has_nrc", "has_mrc", "has_arc" ], "properties": { "name": { "type": "string" }, "type": { "type": "string", "enum": [ "primary", "vas" ] }, "category_id": { "type": "number" }, "has_nrc": { "type": "number", "enum": [ 0, 1 ] }, "has_mrc": { "type": "number", "enum": [ 0, 1 ] }, "has_arc": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/{id}": { "get": { "tags": [ "Admin / Service" ], "summary": "Get Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service" ], "summary": "Edit Service", "parameters": [ { "name": "id", "in": "path", "description": "Service ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "name": { "type": "string" }, "category_id": { "type": "number" }, "is_active": { "type": "number", "enum": [ 0, 1 ] }, "description": { "type": "string" }, "is_physical_service": { "type": "number", "enum": [ 0, 1 ] }, "has_service_id": { "type": "number", "enum": [ 0, 1 ] }, "has_circuit_id": { "type": "number", "enum": [ 0, 1 ] }, "is_split_line": { "type": "number", "enum": [ 0, 1 ] }, "has_data_center": { "type": "number", "enum": [ 0, 1 ] }, "has_vas": { "type": "number", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Service" ], "summary": "Delete Service", "parameters": [ { "name": "id", "in": "path", "description": "Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/services/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Services Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "primary", "vas" ] } }, { "name": "product_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "category_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "so_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-reports": { "get": { "tags": [ "Admin / Service Report" ], "summary": "Get List Service Reports", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sales_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "completed" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "created_at", "service_report_code" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Service Report" ], "summary": "Create New Service Reports", "requestBody": { "content": { "application/json": { "schema": { "required": [ "services" ], "properties": { "sales_id": { "type": "number" }, "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "serviced_by_account_id": { "type": "number" }, "appointment_date": { "type": "string", "format": "date-time" }, "start_date": { "type": "string", "format": "date-time" }, "end_date": { "type": "string", "format": "date-time" }, "remarks": { "type": "string" }, "address": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "city": { "type": "string" }, "services": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "type": { "type": "string" } }, "type": "object" } }, "equipments": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "serial_number": { "type": "string" }, "quantity": { "type": "number" } }, "type": "object" } }, "terms_conditions": { "type": "array", "items": { "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-reports/{id}": { "get": { "tags": [ "Admin / Service Report" ], "summary": "Get Service Report Information", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Service Report" ], "summary": "Update Service Reports", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "services" ], "properties": { "customer_id": { "type": "number" }, "business_unit_id": { "type": "number" }, "contact_account_id": { "type": "number" }, "serviced_by_account_id": { "type": "number" }, "appointment_date": { "type": "string", "format": "date-time" }, "start_date": { "type": "string", "format": "date-time" }, "end_date": { "type": "string", "format": "date-time" }, "remarks": { "type": "string" }, "address": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "city": { "type": "string" }, "services": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "type": { "type": "string" } }, "type": "object" } }, "equipments": { "type": "array", "items": { "properties": { "id": { "type": "number" }, "service_id": { "type": "number" }, "serial_number": { "type": "string" }, "quantity": { "type": "number" } }, "type": "object" } }, "terms_conditions": { "type": "array", "items": { "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Service Report" ], "summary": "Delete Service Report", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-reports/{id}/template": { "get": { "tags": [ "Admin / Service Report" ], "summary": "Get Service Report Information", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-reports/{id}/complete": { "put": { "tags": [ "Admin / Service Report" ], "summary": "Complete a Service Report", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/service-reports/{id}/sign": { "put": { "tags": [ "Admin / Service Report" ], "summary": "Sign a Service Report", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "signature", "signatory_name" ], "properties": { "signature": { "type": "string" }, "signatory_name": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/settings": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Settings", "parameters": [ { "name": "groups[]", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "general", "system", "template" ] } } }, { "name": "keys[]", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "password_expiry_period", "max_failed_authentication", "max_failed_otp", "company_logo", "company_name", "uen", "address", "customer_care_email", "billing_email", "technical_assistance_email", "quote_sale_declaration", "payment_definitions", "completion_letter_bottom_script", "quotation_validity_period", "gst", "data_protection_policy", "quotation_notifications_cc_to" ] } } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/settings/update": { "put": { "tags": [ "Admin / Setting" ], "summary": "Update Settings", "requestBody": { "content": { "application/json": { "schema": { "properties": { "items": { "type": "array", "items": { "properties": { "key": { "description": "Key of the object", "type": "string" }, "content": { "description": "Content of the object", "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/settings/template/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Settings", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/settings/service-report/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Settings", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/settings/hand-support-charges/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Settings", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/tasks": { "get": { "tags": [ "Admin / Sales / Task" ], "summary": "Get Sales Task List", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Sales / Task" ], "summary": "Create New Task", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "type", "department_id", "assignee_account_id", "description" ], "properties": { "type": { "type": "string", "enum": [ "engineering", "field", "provisioning", "others" ] }, "department_id": { "type": "number", "example": 1 }, "assignee_account_id": { "type": "number", "example": 1 }, "description": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/tasks/{id}": { "get": { "tags": [ "Admin / Sales / Task" ], "summary": "Get Sales Task Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales Task ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/tasks/{id}/reject": { "put": { "tags": [ "Admin / Sales / Task" ], "summary": "Reject a Task", "parameters": [ { "name": "id", "in": "path", "description": "Sales Task ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/tasks/{id}/resolve": { "put": { "tags": [ "Admin / Sales / Task" ], "summary": "Resolve a Task", "parameters": [ { "name": "id", "in": "path", "description": "Sales Task ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/terms-conditions": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get List Terms and Conditions", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "title", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Setting" ], "summary": "Create New Term and Condition", "requestBody": { "content": { "application/json": { "schema": { "required": [ "title", "content" ], "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/terms-conditions/{id}": { "get": { "tags": [ "Admin / Setting" ], "summary": "Get Term and Condition Information", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Setting" ], "summary": "Edit Term Condition", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "title", "content" ], "properties": { "title": { "type": "string" }, "content": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "delete": { "tags": [ "Admin / Setting" ], "summary": "Delete Term Condition", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/terms-conditions/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Products Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "title", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/{id}/termination-requests": { "get": { "tags": [ "Admin / Sales / Termination Request" ], "summary": "Get List Sales Termination Requests", "operationId": "865629cf79e988ca452ea21b8308bf56", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/termination-requests/{id}/approve": { "post": { "tags": [ "Admin / Sales / Termination Request" ], "summary": "Approve Termination Request", "operationId": "d032afd6630c3dd0486f431660727bbe", "parameters": [ { "name": "id", "in": "path", "description": "Termination Request ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/sales/termination-requests/{id}/reject": { "post": { "tags": [ "Admin / Sales / Termination Request" ], "summary": "Reject Termination Request", "operationId": "8e40d89f9b1356b4db40e69869d1d4f0", "parameters": [ { "name": "id", "in": "path", "description": "Termination Request ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "reason" ], "properties": { "reason": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/users": { "get": { "tags": [ "Admin / Customer / User" ], "summary": "Get List Users", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Admin / Customer / User" ], "summary": "Create New User", "requestBody": { "content": { "application/json": { "schema": { "required": [ "customer_id", "is_master_admin", "firstname", "email", "phone", "business_unit_ids", "customer_id", "role_ids", "is_all_business_unit" ], "properties": { "customer_id": { "type": "number" }, "is_master_admin": { "type": "number", "enum": [ 0, 1 ] }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "email": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "phone": { "type": "string" }, "is_all_business_unit": { "type": "number", "enum": [ 0, 1 ] }, "business_unit_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/users/{id}": { "get": { "tags": [ "Admin / Customer / User" ], "summary": "Get Customer User Information", "parameters": [ { "name": "id", "in": "path", "description": "Customer User ID", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Customer / User" ], "summary": "Update Customer User: Info and Active Deactivated", "parameters": [ { "name": "id", "in": "path", "description": "Customer User ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "is_master_admin", "firstname", "phone", "business_unit_ids", "customer_id", "role_ids", "is_all_business_unit" ], "properties": { "is_master_admin": { "type": "number", "enum": [ 0, 1 ] }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "phone": { "type": "string" }, "is_all_business_unit": { "type": "number", "enum": [ 0, 1 ] }, "business_unit_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "is_active": { "type": "number", "enum": [ 0, 1 ] }, "is_display_code": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/users/all-users": { "get": { "tags": [ "Admin / Customer / User" ], "summary": "Get List Users", "operationId": "3c89056fe0f89843498876ebed1d2c96", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "visitor", "contractor" ] } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "fullname", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/customers/users/public": { "get": { "tags": [ "Admin / Public" ], "summary": "Get List Users", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "fullname", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests": { "get": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Get List Visitor Access Pass Requests", "operationId": "2a3f9df2c4361aaf28c57235e607c464", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "visit_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests/{id}": { "get": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Get Visitor Access Pass Request Detail", "operationId": "9ade5841ca8ee3efe67ee3f77699d056", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Update Visitor Access Pass Request", "operationId": "d7607ba332ae00dfb447d00bada859b0", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "host_account_id" ], "properties": { "host_account_id": { "type": "integer" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests/{id}/visitors": { "get": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Get List Visitor Access Pass Requests", "operationId": "03d6f4620eaee8ec5b4c2ff90cda7304", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests/visitors/{id}/login": { "put": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Approve Visitor Access Pass Request", "operationId": "dc62d2f8936c2b20742e68ebc37a93c2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "access_pass" ], "properties": { "access_pass": { "type": "string", "example": "ACDC02222" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests/visitors/{id}/logout": { "put": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Log Out Visitor Access Pass Visitor", "operationId": "dc60a521b4e857562402fee300e13a89", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/requests/visitor-access-pass-requests/{id}/visitor-logs": { "get": { "tags": [ "Admin / Request / Visitor Access Pass Requests" ], "summary": "Get List Visitor Access Pass Requests", "operationId": "20a99c1d8738e7c0a8ca91eb0c9b160d", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "log_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/admin/login": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Login", "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "success" }, "is_first_login": { "type": "string", "example": "true" }, "secret_key": { "type": "string", "example": "H3ANBFOQULFGGPTQ" }, "qr_code": { "type": "string", "example": "data:image/svg+xml;base64,..." }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "string", "example": "31536000" }, "access_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }, "type": "object" } } } } } } }, "/api/v1/customer/login": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Login", "operationId": "36485be274e201d79ed044a5968dddd6", "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "success" }, "is_first_login": { "type": "string", "example": "true" }, "secret_key": { "type": "string", "example": "H3ANBFOQULFGGPTQ" }, "qr_code": { "type": "string", "example": "data:image/svg+xml;base64,..." }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "string", "example": "31536000" }, "access_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }, "type": "object" } } } } } } }, "/api/v1/admin/verify-otp": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Verify OTP after login", "requestBody": { "content": { "application/json": { "schema": { "properties": { "otp": { "type": "string" }, "type": { "type": "string" }, "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/customer/verify-otp": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Verify OTP after login", "operationId": "9e853b647f38e77274752194065b58b4", "requestBody": { "content": { "application/json": { "schema": { "properties": { "otp": { "type": "string" }, "type": { "type": "string" }, "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/admin/send-otp": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Send OTP after login", "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/customer/send-otp": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Send OTP after login", "operationId": "05f593b495260180f41eb99dc33a9c54", "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/admin/issue-token": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Issue token after choosing account", "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "type": "string" }, "company": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "string", "example": "31536000" }, "access_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." }, "refresh_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }, "type": "object" } } } } } } }, "/api/v1/customer/issue-token": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Issue token after choosing account", "operationId": "ba7eb72e0862409e5918c0df7d477a77", "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "type": "string" }, "company": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "string", "example": "31536000" }, "access_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." }, "refresh_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }, "type": "object" } } } } } } }, "/api/v1/customer/accounts": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Valid Accounts", "operationId": "66fd7a4d13ab96fd230d98cfafd7663f", "requestBody": { "content": { "application/json": { "schema": { "properties": { "code": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/admin/forget-password": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Forget Password To Reset Password", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "properties": { "email": { "type": "string" }, "callback_url": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/customer/forget-password": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Forget Password To Reset Password", "operationId": "4f448539cd16ebb7d84f9f60347838dd", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "properties": { "email": { "type": "string" }, "customer_id": { "type": "integer" }, "callback_url": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/admin/reset-password": { "put": { "tags": [ "Public / Admin / Auth" ], "summary": "Reset Password", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email", "otp", "password" ], "properties": { "email": { "type": "string" }, "otp": { "type": "string" }, "password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "required": [ "message" ], "properties": { "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/customer/reset-password": { "put": { "tags": [ "Public / Customer / Auth" ], "summary": "Reset Password", "operationId": "9836a9a53f9f8c1129ecfcefbceea466", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email", "otp", "password" ], "properties": { "email": { "type": "string" }, "otp": { "type": "string" }, "password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "required": [ "message" ], "properties": { "message": { "type": "string", "example": "success" } }, "type": "object" } } } } } } }, "/api/v1/admin/check-otp": { "post": { "tags": [ "Public / Admin / Auth" ], "summary": "Check OTP is expired or not", "requestBody": { "content": { "application/json": { "schema": { "properties": { "email": { "type": "string" }, "otp": { "type": "string" }, "type": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Your OTP is valid!" } }, "type": "object" } } } }, "400": { "description": "Failed response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Your OTP is expired!" } }, "type": "object" } } } } } } }, "/api/v1/customer/check-otp": { "post": { "tags": [ "Public / Customer / Auth" ], "summary": "Check OTP is expired or not", "operationId": "78ce89d169aaf70ba0f3c9a41a314dcb", "requestBody": { "content": { "application/json": { "schema": { "properties": { "email": { "type": "string" }, "otp": { "type": "string" }, "type": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Your OTP is valid!" } }, "type": "object" } } } }, "400": { "description": "Failed response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Your OTP is expired!" } }, "type": "object" } } } } } } }, "/api/v1/customer/me": { "get": { "tags": [ "Customer / Account" ], "summary": "Get My Profile", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountUserDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / Account" ], "summary": "Edit My Profile", "operationId": "e7c6025cea9e449a50a0d637c81d9e59", "requestBody": { "content": { "application/json": { "schema": { "properties": { "avatar": { "type": "string", "format": "uri", "example": "https://example.com/file.jpg" }, "signature": { "type": "string", "format": "uri", "example": "https://example.com/file.jpg" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/me/password": { "put": { "tags": [ "Customer / Account" ], "summary": "Change My Password", "requestBody": { "content": { "application/json": { "schema": { "required": [ "password", "current_password" ], "properties": { "code": { "type": "string" }, "password": { "type": "string" }, "current_password": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Success!" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/me/switch-account": { "post": { "tags": [ "Customer / Account" ], "summary": "Switch to another account", "requestBody": { "content": { "application/json": { "schema": { "required": [ "target_account_id" ], "properties": { "target_account_id": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "true" }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "string", "example": "31536000" }, "access_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." }, "refresh_token": { "type": "string", "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/me/logout": { "post": { "tags": [ "Customer / Account" ], "summary": "Logout", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Successfully logged out!" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/my-business-units/public": { "get": { "tags": [ "Customer / Business Unit" ], "summary": "Get My List Business Unit", "parameters": [ { "name": "is_active", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/business-units/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Business Unit Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "is_default", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/contractor-access-pass-requests": { "get": { "tags": [ "Customer / Request / Contractor Access Pass Requests" ], "summary": "Get List Contractor Access Pass Requests", "operationId": "63a562cf4a1b33e9a7f2bc00cfe4f67d", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "visit_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Customer / Request / Contractor Access Pass Requests" ], "summary": "Create Contractor Access Pass Request", "description": "Create a new Contractor Access Pass Request", "operationId": "666ae0270ac897e4927d52451440a2ee", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer", "example": 1 }, "start_date": { "type": "string", "format": "date", "example": "2023-10-01" }, "end_date": { "type": "string", "format": "date", "example": "2023-10-31" }, "start_time": { "type": "string", "format": "time", "example": "09:00:00" }, "end_time": { "type": "string", "format": "time", "example": "18:00:00" }, "in_out_type": { "type": "string", "enum": [ "single", "multiple" ], "example": "single" }, "location_dc_id": { "type": "integer", "example": 1 }, "scope_of_work": { "type": "string", "example": "Maintenance work" }, "host_account_id": { "type": "integer", "example": 1 }, "contractors": { "type": "array", "items": { "properties": { "name": { "type": "string", "example": "John Doe" }, "nric": { "type": "string", "example": "S1234567A" }, "passport": { "type": "string", "example": "A12345678" }, "fin": { "type": "string", "example": "F12345678" }, "work_permit_expiry_date": { "type": "string", "format": "date", "example": "2024-12-31" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Contractor Access Pass Request created successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/contractor-access-pass-requests/{id}": { "get": { "tags": [ "Customer / Request / Contractor Access Pass Requests" ], "summary": "Get Contractor Access Pass Request Detail", "operationId": "70461d962bda8da2cf180e12ee845762", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / Request / Contractor Access Pass Requests" ], "summary": "Update Contractor Access Pass Request", "operationId": "08ea41eaf921db361b7714a7dd2d9d17", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "business_unit_id", "start_date", "end_date", "start_time", "end_time", "in_out_type", "location_dc_id", "scope_of_work", "host_account_id", "contractors" ], "properties": { "business_unit_id": { "type": "integer" }, "start_date": { "type": "string", "format": "date" }, "end_date": { "type": "string", "format": "date" }, "start_time": { "type": "string", "format": "time" }, "end_time": { "type": "string", "format": "time" }, "in_out_type": { "type": "string", "enum": [ "single", "multiple" ] }, "location_dc_id": { "type": "integer" }, "scope_of_work": { "type": "string" }, "host_account_id": { "type": "integer" }, "contractors": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "work_permit_expiry_date": { "type": "string", "format": "date" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Contractor Access Pass Request updated successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/currencies/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Currencies", "parameters": [ { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "code", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/access-pass-quotas": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get Customer Access Pass Quotas", "operationId": "68920d0d461c58566130f383997e9b17", "parameters": [ { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created_at", "updated_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1 } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/customer": { "get": { "tags": [ "Customer / Customer" ], "summary": "Get Customer Information", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / Customer" ], "summary": "Edit Customer", "requestBody": { "content": { "application/json": { "schema": { "properties": { "company_name": { "type": "string" }, "uen": { "type": "string" }, "company_type": { "type": "string" }, "activity": { "type": "string" }, "registration_date": { "type": "string", "format": "date" }, "company_capital": { "type": "string" }, "uen_docs": { "type": "array", "items": { "type": "string", "format": "url" } }, "company_email": { "type": "string", "format": "email" }, "fullname": { "type": "string" }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "nric_passport_docs": { "type": "array", "items": { "type": "string", "format": "url" } }, "phone_number": { "type": "string" }, "address": { "type": "string" }, "country": { "type": "string" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "credit_limit": { "type": "number" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/summary": { "get": { "tags": [ "Customer / Request" ], "summary": "Get Summary Customer Requests", "operationId": "a3f52b7a0ea8f7f982e522c48d289f0b", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/recent-requests": { "get": { "tags": [ "Customer / Request" ], "summary": "Get Recent Customer Requests", "operationId": "6576fefdf1f1e7562b854441b66cac2a", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/data-centers/visit-locations/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Data Centers", "operationId": "2b97f79e17d9e1205eb168cc1d1303c6", "parameters": [ { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "expired_date", "in": "query", "required": false, "schema": { "type": "date", "format": "Y-m-d" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/data-centers/access-pass-locations/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Data Centers for Access Pass", "operationId": "02d9c85e43b867b877b50004bfe4b4a2", "parameters": [ { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "expired_date", "in": "query", "required": false, "schema": { "type": "date", "format": "Y-m-d" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/delivery-orders/{id}/template": { "get": { "tags": [ "Customer / Delivery Order" ], "summary": "Get Delivery Order Information", "parameters": [ { "name": "id", "in": "path", "description": "Delivery Order ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/facility-access-passes": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get List Facility Access Passes", "operationId": "71ec9cca7051364d97923697a8e04315", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pending", "in_used", "issued", "terminating", "terminated", "replacing", "replaced" ] } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/facility-access-passes/public": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get List Facility Access Passes Public", "operationId": "4c747a21774a8c327d9b649a1a24b1fc", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pending", "in_used", "issued", "terminating", "terminated", "replacing", "replaced" ] } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "activated", "deactivated" ] } }, { "name": "is_updatable", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created_at", "id", "code" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/facility-access-passes/my-access-passes": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get My Access Passes", "operationId": "9b3ac817b4ea8698cd277c1e2f2aa585", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "in_used", "issued", "terminating", "terminated", "replacing", "replaced" ] } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_updatable", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get List Facility Access Pass Request", "operationId": "09885ea35dc3b78bcbbfb446f1eeca58", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "submitted", "approved", "rejected", "processing", "completed", "canceled", "card_issued", "card_deactivated" ] } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "new", "update", "replace", "terminate" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created_at", "id" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/{id}": { "get": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Get Facility Access Pass Request by ID", "operationId": "1f9599fe22f248f04dbc97dcfeb26ceb", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Facility Access Pass Request", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/new-request": { "post": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Create Facility Access Pass Request", "operationId": "1bc2c27a53c12641584aa98060e8f399", "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_holders": { "type": "array", "items": { "properties": { "user_id": { "type": "integer" }, "data_center_ids": { "type": "array", "items": { "type": "integer" } }, "image": { "type": "string", "format": "url" } }, "type": "object" } }, "estimated_charge": { "type": "number", "format": "float" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/{id}/new-request": { "put": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Update Facility Access Pass Request", "operationId": "1503e35ab1c7dcb0ec34f9ed9c6997cf", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Facility Access Pass Request", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_holders": { "type": "array", "items": { "properties": { "user_id": { "type": "integer" }, "data_center_ids": { "type": "array", "items": { "type": "integer" } }, "image": { "type": "string", "format": "url" } }, "type": "object" } }, "estimated_charge": { "type": "number", "format": "float" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/update-request": { "post": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Create Facility Access Pass Request", "operationId": "4d5016a19a8e731e18f442c2a88576f6", "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_passes": { "type": "array", "items": { "properties": { "facility_access_pass_id": { "type": "integer" }, "new_data_center_id": { "type": "integer" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/{id}/update-request": { "put": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Update Facility Access Pass Request", "operationId": "6f5d1def35040c2e99b6da98aaf8ab3a", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Facility Access Pass Request", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_passes": { "type": "array", "items": { "properties": { "facility_access_pass_id": { "type": "integer" }, "new_data_center_id": { "type": "integer" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/replace-request": { "post": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Create Replacement Facility Access Pass Request", "operationId": "225c72c9530017b906a038962ee8a7db", "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_ids": { "type": "array", "items": { "type": "integer" } }, "estimated_charge": { "type": "number", "format": "float" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/{id}/replace-request": { "put": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Update Replacement Facility Access Pass Request", "operationId": "c4ef9fcf430c229efb3b8489ce49b45a", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Facility Access Pass Request", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_ids": { "type": "array", "items": { "type": "integer" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/terminate-request": { "post": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Create Termination Facility Access Pass Request", "operationId": "033ed3ba5e108a40f89e4bb7fa18d66f", "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_ids": { "type": "array", "items": { "type": "integer" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/facility-access-pass-requests/{id}/terminate-request": { "put": { "tags": [ "Customer / Request / Facility Access Pass Request" ], "summary": "Update Termination Facility Access Pass Request", "operationId": "ff1180ecb4638d09a2ef66afe14273c3", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Facility Access Pass Request", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer" }, "access_pass_ids": { "type": "array", "items": { "type": "integer" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/upload-docs": { "post": { "tags": [ "Customer / File Management" ], "summary": "Upload an encrypted file", "description": "Upload a file to the server", "operationId": "uploadFile", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "customer_id": { "description": "Customer ID", "type": "integer" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] }, "is_encrypt": { "description": "Encrypt or Not Encrypt", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "file": { "type": "string" }, "path": { "type": "string" } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/upload-avatar": { "post": { "tags": [ "Customer / File Management" ], "summary": "Upload an avatar image", "description": "Upload a media to the server", "operationId": "98cf3e1aac95f39f5d06af52694da177", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "file": { "type": "string" }, "path": { "type": "string" } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/single-upload": { "post": { "tags": [ "Customer / File Management" ], "summary": "Upload a file", "description": "Upload a media to the server", "operationId": "96d68f738422c8dd81de0022b2f6b64b", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file", "visibility", "type" ], "properties": { "file": { "description": "The file to upload", "type": "string", "format": "binary" }, "visibility": { "description": "public or private", "type": "string", "enum": [ "public", "private" ] }, "type": { "description": "purpose", "type": "string", "enum": [ "avatar", "signature", "quotation", "sales", "facility_access_pass", "uen_docs", "nric_passport_docs", "company_logo", "remote_hand_support" ] }, "customer_id": { "description": "Customer ID", "type": "integer" }, "is_encrypt": { "description": "Encrypt or Not Encrypt", "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "File uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "files": { "type": "array", "items": { "type": "object" } } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/multi-upload": { "post": { "tags": [ "Customer / File Management" ], "summary": "Upload multiple files", "operationId": "0e466fcbcc3f71c08dc5e8893c2cf2ab", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "visibility", "type", "files[]" ], "properties": { "visibility": { "type": "string", "enum": [ "public", "private" ] }, "customer_id": { "type": "integer" }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "type": { "type": "string", "enum": [ "avatar", "uen_docs", "nric_passport_docs", "signature", "company_logo", "quotation", "sales", "facility_access_pass", "remote_hand_support" ] }, "files[]": { "type": "array", "items": { "type": "string", "format": "binary" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Files uploaded successfully", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean" }, "files": { "type": "array", "items": { "type": "object" } } }, "type": "object" } } } }, "400": { "description": "File upload failed", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/decrypt-file": { "get": { "tags": [ "Customer / File Management" ], "summary": "Get Content Encrypt File", "operationId": "aee2c40b180fbf9f34a86fba9c2735ea", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/storage/single-view": { "get": { "tags": [ "Customer / File Management" ], "summary": "Get Content Private File", "operationId": "96564b197662148c28e3393942f4d38a", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations": { "get": { "tags": [ "Customer / Quotation" ], "summary": "Get List Quotations", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "renewal_so_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "submitted", "rejected", "approved", "expired", "commented" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at", "verified" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}": { "get": { "tags": [ "Customer / Quotation" ], "summary": "Get Quotation Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/template": { "get": { "tags": [ "Customer / Quotation" ], "summary": "Get Quotation Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/approve": { "put": { "tags": [ "Customer / Quotation" ], "summary": "Approve a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "po_file_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/reject": { "put": { "tags": [ "Customer / Quotation" ], "summary": "Reject a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/comment": { "put": { "tags": [ "Customer / Quotation" ], "summary": "Comment a Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "comment": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/attachments": { "get": { "tags": [ "Customer / Quotation / Attachment" ], "summary": "Get List Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/attachments/{id}": { "get": { "tags": [ "Customer / Quotation / Attachment" ], "summary": "Get Attachment Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/services": { "get": { "tags": [ "Customer / Quotation / Service" ], "summary": "Get Quotation Service List", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/services/{id}": { "get": { "tags": [ "Customer / Quotation / Service" ], "summary": "Get Quotation Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/settings": { "get": { "tags": [ "Customer / Quotation / Setting" ], "summary": "Get Quotation Setting", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/sign": { "get": { "tags": [ "Customer / Quotation / Sign" ], "summary": "Get Quotation Sign Information", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / Quotation / Sign" ], "summary": "Sign Quotation", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "signature": { "type": "string" }, "po_file_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/unsigned": { "put": { "tags": [ "Customer / Quotation / Sign" ], "summary": "Delete Signature", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/{id}/terms-and-conditions": { "get": { "tags": [ "Customer / Quotation / Terms and Conditions" ], "summary": "Get List Terms Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Quotation ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "sort_index", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/quotations/terms-and-conditions/{id}": { "get": { "tags": [ "Customer / Quotation / Terms and Conditions" ], "summary": "Get Term Condition Information", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/remote-hand-support-requests": { "get": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "List Remote Hand Support Requests", "operationId": "bad0cfeaadbd112ef316c71f35d925fe", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50 } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "default": "id", "enum": [ "id", "scheduled_date", "created_at", "updated_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "equipment", "cabling", "connectivity", "data_hall_services" ] } }, { "name": "subtype", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "install", "relocate", "replace", "remove", "maintenance", "power_cycle", "move", "link_test", "remote_console", "housekeeping", "photography" ] } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "submitted", "processing", "completed", "rejected" ] } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "scheduled_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "low", "medium", "high", "urgent" ] } } ], "responses": { "200": { "description": "List of Remote Hand Support Requests", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "Create Remote Hand Support Request", "operationId": "9b108421e18ef2ad66225a915763774c", "requestBody": { "content": { "application/json": { "schema": { "properties": { "type": { "type": "string", "example": "equipment" }, "subtype": { "type": "string", "example": "install" }, "business_unit_id": { "type": "integer", "example": 1 }, "location_dc_id": { "type": "integer", "example": 1 }, "scheduled_date": { "type": "string", "format": "date", "example": "2023-10-01" }, "expected_start_time": { "type": "string", "format": "time", "example": "14:00:00" }, "priority": { "type": "string", "example": "high" }, "subject": { "type": "string", "example": "Remote hand support request for server" }, "description": { "type": "string", "example": "Please assist with the server setup." }, "instruct_attachments": { "type": "array", "items": { "type": "string", "format": "url", "example": "https://example.com/file1.jpg" } }, "is_required_before_photo": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "is_required_after_photo": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "is_required_customer_contact": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "customer_contacts": { "type": "array", "items": { "properties": { "firstname": { "type": "string", "example": "John" }, "lastname": { "type": "string", "example": "Doe" }, "email": { "type": "string", "format": "email", "example": "john.doe@example.com" }, "phone": { "type": "string", "example": "+1234567890" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Remote Hand Support Request created successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/remote-hand-support-requests/{id}": { "get": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "Show Remote Hand Support Request", "operationId": "9b54044a4f6d26b8174b07d2cf4c4a66", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Remote Hand Support Request details", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "Update Remote Hand Support Request", "operationId": "97dc2b4dc3a8c13226d2dca95f3442f8", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "business_unit_id": { "type": "integer", "example": 1 }, "location_dc_id": { "type": "integer", "example": 1 }, "scheduled_date": { "type": "string", "format": "date", "example": "2025-10-01" }, "expected_start_time": { "type": "string", "format": "time", "example": "14:00:00" }, "priority": { "type": "string", "example": "high" }, "subject": { "type": "string", "example": "Updated Remote hand support request for server" }, "description": { "type": "string", "example": "Please assist with the updated server setup." }, "instruct_attachments": { "type": "array", "items": { "type": "string", "format": "url", "example": "https://example.com/file1.jpg" } }, "is_required_before_photo": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "is_required_after_photo": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "is_required_customer_contact": { "type": "integer", "enum": [ 0, 1 ], "example": 1 }, "customer_contacts": { "type": "array", "items": { "properties": { "firstname": { "type": "string", "example": "John" }, "lastname": { "type": "string", "example": "Doe" }, "email": { "type": "string", "format": "email", "example": "john.doe@example.com" }, "phone": { "type": "string", "example": "(+12)34567890" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Remote Hand Support Request updated successfully", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/remote-hand-support-requests/{id}/service-charges": { "get": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "Get service charges for a completed Remote Hand Support Request (customer)", "operationId": "66ed98af77cd785ebafce78f1a71f4d3", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Service charges retrieved successfully", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "type": { "type": "string" }, "hours": { "type": "number" }, "charges": { "type": "number" } }, "type": "object" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/remote-hand-support-requests/{id}/tasks": { "get": { "tags": [ "Customer / Request / Remote Hand Support Requests" ], "summary": "Get tasks for a Remote Hand Support Request (customer)", "operationId": "0e412b9a4698bf137a724901878f87bc", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Tasks retrieved successfully", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "type": "object" } } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/roles/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Customer Roles Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at", "level" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales": { "get": { "tags": [ "Customer / Sales" ], "summary": "Get List Sales", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "submitted", "approved", "processing", "completed", "canceled" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}": { "get": { "tags": [ "Customer / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}/template": { "get": { "tags": [ "Customer / Sales" ], "summary": "Get Sales Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Sales Public", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "by_account_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "created", "submitted", "approved", "processing", "completed", "canceled" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "status", "total_amount", "currency", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}/attachments": { "get": { "tags": [ "Customer / Sales / Attachment" ], "summary": "Get List Attachment", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/attachments/{id}": { "get": { "tags": [ "Customer / Sales / Attachment" ], "summary": "Get Attachment Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales Attachment ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}/services": { "get": { "tags": [ "Customer / Sales / Service" ], "summary": "Get Sales Service List", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/services/{id}": { "get": { "tags": [ "Customer / Sales / Service" ], "summary": "Get Sales Service Information", "parameters": [ { "name": "id", "in": "path", "description": "Sales Service ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}/settings": { "get": { "tags": [ "Customer / Sales / Setting" ], "summary": "Get Sales Setting", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/{id}/terms-and-conditions": { "get": { "tags": [ "Customer / Sales / Terms and Conditions" ], "summary": "Get List Terms Conditions", "parameters": [ { "name": "id", "in": "path", "description": "Sales ID", "required": true, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "sort_index", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/sales/terms-and-conditions/{id}": { "get": { "tags": [ "Customer / Sales / Terms and Conditions" ], "summary": "Get Term Condition Information", "parameters": [ { "name": "id", "in": "path", "description": "Term Condition ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/services": { "get": { "tags": [ "Customer / Service" ], "summary": "Get List Services", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sales_id", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "name", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/service-reports/{id}/template": { "get": { "tags": [ "Customer / Service Report" ], "summary": "Get Service Report Information", "parameters": [ { "name": "id", "in": "path", "description": "Service Report ID", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/settings/data-policy": { "get": { "tags": [ "Customer / Setting" ], "summary": "Get Data Policy", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "content": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/settings/template/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Settings", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/settings/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Settings", "parameters": [ { "name": "keys[]", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "access_pass_charge" ] } } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/users": { "get": { "tags": [ "Customer / User" ], "summary": "Get List Users", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "role_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "is_full", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Customer / User" ], "summary": "Create New User", "requestBody": { "content": { "application/json": { "schema": { "required": [ "is_master_admin", "firstname", "email", "phone", "business_unit_ids", "customer_id", "role_ids", "is_all_business_unit" ], "properties": { "is_master_admin": { "type": "number", "enum": [ 0, 1 ] }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "is_all_business_unit": { "type": "number", "enum": [ 0, 1 ] }, "business_unit_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/users/{id}": { "get": { "tags": [ "Customer / User" ], "summary": "Get User Information", "parameters": [ { "name": "id", "in": "path", "description": "User ID", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "put": { "tags": [ "Customer / User" ], "summary": "Update Customer User: Info and Activate Deactivate", "parameters": [ { "name": "id", "in": "path", "description": "Customer User ID", "required": true, "schema": { "type": "number" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "is_master_admin", "firstname", "phone", "business_unit_ids", "customer_id", "role_ids", "is_all_business_unit" ], "properties": { "is_master_admin": { "type": "number", "enum": [ 0, 1 ] }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "phone": { "type": "string" }, "nric": { "type": "string" }, "passport": { "type": "string" }, "fin": { "type": "string" }, "is_all_business_unit": { "type": "number", "enum": [ 0, 1 ] }, "business_unit_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "role_ids": { "type": "array", "items": { "type": "integer", "example": 1 } }, "is_active": { "type": "number", "enum": [ 0, 1 ] }, "is_display_code": { "type": "integer", "enum": [ 0, 1 ] } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountAdminDTO" } } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/users/hosts/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Users Public", "operationId": "cc0b97eee5a817a504090b70e1dc0c7e", "parameters": [ { "name": "business_unit_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "data_center_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "visitor", "contractor" ] } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "fullname", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/users/public": { "get": { "tags": [ "Customer / Public" ], "summary": "Get List Users Public", "operationId": "7aa46cd53565855d7e6e52426e1b6569", "parameters": [ { "name": "business_unit_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "id", "fullname", "created_at" ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/visitor-access-pass-requests": { "get": { "tags": [ "Customer / Request / Visitor Access Pass Requests" ], "summary": "Get List Visitor Access Pass Requests", "operationId": "53f7aed9c3f3780f23b7c4943e99bebe", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_unit_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "location_dc_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "visit_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] }, "post": { "tags": [ "Customer / Request / Visitor Access Pass Requests" ], "summary": "Create New Visitor Access Pass Request", "operationId": "705ab44295b4869b4ca170787933ce22", "requestBody": { "content": { "application/json": { "schema": { "required": [ "business_unit_id", "start_date", "end_date", "start_time", "end_time", "in_out_type", "location_dc_id", "purpose", "host_account_id", "visitors" ], "properties": { "business_unit_id": { "type": "number" }, "start_date": { "type": "date", "example": "2025-10-01" }, "end_date": { "type": "date", "example": "2025-11-01" }, "start_time": { "type": "string" }, "end_time": { "type": "string" }, "in_out_type": { "type": "string" }, "location_dc_id": { "type": "number" }, "purpose": { "type": "string" }, "host_account_id": { "type": "number" }, "visitors": { "type": "array", "items": { "properties": { "name": { "type": "string", "example": "Jack MTP" }, "nric": { "type": "string", "example": "S1234567A" }, "passport": { "type": "string" }, "fin": { "type": "string" } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } }, "/api/v1/customer/requests/visitor-access-pass-requests/{id}": { "get": { "tags": [ "Customer / Request / Visitor Access Pass Requests" ], "summary": "Get Visitor Access Pass Request by ID", "operationId": "de7fddaf3a2bac76b09a8b5d7624c009", "parameters": [ { "name": "id", "in": "path", "description": "ID of the Visitor Access Pass Request", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "bearerAuth": [] } ] } } }, "components": { "schemas": { "AccountModel": { "properties": { "id": { "type": "integer", "minimum": "1" }, "username": { "type": "string", "format": "email" }, "password": { "type": "string", "format": "password" }, "scope": { "type": "string" }, "is_active": { "type": "integer", "example": "1" }, "email_verified_at": { "type": "string", "format": "date-time" }, "last_login_at": { "type": "string", "format": "date-time" } }, "type": "object" }, "AccountAdminDTO": { "properties": { "id": { "type": "integer", "minimum": "1" }, "username": { "type": "string", "format": "email" }, "password": { "type": "string", "format": "password" }, "scope": { "type": "string" }, "is_active": { "type": "integer", "example": "1" }, "email_verified_at": { "type": "string", "format": "date-time" }, "last_login_at": { "type": "string", "format": "date-time" }, "admin": { "$ref": "#/components/schemas/AdminModel" }, "profile": { "$ref": "#/components/schemas/ProfileModel" } }, "type": "object" }, "AccountUserDTO": { "properties": { "id": { "type": "integer", "minimum": "1" }, "username": { "type": "string", "format": "email" }, "password": { "type": "string", "format": "password" }, "scope": { "type": "string" }, "is_active": { "type": "integer", "example": "1" }, "email_verified_at": { "type": "string", "format": "date-time" }, "last_login_at": { "type": "string", "format": "date-time" }, "user": { "$ref": "#/components/schemas/UserModel" }, "profile": { "$ref": "#/components/schemas/ProfileModel" } }, "type": "object" }, "AdminModel": { "required": [ "id", "account_id" ], "properties": { "id": { "type": "integer", "minimum": "1" }, "acount_id": { "type": "integer", "minimum": "1" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "type": "object" }, "ProfileModel": { "required": [ "id", "account_id", "firstname", "lastname", "phone", "created_at" ], "properties": { "id": { "type": "integer", "minimum": "1" }, "acount_id": { "type": "integer", "minimum": "1" }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "fullname": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": "string", "format": "email" }, "phone": { "type": "string" }, "avatar": { "type": "string", "format": "url" }, "birthday": { "type": "string" }, "gender": { "type": "string" }, "created_at": { "type": "string", "format": "datetime" } }, "type": "object" }, "ProfileUpdateDTO": { "properties": { "firstname": { "nullable": true, "description": "Sometimes required", "type": "string" }, "lastname": { "nullable": true, "description": "Sometimes required", "type": "string" }, "nickname": { "nullable": true, "type": "string" }, "email": { "nullable": true, "type": "string", "format": "email" }, "phone": { "nullable": true, "description": "Sometimes required", "type": "string" }, "avatar": { "nullable": true, "type": "string" }, "birthday": { "nullable": true, "type": "string" }, "gender": { "nullable": true, "type": "string" } }, "type": "object" }, "UserModel": { "required": [ "id", "account_id" ], "properties": { "id": { "type": "integer", "minimum": "1" }, "account_id": { "type": "integer", "minimum": "1" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "type": "object" } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string", "example": "Successfully logged out!" } }, "type": "object" } } } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Enter your Bearer token in the format: Bearer {token}" } } }, "tags": [ { "name": "Public / Admin / Auth" }, { "name": "Admin / Public" }, { "name": "Admin / Account" }, { "name": "Admin / Admin" }, { "name": "Admin / Data Center" }, { "name": "Admin / Department" }, { "name": "Admin / Permission" }, { "name": "Admin / Role" }, { "name": "Admin / Customer" }, { "name": "Admin / Customer / Billing Account" }, { "name": "Admin / Customer / Business Unit" }, { "name": "Admin / Customer / Permission" }, { "name": "Admin / Customer / Role" }, { "name": "Admin / Customer / User" }, { "name": "Admin / Product" }, { "name": "Admin / Category" }, { "name": "Admin / Service Attribute" }, { "name": "Admin / Service" }, { "name": "Admin / Service / Price" }, { "name": "Admin / Service / Cost" }, { "name": "Admin / Service / Attribute" }, { "name": "Admin / Setting" }, { "name": "Admin / File Management" }, { "name": "Admin / Quotation" }, { "name": "Admin / Quotation / Attachment" }, { "name": "Admin / Quotation / Service" }, { "name": "Admin / Quotation / Setting" }, { "name": "Admin / Quotation / Sign" }, { "name": "Admin / Quotation / Terms and Conditions" }, { "name": "Admin / Sales" }, { "name": "Admin / Sales / Attachment" }, { "name": "Admin / Sales / Service" }, { "name": "Admin / Sales / Setting" }, { "name": "Admin / Sales / Terms and Conditions" }, { "name": "Admin / Sales / Task" }, { "name": "Admin / Service Report" }, { "name": "Admin / Delivery Order" } ] }