fmea-api-mcp-server 1.1.46 → 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,

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": {
@@ -270,7 +270,7 @@
       "method": "POST",
       "operationId": "rebuild",
       "summary": "Rebuild tree search index",
-      "description": "Triggers an asynchronous full rebuild (reindex) of the Lucene tree search index for the specified domain. Use this to reindex or regenerate the search index data. Requires ADMIN privileges. Returns 202 if rebuild started, 409 if already in progress.",
+      "description": "Triggers an asynchronous full rebuild of the Lucene tree search index for the specified domain. Requires ADMIN privileges. Returns 202 if rebuild started, 409 if already in progress.",
       "tags": [
         "Tree Search"
       ],

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",

package/endpoints/v2/worksheets/core.json

@@ -6,13 +6,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets",
       "method": "GET",
-      "summary": "Get worksheet summaries",
-      "description": "Retrieves a list of all worksheet summaries within a project. This endpoint provides a high-level overview (summary/directory) of available worksheets, excluding detailed content. Use this to browse, list, or enumerate worksheets before fetching specific worksheet details. The response contains basic metadata such as report numbers and titles. Ideal for dashboard views, worksheet selection interfaces, or getting a quick inventory of all worksheets in a project. No authentication required for read access.",
-      "tags": [],
+      "summary": "List worksheet summaries for a project",
+      "description": "Returns summary information for all worksheets belonging to the given project. Each summary includes the report number, title, and status. Requires NORMAL user level.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID to list worksheets for",
           "required": true,
           "schema": {
             "type": "string"
@@ -118,13 +121,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets",
       "method": "POST",
-      "summary": "Create worksheet",
-      "description": "Creates a new worksheet within the specified project. Use this endpoint to initialize a blank worksheet, set up a new analysis document, or establish a fresh worksheet structure. The request accepts worksheet creation parameters via WorksheetCreationDTO. Upon successful creation, returns the report number (reportNoSimple) of the newly created worksheet. Requires NORMAL user level and PROJECT MEMBER role. This is the initiating action for any worksheet-based workflow. Common use cases include: starting a new FMEA analysis, creating additional worksheets for different subsystems, or generating worksheet templates.",
-      "tags": [],
+      "summary": "Create a new worksheet in a project",
+      "description": "Creates a new worksheet under the given project using the provided creation DTO. Returns HTTP 201 Created with a Location header pointing to the new worksheet. Requires NORMAL user level and project MEMBER role.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID to create the worksheet under",
           "required": true,
           "schema": {
             "type": "string"
@@ -177,13 +183,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
       "method": "GET",
-      "summary": "Get worksheet by report number",
-      "description": "Fetches the complete details of a specific worksheet identified by its report number. The reportNoSimple parameter accepts formats like '3' or '3-1' (handling sub-worksheets via ReportNoSetDTO). Returns the full worksheet data including all rows, columns, headers, and cell values. Use this endpoint after listing summaries to retrieve detailed content for editing or analysis. Requires NORMAL user level. Common scenarios include: loading a worksheet for editing, viewing worksheet content, exporting worksheet data, or fetching worksheet structure for UI rendering. This is the primary read operation for full worksheet content.",
-      "tags": [],
+      "summary": "Get worksheet detail by report number",
+      "description": "Returns the full worksheet detail for the given report number within a project. Report number format: 'N' for primary only (e.g. '3'), or 'N-M' for primary-secondary (e.g. '3-1'). The '#' prefix is optional and will be stripped. Requires NORMAL user level.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the worksheet belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -192,6 +201,7 @@
         {
           "name": "reportNoSimple",
           "in": "path",
+          "description": "Report number: 'N' (primary) or 'N-M' (primary-secondary), e.g. '3-1'",
           "required": true,
           "schema": {
             "type": "string"
@@ -270,13 +280,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
       "method": "PUT",
-      "summary": "Update worksheet",
-      "description": "Updates and saves changes to an existing worksheet identified by its report number. Accepts WorksheetSaveDTO containing modified worksheet data including cell values, structure changes, and metadata updates. The reportNoSimple parameter supports both simple numbers ('3') and sub-worksheet notation ('3-1'). All changes are persisted to the database. Requires NORMAL user level and PROJECT MEMBER role with write permissions. Common use cases: saving worksheet edits, updating cell values, modifying worksheet structure, applying bulk changes, or synchronizing client-side modifications. This is the primary write operation for worksheets and should be called after any user modifications to persist data.",
-      "tags": [],
+      "summary": "Save worksheet data by report number",
+      "description": "Saves (updates) the worksheet content for the given report number. Accepts a WorksheetSaveDTO containing row data and column values. 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"
@@ -285,6 +298,7 @@
         {
           "name": "reportNoSimple",
           "in": "path",
+          "description": "Report number: 'N' (primary) or 'N-M' (primary-secondary), e.g. '3-1'",
           "required": true,
           "schema": {
             "type": "string"
@@ -419,13 +433,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
       "method": "DELETE",
-      "summary": "Delete worksheet",
-      "description": "Permanently removes a worksheet from the project using its report number identifier. The reportNoSimple parameter accepts formats like '3' or '3-1' for sub-worksheets. This operation is irreversible and will delete all worksheet data including rows, columns, cell values, and associated metadata. Requires NORMAL user level and PROJECT MEMBER role. Use with caution as deleted worksheets cannot be recovered without database restore. Common scenarios: removing obsolete worksheets, cleaning up test data, deleting unused analysis documents, or managing worksheet lifecycle. Consider archiving instead of deleting if the worksheet might be needed for future reference.",
-      "tags": [],
+      "summary": "Delete worksheet by report number",
+      "description": "Deletes the worksheet identified by the report number within the project. Returns HTTP 200 on success. 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"
@@ -434,6 +451,7 @@
         {
           "name": "reportNoSimple",
           "in": "path",
+          "description": "Report number: 'N' (primary) or 'N-M' (primary-secondary), e.g. '3-1'",
           "required": true,
           "schema": {
             "type": "string"

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"