fmea-api-mcp-server 1.1.46 → 1.1.48

package/endpoints/v2/worksheets/excel.json

@@ -6,13 +6,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{uuid}",
       "method": "PUT",
-      "summary": "Update worksheet Excel",
-      "description": "Updates an existing worksheet by importing data from an uploaded Excel file (.xlsx, .xls). Use this endpoint to modify worksheet contents, replace existing data, or refresh worksheet records with new Excel data. The endpoint parses the uploaded Excel file and updates the corresponding worksheet record. This is the primary method for editing worksheet data through Excel import. Requires project member role.",
-      "tags": [],
+      "summary": "Re-import a worksheet from an uploaded Excel file",
+      "description": "Updates an existing worksheet by re-importing data from a previously uploaded Excel file. Overwrites the worksheet content according to the provided column mapping configuration. Returns 204 No Content on success.",
+      "tags": [
+        "Worksheet Excel"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the worksheet",
           "required": true,
           "schema": {
             "type": "string"
@@ -21,6 +24,7 @@
         {
           "name": "uuid",
           "in": "path",
+          "description": "UUID of the uploaded Excel file (returned by POST /api/v2/files)",
           "required": true,
           "schema": {
             "type": "string"
@@ -79,13 +83,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{uuid}",
       "method": "POST",
-      "summary": "Add worksheet Excel",
-      "description": "Creates a new worksheet by importing data from an uploaded Excel file (.xlsx, .xls). Use this endpoint to add a new worksheet record, create worksheet entries from Excel, or import worksheet data from spreadsheet files. The endpoint parses the uploaded Excel file and creates a new worksheet with the data. Returns the created worksheet's report number for reference. Requires project member role.",
-      "tags": [],
+      "summary": "Import a new worksheet from an uploaded Excel file",
+      "description": "Creates a new worksheet by importing data from a previously uploaded Excel file. The file must be uploaded first via POST /api/v2/files. The request body specifies column mapping configuration. Returns the assigned report number (reportNoSetDTO) and a Location header pointing to the new worksheet.",
+      "tags": [
+        "Worksheet Excel"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that will own the new worksheet",
           "required": true,
           "schema": {
             "type": "string"
@@ -94,6 +101,7 @@
         {
           "name": "uuid",
           "in": "path",
+          "description": "UUID of the uploaded Excel file (returned by POST /api/v2/files)",
           "required": true,
           "schema": {
             "type": "string"
@@ -152,13 +160,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{reportNoSimple}",
       "method": "GET",
-      "summary": "Get worksheet Excel download link",
-      "description": "Generates a download link for a worksheet Excel file by report number. Use this endpoint to export worksheet data, download worksheet as Excel, or retrieve the spreadsheet file for offline editing. The link provides access to the Excel file associated with the specified worksheet report number. Requires reader-level access or higher.",
-      "tags": [],
+      "summary": "Get Excel download link for a worksheet",
+      "description": "Generates and returns a download link (FileDownloadResponseDTO) for exporting a worksheet as an Excel file. The report number identifies the worksheet (primary 'N' or primary-secondary 'N-M'). Use GET /api/v1/files/{uuid} with the returned URI to download the file.",
+      "tags": [
+        "Worksheet Excel"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the worksheet",
           "required": true,
           "schema": {
             "type": "string"
@@ -167,6 +178,7 @@
         {
           "name": "reportNoSimple",
           "in": "path",
+          "description": "Worksheet report number: 'N' (primary) or 'N-M' (primary-secondary). '#' prefix is stripped.",
           "required": true,
           "schema": {
             "type": "string"
@@ -198,13 +210,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{uuid}/metadata",
       "method": "GET",
-      "summary": "Get worksheet Excel metadata",
-      "description": "Extracts metadata from an uploaded Excel file without processing the full data. Use this endpoint to preview file information, validate Excel structure, inspect worksheet contents, or retrieve file properties before saving. Returns metadata including sheet names, column headers, and data structure. Useful for pre-validating Excel files before add/update operations. Requires project member role.",
-      "tags": [],
+      "summary": "Get Excel file metadata for a worksheet import",
+      "description": "Reads metadata (sheet names, column headers) from a previously uploaded Excel file. The file must be uploaded first via POST /api/v2/files. The returned metadata is used to configure mapping before triggering import.",
+      "tags": [
+        "Worksheet Excel"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the worksheet",
           "required": true,
           "schema": {
             "type": "string"
@@ -213,6 +228,7 @@
         {
           "name": "uuid",
           "in": "path",
+          "description": "UUID of the uploaded Excel file (returned by POST /api/v2/files)",
           "required": true,
           "schema": {
             "type": "string"
@@ -262,14 +278,17 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{reportNoSimple}/sheets",
       "method": "GET",
-      "summary": "Get Excel Sheets List",
-      "description": "Fetches a complete list of available Excel worksheets/tabs associated with a specific previously generated or uploaded Excel report. Ideal for previewing workbook structure, selecting specific sheets for analysis, or retrieving metadata before detailed extraction. (List sheets / View Excel tabs / Get available worksheets).",
-      "tags": [],
+      "summary": "List POISheet sheets for a worksheet Excel",
+      "description": "Returns the list of POISheet sheet objects contained in the Excel file associated with the specified worksheet. Useful for rendering multi-sheet Excel content in the worksheet editor.",
+      "tags": [
+        "Worksheet Excel"
+      ],
       "operationId": "getSheets",
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the worksheet",
           "required": true,
           "schema": {
             "type": "string"
@@ -278,6 +297,7 @@
         {
           "name": "reportNoSimple",
           "in": "path",
+          "description": "Worksheet report number: 'N' (primary) or 'N-M' (primary-secondary). '#' prefix is stripped.",
           "required": true,
           "schema": {
             "type": "string"

package/endpoints/v2/worksheets/management.json

@@ -6,13 +6,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/failuremode/{failureModeId}",
       "method": "GET",
-      "summary": "Get worksheet by failure mode",
-      "description": "Fetches the complete worksheet data associated with a specific failure mode within a project. Use this endpoint to retrieve, load, or view detailed failure mode analysis worksheets including RPN calculations, risk assessments, and mitigation strategies. This is essential for reviewing existing failure mode documentation, conducting quality audits, or preparing data for editing operations. The endpoint returns structured worksheet content that can be used for analysis, reporting, or further modification through the update endpoint.",
-      "tags": [],
+      "summary": "Get worksheet by failure mode ID",
+      "description": "Returns the worksheet associated with the specified failure mode within the given project. Returns the worksheet DTO including S/O/D data and all worksheet rows. Requires NORMAL user level.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the failure mode belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -21,6 +24,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID to retrieve the associated worksheet for",
           "required": true,
           "schema": {
             "type": "string"
@@ -58,13 +62,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/failuremode/{failureModeId}",
       "method": "POST",
-      "summary": "Create worksheet by failure mode",
-      "description": "Generates a new worksheet for a specific failure mode within a project. Use this endpoint to initialize, set up, or create failure mode analysis worksheets. This operation establishes a structured worksheet template linked to the identified failure mode, optionally associating it with a block diagram via the blockDiagramId query parameter. Essential for starting new failure mode analyses, initiating risk assessment workflows, or expanding project documentation coverage. The created worksheet provides a framework for capturing RPN calculations, failure effects, causes, and recommended actions.",
-      "tags": [],
+      "summary": "Create worksheet row for a failure mode",
+      "description": "Creates a new worksheet row linked to the specified failure mode within the project. Optionally associates the row with a block diagram node via blockDiagramId. Returns HTTP 201 Created with the created worksheet row DTO. Requires NORMAL user level and project MEMBER role.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the failure mode belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -73,6 +80,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID to create a worksheet row for",
           "required": true,
           "schema": {
             "type": "string"
@@ -81,6 +89,7 @@
         {
           "name": "blockDiagramId",
           "in": "query",
+          "description": "Optional block diagram node ID to associate with the new worksheet row",
           "schema": {
             "type": "string"
           }
@@ -127,11 +136,14 @@
       "method": "GET",
       "summary": "Get worksheet headers",
       "description": "Returns worksheet headers copied for the worksheet. When search is provided, keyword matching is applied.",
-      "tags": [],
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the worksheet belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -140,6 +152,7 @@
         {
           "name": "reportNo",
           "in": "path",
+          "description": "Worksheet report number (primary, e.g. '3')",
           "required": true,
           "schema": {
             "type": "string"
@@ -237,13 +250,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNo}/{failureModeId}",
       "method": "PUT",
-      "summary": "Save worksheet by failure mode",
-      "description": "Updates and persists worksheet data for a specific failure mode within a designated report. Use this endpoint to save, modify, edit, or update failure mode analysis content including severity ratings, occurrence probabilities, detection rankings, RPN calculations, recommended actions, and status tracking. This operation overwrites existing data with the provided FailureModeWorksheetSaveDTO payload, ensuring data persistence and version control. Essential for recording analysis progress, updating risk assessments after reviews, documenting corrective actions, or maintaining live risk evaluation data. Requires project member role authentication and supports iterative refinement of failure mode analyses throughout the project lifecycle.",
-      "tags": [],
+      "summary": "Save worksheet data for a specific failure mode",
+      "description": "Saves worksheet content for the worksheet row associated with the given failure mode. The report number identifies the worksheet; the failure mode ID identifies the row. Requires NORMAL user level and project MEMBER role.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the worksheet belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -252,6 +268,7 @@
         {
           "name": "reportNo",
           "in": "path",
+          "description": "Worksheet report number (primary, e.g. '3')",
           "required": true,
           "schema": {
             "type": "string"
@@ -260,6 +277,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID whose worksheet row will be updated",
           "required": true,
           "schema": {
             "type": "string"

package/endpoints/v2/worksheets/templates.json

@@ -8,11 +8,14 @@
       "method": "GET",
       "summary": "Get worksheet template headers",
       "description": "Returns worksheet template headers. When search is provided, keyword matching is applied.",
-      "tags": [],
+      "tags": [
+        "Worksheet Templates"
+      ],
       "parameters": [
         {
           "name": "id",
           "in": "path",
+          "description": "Worksheet template ID",
           "required": true,
           "schema": {
             "type": "integer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.46",
+  "version": "1.1.48",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",