fmea-api-mcp-server 1.1.45 → 1.1.47

package/endpoints/v2/projects/core.json

@@ -220,7 +220,7 @@
       "method": "GET",
       "operationId": "get_3",
       "summary": "Get project details",
-      "description": "Fetches complete project information including metadata, configuration, and current status. Use this endpoint to retrieve detailed project data for viewing, editing, or auditing purposes. Supports retrieving any project the authenticated user has access to.",
+      "description": "Returns the full project details for the given project ID. Throws 404 if the project does not exist.",
       "tags": [
         "Project"
       ],
@@ -579,7 +579,7 @@
       "method": "GET",
       "operationId": "getSummary",
       "summary": "Get project summary",
-      "description": "Fetches a condensed overview of project information including key metrics, status, and essential metadata. Use this for quick project previews, dashboard widgets, or when full project details are not required. Optimized for performance with minimal data transfer.",
+      "description": "Returns a lightweight summary of a project including key metrics. Throws 404 if the project does not exist.",
       "tags": [
         "Project"
       ],
@@ -705,15 +705,6 @@
           "schema": {
             "type": "string"
           }
-        },
-        {
-          "name": "useSynonym",
-          "in": "query",
-          "description": "Whether to expand q with synonym dictionary terms (default: true)",
-          "schema": {
-            "type": "boolean",
-            "default": true
-          }
         }
       ],
       "responses": {
@@ -791,7 +782,7 @@
       "method": "GET",
       "operationId": "getJoinRequestsByProjectId",
       "summary": "List project join requests",
-      "description": "Fetches all pending join requests for a specific project. Use this endpoint to review, approve, or reject users requesting access to the project. Requires project member role. Returns request details including requester information, request status, and timestamps for workflow management.",
+      "description": "Returns all pending and processed join requests for a project. Requires at least MEMBER role in the project.",
       "tags": [
         "Project"
       ],
@@ -952,7 +943,7 @@
       "method": "POST",
       "operationId": "createJoinRequest",
       "summary": "Create a project join request",
-      "description": "Submits a new request to join a project. Use this endpoint when a user wants to request access to a restricted project. The request will be reviewed by existing project members who can approve or reject it. Requires no existing project membership. Returns the created request ID for tracking.",
+      "description": "Creates a join request for the authenticated user to join the specified project. Requires the user to not already be a member (NONE role). Returns the created request ID and a Location header.",
       "tags": [
         "Project"
       ],
@@ -995,7 +986,7 @@
       "method": "PUT",
       "operationId": "updateJoinRequests",
       "summary": "Approve or reject project join requests in batch",
-      "description": "Batch updates multiple join requests simultaneously to approve or reject project access requests. Use this endpoint for efficient workflow management when processing multiple pending requests at once. Requires project member role. Accepts a list of request IDs with their approval status and optional messages.",
+      "description": "Processes multiple join requests in a single call by approving or rejecting them. Requires at least MEMBER role in the project.",
       "tags": [
         "Project"
       ],
@@ -1052,7 +1043,7 @@
       "method": "PUT",
       "operationId": "updateJoinRequest",
       "summary": "Approve or reject a project join request",
-      "description": "Updates a specific join request to approve or reject a user's project access request. Use this endpoint for individual request processing when you need to review and respond to one request at a time. Requires project member role. Supports approval with optional response messages or rejection with reasons.",
+      "description": "Processes a single join request by approving or rejecting it. Requires at least MEMBER role in the project.",
       "tags": [
         "Project"
       ],
@@ -1116,6 +1107,7 @@
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID whose high items to list",
           "required": true,
           "schema": {
             "type": "string"
@@ -1124,7 +1116,7 @@
         {
           "name": "q",
           "in": "query",
-          "description": "Unified keyword for high-item titles",
+          "description": "Keyword filter for high-item titles (optional)",
           "schema": {
             "type": "string"
           }
@@ -1174,7 +1166,7 @@
       "method": "PATCH",
       "operationId": "patchProject",
       "summary": "Partially update project details",
-      "description": "",
+      "description": "Applies partial updates to a project using the PATCH method. Only provided fields are updated; omitted fields remain unchanged. Returns the updated project details.",
       "tags": [
         "Project"
       ],
@@ -1372,11 +1364,14 @@
       "operationId": "refreshWorksheetSnapshot",
       "summary": "Refresh worksheet dashboard snapshots",
       "description": "Manually refreshes worksheet dashboard snapshots. If divisionId is specified, only that division is refreshed; otherwise all cached divisions are refreshed sequentially. Divisions already being refreshed are skipped. Executes synchronously and returns the result after completion.",
-      "tags": [],
+      "tags": [
+        "Admin - Dashboard"
+      ],
       "parameters": [
         {
           "name": "divisionId",
           "in": "query",
+          "description": "Division ID to refresh; if omitted, all cached divisions are refreshed",
           "schema": {
             "type": "integer",
             "format": "int32"

package/endpoints/v2/search/core.json

@@ -136,11 +136,11 @@
                         "blockType": {
                           "type": "string",
                           "enum": [
-                            "Function",
-                            "Structure",
-                            "FunctionStructure",
-                            "StructureFunction",
-                            "Process"
+                            "FMM_FUNCTION",
+                            "FMM_STRUCTURE",
+                            "FMM_FUNCTION_STRUCTURE",
+                            "FMM_STRUCTURE_FUNCTION",
+                            "FMM_PROCESS"
                           ]
                         },
                         "blockNodeId": {
@@ -152,10 +152,7 @@
                         "fmmDiagramType": {
                           "type": "string",
                           "enum": [
-                            "UNUSED",
-                            "NOT_SELECTED",
-                            "TYPE_A",
-                            "TYPE_C"
+                            "UNUSED"
                           ]
                         },
                         "complete": {

package/endpoints/v2/system/core.json

@@ -6,14 +6,17 @@
     {
       "path": "/api/v2/open/metrics/{apType}/constants",
       "method": "GET",
-      "summary": "Get metric constants",
-      "description": "Retrieves metric scoring constants (Severity, Occurrence, Detection, Action Priorities) for the specified Analysis Type. Supports two FMEA methodologies: 'aiag' (AIAG/VDA standard) and 'msr' (Machinery Safety Regulation). Use this endpoint to fetch valid rating scales and calculation parameters required for risk assessment analysis. Commonly used when initializing FMEA worksheets, validating metric values, or configuring dropdown options. The {apType} parameter is case-insensitive but must match supported types. Returns 400 error if type is invalid.",
-      "tags": [],
+      "summary": "Get metric constants for an AP type",
+      "description": "Returns severity, occurrence, and detection metric constants for the given action priority type (AIAG or MSR). Used to populate evaluation criteria dropdowns and compute RPN values. This endpoint is open and does not require authentication.",
+      "tags": [
+        "Metrics"
+      ],
       "operationId": "getMetricConstants",
       "parameters": [
         {
           "name": "apType",
           "in": "path",
+          "description": "Action priority type: aiag or msr (case-insensitive)",
           "required": true,
           "schema": {
             "type": "string"
@@ -33,14 +36,17 @@
     {
       "path": "/api/v2/system/context-version",
       "method": "GET",
-      "summary": "Get Context Version",
-      "description": "Fetches the current application version, deployment semantic tag, and build metadata associated with the specific API context path. Historically replaces legacy health-check endpoints. Use this modern endpoint to verify proper API deployment, check version compatibility before complex operations, or display software version in the UI footer. (Check Version / Get Release Tag / Context Information / API Revision).",
-      "tags": [],
+      "summary": "Get version info for a deployed web application context",
+      "description": "Reads the VERSION file from the given Tomcat webapp sub-path and returns the version string and build date. Returns 400 if contextPath is missing, 404 if the VERSION file does not exist or is unreadable.",
+      "tags": [
+        "System"
+      ],
       "operationId": "checkContext",
       "parameters": [
         {
           "name": "contextPath",
           "in": "query",
+          "description": "Tomcat webapp sub-path to read the VERSION file from (e.g. 'fmea-frontend'). Leading slashes are stripped.",
           "schema": {
             "type": "string"
           }
@@ -59,9 +65,11 @@
     {
       "path": "/api/v2/system/health",
       "method": "GET",
-      "summary": "System Health",
-      "description": "Performs a lightweight diagnostic check and retrieves the basic operational health status of the FMEA system. Use this endpoint for load balancer pinging, uptime monitoring services (e.g., Datadog, Pingdom), or ensuring backend connectivity before user authentication. Returns a simple success payload if the core services and database connections are operational. (Health Check / System Status / Ping API / Service Heartbeat).",
-      "tags": [],
+      "summary": "Health check",
+      "description": "Returns the current server status and UTC timestamp. Always returns HTTP 200 with status='UP' when the application is running. No authentication required.",
+      "tags": [
+        "System"
+      ],
       "operationId": "health",
       "parameters": [],
       "requestBody": null,
@@ -118,16 +126,10 @@
                   "projectPeriod": {
                     "type": "object",
                     "properties": {
-                      "createLimitEnabled": {
-                        "type": "boolean"
-                      },
-                      "createLimitDays": {
+                      "createMaxDurationDays": {
                         "type": "integer"
                       },
-                      "modifyLimitEnabled": {
-                        "type": "boolean"
-                      },
-                      "modifyLimitDays": {
+                      "modifyMaxDurationDays": {
                         "type": "integer"
                       }
                     }
@@ -345,17 +347,11 @@
                 "projectPeriod": {
                   "type": "object",
                   "properties": {
-                    "createLimitEnabled": {
-                      "type": "boolean"
-                    },
-                    "createLimitDays": {
+                    "createMaxDurationDays": {
                       "type": "integer",
                       "format": "int32"
                     },
-                    "modifyLimitEnabled": {
-                      "type": "boolean"
-                    },
-                    "modifyLimitDays": {
+                    "modifyMaxDurationDays": {
                       "type": "integer",
                       "format": "int32"
                     }
@@ -566,16 +562,233 @@
                   "projectPeriod": {
                     "type": "object",
                     "properties": {
-                      "createLimitEnabled": {
+                      "createMaxDurationDays": {
+                        "type": "integer"
+                      },
+                      "modifyMaxDurationDays": {
+                        "type": "integer"
+                      }
+                    }
+                  },
+                  "fmCheckprint": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "designEnabled": {
+                        "type": "boolean"
+                      },
+                      "processEnabled": {
+                        "type": "boolean"
+                      },
+                      "equipmentEnabled": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "fmmDisplay": {
+                    "type": "object",
+                    "properties": {
+                      "showCreationInfo": {
+                        "type": "boolean"
+                      },
+                      "highlightNewFailureModes": {
+                        "type": "boolean"
+                      },
+                      "useBfmmType": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "security": {
+                    "type": "object",
+                    "properties": {
+                      "forcePasswordChangeOnFirstLogin": {
+                        "type": "boolean"
+                      },
+                      "enforcePasswordComplexity": {
+                        "type": "boolean"
+                      },
+                      "restrictCommonSequences": {
+                        "type": "boolean"
+                      },
+                      "preventPasswordReuse": {
+                        "type": "boolean"
+                      },
+                      "enforcePasswordExpiration": {
+                        "type": "boolean"
+                      },
+                      "passwordExpirationDays": {
+                        "type": "integer"
+                      },
+                      "maxLoginFailures": {
+                        "type": "integer"
+                      }
+                    }
+                  },
+                  "mail": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
                         "type": "boolean"
                       },
-                      "createLimitDays": {
+                      "host": {
+                        "type": "string"
+                      },
+                      "port": {
+                        "type": "string"
+                      },
+                      "username": {
+                        "type": "string"
+                      },
+                      "password": {
+                        "type": "string"
+                      },
+                      "senderAddress": {
+                        "type": "string"
+                      },
+                      "rpnThreshold": {
                         "type": "integer"
+                      }
+                    }
+                  },
+                  "serverUrl": {
+                    "type": "object",
+                    "properties": {
+                      "protocol": {
+                        "type": "string"
                       },
-                      "modifyLimitEnabled": {
+                      "host": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "projectManagement": {
+                    "type": "object",
+                    "properties": {
+                      "defaultApprovalOnCompletion": {
                         "type": "boolean"
                       },
-                      "modifyLimitDays": {
+                      "restrictEditAfterApproval": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "validationApproval": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "checkEmptyRecommendedAction": {
+                        "type": "boolean"
+                      },
+                      "checkEmptyDetectionAction": {
+                        "type": "boolean"
+                      },
+                      "notifyFollowUpAssignees": {
+                        "type": "boolean"
+                      },
+                      "checkRpnThreshold": {
+                        "type": "boolean"
+                      },
+                      "checkUnresolvedHighItems": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "revisionEditing": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "allowRevisionNumberEdit": {
+                        "type": "boolean"
+                      },
+                      "allowRevisionDateEdit": {
+                        "type": "boolean"
+                      },
+                      "allowRevisionReasonEdit": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "reviewer": {
+                    "type": "object",
+                    "properties": {
+                      "checkReviewerEnabled": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "blankText": {
+                    "type": "object",
+                    "properties": {
+                      "texts": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/system/settings/public",
+      "method": "GET",
+      "operationId": "getPublicSettings",
+      "summary": "Get public system settings",
+      "description": "Returns system settings visible to all users. Excludes sensitive groups: security, mail, serverUrl.",
+      "tags": [
+        "System Settings"
+      ],
+      "parameters": [],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "company": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "scoring": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "threshold": {
+                        "type": "integer"
+                      },
+                      "alwaysEnabled": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "projectPeriod": {
+                    "type": "object",
+                    "properties": {
+                      "createMaxDurationDays": {
+                        "type": "integer"
+                      },
+                      "modifyMaxDurationDays": {
                         "type": "integer"
                       }
                     }

package/endpoints/v2/templates/core.json

@@ -9,7 +9,9 @@
       "operationId": "getAll_1",
       "summary": "Get all action statuses",
       "description": "Returns all action status items. Used for populating action status dropdowns in worksheets.",
-      "tags": [],
+      "tags": [
+        "Template"
+      ],
       "parameters": [],
       "responses": {
         "default": {
@@ -41,7 +43,9 @@
       "operationId": "create_7",
       "summary": "Create action status",
       "description": "Creates a new action status. Returns 201 with Location header. Requires ADMIN role. Throws 409 if title already exists.",
-      "tags": [],
+      "tags": [
+        "Template"
+      ],
       "parameters": [],
       "requestBody": {
         "content": {
@@ -77,7 +81,9 @@
       "operationId": "getById_1",
       "summary": "Get action status by ID",
       "description": "Returns a single action status by ID. Returns 404 if not found.",
-      "tags": [],
+      "tags": [
+        "Template"
+      ],
       "parameters": [
         {
           "name": "id",
@@ -116,7 +122,9 @@
       "operationId": "update_6",
       "summary": "Update action status",
       "description": "Updates an existing action status title. Returns updated DTO. Requires ADMIN role. Throws 404 if not found, 409 if title conflicts.",
-      "tags": [],
+      "tags": [
+        "Template"
+      ],
       "parameters": [
         {
           "name": "id",
@@ -162,7 +170,9 @@
       "operationId": "delete_6",
       "summary": "Delete action status",
       "description": "Deletes an action status by ID. Returns 204 No Content. Requires ADMIN role. Throws 404 if not found.",
-      "tags": [],
+      "tags": [
+        "Template"
+      ],
       "parameters": [
         {
           "name": "id",

package/endpoints/v2/tree-search/core.json

@@ -32,9 +32,9 @@
                 "queryMode": {
                   "type": "string",
                   "enum": [
-                    "referenceNode",
-                    "anchorPattern",
-                    "contextCompletion"
+                    "REFERENCE_NODE",
+                    "ANCHOR_PATTERN",
+                    "CONTEXT_COMPLETION"
                   ]
                 },
                 "query": {

package/endpoints/v2/users/core.json

@@ -21,15 +21,6 @@
             "type": "string"
           }
         },
-        {
-          "name": "useSynonym",
-          "in": "query",
-          "description": "Whether to expand q with synonym dictionary terms (default: true)",
-          "schema": {
-            "type": "boolean",
-            "default": true
-          }
-        },
         {
           "name": "dept",
           "in": "query",

package/endpoints/v2/worksheet-templates/core.json

@@ -9,11 +9,14 @@
       "operationId": "get_7",
       "summary": "Get worksheet template",
       "description": "Returns a worksheet template. When search is provided, template headers are keyword-filtered.",
-      "tags": [],
+      "tags": [
+        "Worksheet Templates"
+      ],
       "parameters": [
         {
           "name": "id",
           "in": "path",
+          "description": "Worksheet template ID",
           "required": true,
           "schema": {
             "type": "integer",
@@ -158,7 +161,9 @@
       "operationId": "list_13",
       "summary": "List worksheet templates",
       "description": "Returns worksheet templates filtered by FMEA type. When fmeaType is omitted, returns all templates for Design, Process, Equipment, and FA types, ordered by type and template order.",
-      "tags": [],
+      "tags": [
+        "Worksheet Templates"
+      ],
       "parameters": [
         {
           "name": "fmeaType",