fmea-api-mcp-server 1.1.46 → 1.1.48

package/endpoints/v2/condition-library/core.json

@@ -3,305 +3,6 @@
   "version": "v2",
   "description": "",
   "endpoints": [
-    {
-      "path": "/api/v2/condition-library/{type}/{serial}",
-      "method": "DELETE",
-      "operationId": "deleteConditionLibraryNode",
-      "summary": "Delete condition library node",
-      "description": "Deletes the target node and its subtree for the requested type. Root node deletion is not allowed.",
-      "tags": [
-        "Condition Library"
-      ],
-      "parameters": [
-        {
-          "name": "type",
-          "in": "path",
-          "description": "Condition library type (stress|design|process)",
-          "required": true,
-          "schema": {
-            "type": "string",
-            "enum": [
-              "STRESS",
-              "DESIGN",
-              "PROCESS"
-            ]
-          }
-        },
-        {
-          "name": "serial",
-          "in": "path",
-          "description": "Condition library serial",
-          "required": true,
-          "schema": {
-            "type": "integer",
-            "format": "int32",
-            "minimum": 0
-          }
-        }
-      ],
-      "requestBody": null,
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {}
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/condition-library/{type}/{serial}",
-      "method": "PATCH",
-      "operationId": "updateConditionLibraryNode",
-      "summary": "Update condition library node",
-      "description": "Updates the node title by serial for the requested type. Duplicate titles under the same parent are rejected.",
-      "tags": [
-        "Condition Library"
-      ],
-      "parameters": [
-        {
-          "name": "type",
-          "in": "path",
-          "description": "Condition library type (stress|design|process)",
-          "required": true,
-          "schema": {
-            "type": "string",
-            "enum": [
-              "STRESS",
-              "DESIGN",
-              "PROCESS"
-            ]
-          }
-        },
-        {
-          "name": "serial",
-          "in": "path",
-          "description": "Condition library serial",
-          "required": true,
-          "schema": {
-            "type": "integer",
-            "format": "int32",
-            "minimum": 0
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "required": [
-                "title"
-              ],
-              "type": "object",
-              "properties": {
-                "title": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        },
-        "required": true
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "serial": {
-                    "type": "integer"
-                  },
-                  "type": {
-                    "type": "string",
-                    "enum": [
-                      "STRESS",
-                      "DESIGN",
-                      "PROCESS"
-                    ]
-                  },
-                  "title": {
-                    "type": "string"
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "parentId": {
-                    "type": "string"
-                  },
-                  "depth": {
-                    "type": "integer"
-                  },
-                  "rank": {
-                    "type": "integer"
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/condition-library/{type}",
-      "method": "POST",
-      "operationId": "createConditionLibraryNode",
-      "summary": "Create condition library node",
-      "description": "Creates a node in the condition library for the requested type. When parentTag is omitted, the node is created under the root tag (0000).",
-      "tags": [
-        "Condition Library"
-      ],
-      "parameters": [
-        {
-          "name": "type",
-          "in": "path",
-          "description": "Condition library type (stress|design|process)",
-          "required": true,
-          "schema": {
-            "type": "string",
-            "enum": [
-              "STRESS",
-              "DESIGN",
-              "PROCESS"
-            ]
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "required": [
-                "title"
-              ],
-              "type": "object",
-              "properties": {
-                "title": {
-                  "type": "string"
-                },
-                "parentTag": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        },
-        "required": true
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "serial": {
-                    "type": "integer"
-                  },
-                  "type": {
-                    "type": "string",
-                    "enum": [
-                      "STRESS",
-                      "DESIGN",
-                      "PROCESS"
-                    ]
-                  },
-                  "title": {
-                    "type": "string"
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "parentId": {
-                    "type": "string"
-                  },
-                  "depth": {
-                    "type": "integer"
-                  },
-                  "rank": {
-                    "type": "integer"
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/condition-library/{type}/order",
-      "method": "PUT",
-      "operationId": "updateConditionLibraryOrder",
-      "summary": "Update condition library order",
-      "description": "Updates rank values for sibling nodes in the requested type. All items must belong to the same parent and include serial/rank pairs.",
-      "tags": [
-        "Condition Library"
-      ],
-      "parameters": [
-        {
-          "name": "type",
-          "in": "path",
-          "description": "Condition library type (stress|design|process)",
-          "required": true,
-          "schema": {
-            "type": "string",
-            "enum": [
-              "STRESS",
-              "DESIGN",
-              "PROCESS"
-            ]
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "required": [
-                "items"
-              ],
-              "type": "object",
-              "properties": {
-                "items": {
-                  "maxItems": 2147483647,
-                  "minItems": 1,
-                  "type": "array",
-                  "items": {
-                    "required": [
-                      "rank",
-                      "serial"
-                    ],
-                    "type": "object",
-                    "properties": {
-                      "serial": {
-                        "type": "integer",
-                        "format": "int32"
-                      },
-                      "rank": {
-                        "type": "integer",
-                        "format": "int32"
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "required": true
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {}
-          }
-        }
-      }
-    },
     {
       "path": "/api/v2/condition-library",
       "method": "GET",
@@ -315,7 +16,7 @@
         {
           "name": "type",
           "in": "query",
-          "description": "Condition library type (stress|design|process). If omitted, returns all types.",
+          "description": "Condition library type. If omitted, returns all types.",
           "schema": {
             "type": "string",
             "enum": [
@@ -439,7 +140,7 @@
         {
           "name": "type",
           "in": "query",
-          "description": "Condition library type (stress|design|process)",
+          "description": "Condition library type",
           "schema": {
             "type": "string",
             "enum": [
@@ -526,6 +227,66 @@
           }
         }
       }
+    },
+    {
+      "path": "/api/v2/condition-library/{type}/children",
+      "method": "PUT",
+      "operationId": "saveConditionLibraryChildren",
+      "summary": "Save condition library children",
+      "description": "Replaces the entire condition library tree for the requested type. The request contains a recursive tree starting from ROOT's direct children. Server diffs each level: deletes omitted nodes (with subtrees), updates changed titles, creates new nodes, and reorders by array position. Nodes with null children field keep their existing subtree; nodes with an empty children array have their subtree deleted.",
+      "tags": [
+        "Condition Library"
+      ],
+      "parameters": [
+        {
+          "name": "type",
+          "in": "path",
+          "description": "Condition library type",
+          "required": true,
+          "schema": {
+            "type": "string",
+            "enum": [
+              "STRESS",
+              "DESIGN",
+              "PROCESS"
+            ]
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "children": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "serial": {
+                        "type": "integer",
+                        "format": "int32"
+                      },
+                      "title": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
     }
   ]
 }

package/endpoints/v2/condition-library-excel/core.json

@@ -16,7 +16,7 @@
         {
           "name": "type",
           "in": "path",
-          "description": "Condition library type (stress|design|process)",
+          "description": "Condition library type",
           "required": true,
           "schema": {
             "type": "string",
@@ -43,9 +43,6 @@
             "schema": {
               "type": "object",
               "properties": {
-                "parentTag": {
-                  "type": "string"
-                },
                 "sheetIndex": {
                   "type": "integer",
                   "format": "int32"

package/endpoints/v2/divisions/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": "page",
           "in": "query",

package/endpoints/v2/documents/core.json

@@ -7,13 +7,16 @@
       "path": "/api/v2/projects/{projectId}/documents/categories/{documentCategory}",
       "method": "GET",
       "operationId": "listByCategory",
-      "summary": "List documents by category",
-      "description": "Retrieves all documents belonging to a specific category within a project (Filter / Query by type). Use this endpoint when you need to fetch documents filtered by their document category type, such as input files, output reports, analysis results, or reference materials. The category parameter allows you to narrow down the document list to a specific classification, enabling targeted document retrieval and organization.",
-      "tags": [],
+      "summary": "List documents by category for a project",
+      "description": "Returns documents in the specified category for the given project. Document categories group related files (e.g., FMEA reports, reference materials).",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID whose documents to list",
           "required": true,
           "schema": {
             "type": "string"
@@ -22,6 +25,7 @@
         {
           "name": "documentCategory",
           "in": "path",
+          "description": "Document category",
           "required": true,
           "schema": {
             "type": "string",
@@ -88,13 +92,16 @@
       "path": "/api/v2/projects/{projectId}/documents/categories/{documentCategory}",
       "method": "POST",
       "operationId": "add_1",
-      "summary": "Add document to category",
-      "description": "Creates and registers a new document entry within a specific category for a project (Upload / Create / Attach file). Use this endpoint to add documents such as analysis reports, input data files, or reference materials to the project. The document will be classified under the specified category, enabling organized storage and retrieval. Requires project member role with NORMAL user level permissions.",
-      "tags": [],
+      "summary": "Add a document to a project category",
+      "description": "Adds a new document entry to the specified category within the project. The document file must be uploaded separately via POST /api/v2/files. Requires project membership.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID to add the document to",
           "required": true,
           "schema": {
             "type": "string"
@@ -103,6 +110,7 @@
         {
           "name": "documentCategory",
           "in": "path",
+          "description": "Document category to add to",
           "required": true,
           "schema": {
             "type": "string",
@@ -192,13 +200,16 @@
       "path": "/api/v2/projects/{projectId}/documents/{documentId}",
       "method": "GET",
       "operationId": "get_8",
-      "summary": "Get document by ID",
-      "description": "Fetches detailed information for a specific document using its unique identifier (Retrieve / Fetch / View document details). Use this endpoint to obtain complete document metadata including name, category, path, creation timestamp, and associated file information. This is essential when you need to display document details, verify document existence, or access specific document properties before performing further operations like download or deletion.",
-      "tags": [],
+      "summary": "Get a project document by ID",
+      "description": "Returns a single project document by its numeric ID. The document must belong to the specified project.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the document",
           "required": true,
           "schema": {
             "type": "string"
@@ -207,6 +218,7 @@
         {
           "name": "documentId",
           "in": "path",
+          "description": "Document ID (numeric)",
           "required": true,
           "schema": {
             "type": "integer",
@@ -265,13 +277,16 @@
       "path": "/api/v2/projects/{projectId}/documents/{documentId}",
       "method": "DELETE",
       "operationId": "delete_8",
-      "summary": "Delete document",
-      "description": "Permanently removes a document from the project using its unique identifier (Remove / Erase document). This operation deletes the document record and disassociates it from the project. Use with caution as this action cannot be undone. Requires project member role with NORMAL user level permissions. Ensure you have the correct document ID before initiating deletion to avoid accidental data loss.",
-      "tags": [],
+      "summary": "Delete a project document",
+      "description": "Permanently deletes the specified document from the project. Returns 204 No Content on success. Requires project membership.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the document",
           "required": true,
           "schema": {
             "type": "string"
@@ -280,6 +295,7 @@
         {
           "name": "documentId",
           "in": "path",
+          "description": "Document ID to delete (numeric)",
           "required": true,
           "schema": {
             "type": "integer",
@@ -301,13 +317,16 @@
       "path": "/api/v2/projects/{projectId}/documents/{documentId}/download",
       "method": "GET",
       "operationId": "getDownloadLink_2",
-      "summary": "Get document download link",
-      "description": "Generates a secure download URL for accessing the actual file associated with a document (Download file / Get file URL). Use this endpoint to obtain a temporary, authenticated link that allows users to download the document file. The link includes necessary security tokens to ensure only authorized users can access the file. This is the standard method for retrieving document files after you have identified the document ID through listing or search operations.",
-      "tags": [],
+      "summary": "Get download link for a project document",
+      "description": "Generates and returns a download link (FileDownloadResponseDTO) for the specified document. Use GET /api/v1/files/{uuid} with the returned URI to download the actual file.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID that owns the document",
           "required": true,
           "schema": {
             "type": "string"
@@ -316,6 +335,7 @@
         {
           "name": "documentId",
           "in": "path",
+          "description": "Document ID to download (numeric)",
           "required": true,
           "schema": {
             "type": "integer",
@@ -349,13 +369,16 @@
       "path": "/api/v2/projects/{projectId}/documents",
       "method": "GET",
       "operationId": "list_14",
-      "summary": "List all Documents",
-      "description": "Retrieves a comprehensive list of all documents associated with a specific project (Get all files / Fetch project documents / Query document library). Use this endpoint when you need to view, browse, or display the complete collection of documents within a project, including all categories and types. The response includes document metadata such as names, categories, paths, and timestamps, enabling users to navigate and manage the project document repository effectively.",
-      "tags": [],
+      "summary": "List all documents for a project",
+      "description": "Returns all documents associated with the specified project, across all categories.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID whose documents to list",
           "required": true,
           "schema": {
             "type": "string"
@@ -416,13 +439,16 @@
       "path": "/api/v2/projects/{projectId}/documents/categories/{documentCategory}/path/{documentPath}",
       "method": "GET",
       "operationId": "listByCategoryAndPath",
-      "summary": "List documents by category and path",
-      "description": "Fetches documents matching both a specific category and file path within a project (Filter by type and location / Query documents in folder). Use this endpoint for precise document filtering when you need to retrieve documents from a specific directory or subfolder within a category. The path parameter enables hierarchical navigation, allowing you to access documents organized in nested folder structures. This is particularly useful for browsing documents within specific subdirectories or locations.",
-      "tags": [],
+      "summary": "List documents by category and path for a project",
+      "description": "Returns documents that match both the specified category and virtual path prefix. Supports hierarchical document organization within a category.",
+      "tags": [
+        "Documents"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID whose documents to list",
           "required": true,
           "schema": {
             "type": "string"
@@ -431,6 +457,7 @@
         {
           "name": "documentCategory",
           "in": "path",
+          "description": "Document category",
           "required": true,
           "schema": {
             "type": "string",
@@ -445,6 +472,7 @@
         {
           "name": "documentPath",
           "in": "path",
+          "description": "Virtual document path prefix for filtering",
           "required": true,
           "schema": {
             "type": "string"