@snokam/mcp-api 0.131.3 → 0.133.0

package/specs/test/sales.json

@@ -78,47 +78,6 @@
         ]
       }
     },
-    "/v1.0/tenders/ingest": {
-      "post": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Start tender ingestion",
-        "operationId": "StartTenderIngestion",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ingestionRequest"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "202": {
-            "description": "Payload of Object",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
     "/v1.0/jobs/{jobId}": {
       "get": {
         "tags": [
@@ -204,15 +163,25 @@
         ]
       }
     },
-    "/v1.0/scan/doffin": {
+    "/v1.0/tenders/ingest": {
       "post": {
         "tags": [
-          "Scan"
+          "Tenders"
         ],
-        "summary": "Trigger a Doffin scan immediately",
-        "operationId": "TriggerDoffinScan",
+        "summary": "Start tender ingestion",
+        "operationId": "StartTenderIngestion",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ingestionRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
-          "200": {
+          "202": {
             "description": "Payload of Object",
             "content": {
               "application/json": {
@@ -235,13 +204,52 @@
         ]
       }
     },
-    "/v1.0/scan/email": {
+    "/v1.0/admin/reprocess-emails": {
+      "post": {
+        "tags": [
+          "Admin"
+        ],
+        "summary": "Re-fetch all emails since N days ago and re-ingest them so raw content is stored as source_email blobs",
+        "operationId": "ReprocessEmails",
+        "parameters": [
+          {
+            "name": "daysSince",
+            "in": "query",
+            "description": "Number of days back to fetch emails (default: 90)",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": []
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/scan/doffin": {
       "post": {
         "tags": [
           "Scan"
         ],
-        "summary": "Trigger an email scan immediately",
-        "operationId": "TriggerEmailScan",
+        "summary": "Trigger a Doffin scan immediately",
+        "operationId": "TriggerDoffinScan",
         "responses": {
           "200": {
             "description": "Payload of Object",
@@ -266,13 +274,13 @@
         ]
       }
     },
-    "/v1.0/scan/sites": {
+    "/v1.0/scan/email": {
       "post": {
         "tags": [
           "Scan"
         ],
-        "summary": "Trigger an agentic site scan immediately over all configured sources",
-        "operationId": "TriggerSiteScan",
+        "summary": "Trigger an email scan immediately",
+        "operationId": "TriggerEmailScan",
         "responses": {
           "200": {
             "description": "Payload of Object",
@@ -297,23 +305,13 @@
         ]
       }
     },
-    "/v1.0/admin/reprocess-emails": {
+    "/v1.0/scan/sites": {
       "post": {
         "tags": [
-          "Admin"
-        ],
-        "summary": "Re-fetch all emails since N days ago and re-ingest them so raw content is stored as source_email blobs",
-        "operationId": "ReprocessEmails",
-        "parameters": [
-          {
-            "name": "daysSince",
-            "in": "query",
-            "description": "Number of days back to fetch emails (default: 90)",
-            "schema": {
-              "type": "string"
-            }
-          }
+          "Scan"
         ],
+        "summary": "Trigger an agentic site scan immediately over all configured sources",
+        "operationId": "TriggerSiteScan",
         "responses": {
           "200": {
             "description": "Payload of Object",
@@ -328,7 +326,9 @@
         },
         "security": [
           {
-            "Implicit": []
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
           },
           {
             "ApiKey": []
@@ -640,23 +640,30 @@
         ]
       }
     },
-    "/v1.0/crawl/sources": {
-      "get": {
+    "/v1.0/crawl/sources/{name}/failed-tenders": {
+      "delete": {
         "tags": [
           "Crawl"
         ],
-        "summary": "List configured crawl sources together with their learned patterns and last-activity timestamp",
-        "operationId": "ListCrawlSources",
+        "summary": "Delete all tenders for this source whose ingestion failed (parse-failed / zero confidence)",
+        "operationId": "DeleteFailedTenders",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
         "responses": {
           "200": {
-            "description": "Payload of Array of CrawlSourceWithPattern",
+            "description": "Payload of DeleteFailedTendersResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/crawlSourceWithPattern"
-                  }
+                  "$ref": "#/components/schemas/deleteFailedTendersResponse"
                 }
               }
             }
@@ -674,16 +681,16 @@
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}": {
-      "put": {
+    "/v1.0/crawl/jobs/{jobId}/retry": {
+      "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Create or update a crawl source",
-        "operationId": "UpsertCrawlSource",
+        "summary": "Delete the tender (if any) and enqueue a fresh ingestion for the same URL/title/externalId",
+        "operationId": "RetryCrawlJob",
         "parameters": [
           {
-            "name": "name",
+            "name": "jobId",
             "in": "path",
             "required": true,
             "schema": {
@@ -691,59 +698,21 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/crawlSourceUpsertRequest"
-              }
-            }
-          }
-        },
         "responses": {
           "200": {
-            "description": "Payload of CrawlSourceConfig",
+            "description": "Payload of AgentJob",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/crawlSourceConfig"
+                  "$ref": "#/components/schemas/agentJob"
                 }
               }
             }
           },
           "400": {
             "description": "No description"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
           },
-          {
-            "ApiKey": []
-          }
-        ]
-      },
-      "delete": {
-        "tags": [
-          "Crawl"
-        ],
-        "summary": "Delete a crawl source and its cached pattern",
-        "operationId": "DeleteCrawlSource",
-        "parameters": [
-          {
-            "name": "name",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "204": {
+          "404": {
             "description": "No description"
           }
         },
@@ -759,16 +728,16 @@
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}/pattern": {
-      "delete": {
+    "/v1.0/crawl/jobs/{jobId}/cancel": {
+      "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Drop the cached URL pattern for a source so the next scan re-bootstraps it",
-        "operationId": "InvalidateCrawlPattern",
+        "summary": "Terminate the running orchestration and mark the job as failed (\"Cancelled by operator\")",
+        "operationId": "CancelCrawlJob",
         "parameters": [
           {
-            "name": "name",
+            "name": "jobId",
             "in": "path",
             "required": true,
             "schema": {
@@ -777,7 +746,20 @@
           }
         ],
         "responses": {
-          "204": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
             "description": "No description"
           }
         },
@@ -793,32 +775,35 @@
         ]
       }
     },
-    "/v1.0/crawl/discover-listing": {
+    "/v1.0/crawl/jobs/bulk-delete": {
       "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Given a site homepage or bare domain, locate the tender/project listing page on it",
-        "operationId": "DiscoverCrawlListing",
+        "summary": "Delete a batch of jobs and their backing tenders",
+        "operationId": "BulkDeleteCrawlJobs",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/discoverListingRequest"
+                "$ref": "#/components/schemas/bulkDeleteJobsRequest"
               }
             }
           }
         },
         "responses": {
           "200": {
-            "description": "Payload of DiscoverListingResponse",
+            "description": "Payload of BulkDeleteJobsResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/discoverListingResponse"
+                  "$ref": "#/components/schemas/bulkDeleteJobsResponse"
                 }
               }
             }
+          },
+          "400": {
+            "description": "No description"
           }
         },
         "security": [
@@ -826,17 +811,20 @@
             "Implicit": [
               "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}/scan": {
-      "post": {
+    "/v1.0/crawl/sources/{name}/jobs": {
+      "get": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Scan one source now and enqueue ingestion jobs for newly discovered notices",
-        "operationId": "ScanCrawlSource",
+        "summary": "Recent ingestion jobs for this source, newest first",
+        "operationId": "ListCrawlJobs",
         "parameters": [
           {
             "name": "name",
@@ -845,21 +833,29 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Max jobs to return (default 50)",
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of CrawlScanResponse",
+            "description": "Payload of Array of AgentJob",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/crawlScanResponse"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/agentJob"
+                  }
                 }
               }
             }
-          },
-          "404": {
-            "description": "No description"
           }
         },
         "security": [
@@ -874,13 +870,13 @@
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}/failed-tenders": {
-      "delete": {
+    "/v1.0/crawl/sources/{name}/scan": {
+      "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Delete all tenders for this source whose ingestion failed (parse-failed / zero confidence)",
-        "operationId": "DeleteFailedTenders",
+        "summary": "Scan one source now and enqueue ingestion jobs for newly discovered notices",
+        "operationId": "ScanCrawlSource",
         "parameters": [
           {
             "name": "name",
@@ -893,14 +889,17 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of DeleteFailedTendersResponse",
+            "description": "Payload of CrawlScanResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/deleteFailedTendersResponse"
+                  "$ref": "#/components/schemas/crawlScanResponse"
                 }
               }
             }
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -1055,16 +1054,50 @@
         ]
       }
     },
-    "/v1.0/crawl/jobs/{jobId}/retry": {
-      "post": {
+    "/v1.0/crawl/sources": {
+      "get": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Delete the tender (if any) and enqueue a fresh ingestion for the same URL/title/externalId",
-        "operationId": "RetryCrawlJob",
+        "summary": "List configured crawl sources together with their learned patterns and last-activity timestamp",
+        "operationId": "ListCrawlSources",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of CrawlSourceWithPattern",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/crawlSourceWithPattern"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/crawl/sources/{name}": {
+      "put": {
+        "tags": [
+          "Crawl"
+        ],
+        "summary": "Create or update a crawl source",
+        "operationId": "UpsertCrawlSource",
         "parameters": [
           {
-            "name": "jobId",
+            "name": "name",
             "in": "path",
             "required": true,
             "schema": {
@@ -1072,21 +1105,59 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/crawlSourceUpsertRequest"
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
-            "description": "Payload of AgentJob",
+            "description": "Payload of CrawlSourceConfig",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/agentJob"
+                  "$ref": "#/components/schemas/crawlSourceConfig"
                 }
               }
             }
           },
           "400": {
             "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
           },
-          "404": {
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Crawl"
+        ],
+        "summary": "Delete a crawl source and its cached pattern",
+        "operationId": "DeleteCrawlSource",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
             "description": "No description"
           }
         },
@@ -1102,16 +1173,16 @@
         ]
       }
     },
-    "/v1.0/crawl/jobs/{jobId}/cancel": {
-      "post": {
+    "/v1.0/crawl/sources/{name}/pattern": {
+      "delete": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Terminate the running orchestration and mark the job as failed (\"Cancelled by operator\")",
-        "operationId": "CancelCrawlJob",
+        "summary": "Drop the cached URL pattern for a source so the next scan re-bootstraps it",
+        "operationId": "InvalidateCrawlPattern",
         "parameters": [
           {
-            "name": "jobId",
+            "name": "name",
             "in": "path",
             "required": true,
             "schema": {
@@ -1120,20 +1191,7 @@
           }
         ],
         "responses": {
-          "200": {
-            "description": "Payload of AgentJob",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/agentJob"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "No description"
-          },
-          "409": {
+          "204": {
             "description": "No description"
           }
         },
@@ -1149,35 +1207,32 @@
         ]
       }
     },
-    "/v1.0/crawl/jobs/bulk-delete": {
+    "/v1.0/crawl/discover-listing": {
       "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Delete a batch of jobs and their backing tenders",
-        "operationId": "BulkDeleteCrawlJobs",
+        "summary": "Given a site homepage or bare domain, locate the tender/project listing page on it",
+        "operationId": "DiscoverCrawlListing",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/bulkDeleteJobsRequest"
+                "$ref": "#/components/schemas/discoverListingRequest"
               }
             }
           }
         },
         "responses": {
           "200": {
-            "description": "Payload of BulkDeleteJobsResponse",
+            "description": "Payload of DiscoverListingResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/bulkDeleteJobsResponse"
+                  "$ref": "#/components/schemas/discoverListingResponse"
                 }
               }
             }
-          },
-          "400": {
-            "description": "No description"
           }
         },
         "security": [
@@ -1185,20 +1240,17 @@
             "Implicit": [
               "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
-          },
-          {
-            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}/jobs": {
-      "get": {
+    "/v1.0/crawl/sources/{name}/preview": {
+      "post": {
         "tags": [
           "Crawl"
         ],
-        "summary": "Recent ingestion jobs for this source, newest first",
-        "operationId": "ListCrawlJobs",
+        "summary": "Run a one-off discovery crawl for a single source and return the notices it would enqueue (no ingestion)",
+        "operationId": "PreviewCrawlSource",
         "parameters": [
           {
             "name": "name",
@@ -1207,29 +1259,21 @@
             "schema": {
               "type": "string"
             }
-          },
-          {
-            "name": "limit",
-            "in": "query",
-            "description": "Max jobs to return (default 50)",
-            "schema": {
-              "type": "string"
-            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of AgentJob",
+            "description": "Payload of CrawlPreviewResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/agentJob"
-                  }
+                  "$ref": "#/components/schemas/crawlPreviewResponse"
                 }
               }
             }
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -1244,18 +1288,17 @@
         ]
       }
     },
-    "/v1.0/crawl/sources/{name}/preview": {
-      "post": {
+    "/v1.0/consultants": {
+      "get": {
         "tags": [
-          "Crawl"
+          "Consultants"
         ],
-        "summary": "Run a one-off discovery crawl for a single source and return the notices it would enqueue (no ingestion)",
-        "operationId": "PreviewCrawlSource",
+        "summary": "List all known consultants (for manual selection)",
+        "operationId": "ListConsultants",
         "parameters": [
           {
-            "name": "name",
-            "in": "path",
-            "required": true,
+            "name": "query",
+            "in": "query",
             "schema": {
               "type": "string"
             }
@@ -1263,17 +1306,17 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of CrawlPreviewResponse",
+            "description": "Payload of Array of ConsultantSummary",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/crawlPreviewResponse"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/consultantSummary"
+                  }
                 }
               }
             }
-          },
-          "404": {
-            "description": "No description"
           }
         },
         "security": [
@@ -1527,13 +1570,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}": {
-      "patch": {
+    "/v1.0/tenders/{id}/documents/{docId}/extract-questions": {
+      "post": {
         "tags": [
           "Documents"
         ],
-        "summary": "Patch tender document flags (e.g. set as competence matrix source)",
-        "operationId": "PatchTenderDocument",
+        "summary": "Start extraction of fillable questions from a document",
+        "operationId": "StartQuestionExtraction",
         "parameters": [
           {
             "name": "id",
@@ -1552,23 +1595,13 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/patchDocumentRequest"
-              }
-            }
-          },
-          "required": true
-        },
         "responses": {
-          "200": {
-            "description": "Payload of PatchDocumentResponse",
+          "202": {
+            "description": "Payload of Object",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/patchDocumentResponse"
+                  "type": "object"
                 }
               }
             }
@@ -1587,14 +1620,16 @@
             "ApiKey": []
           }
         ]
-      },
-      "delete": {
+      }
+    },
+    "/v1.0/tenders/{id}/documents/{docId}/fill-questions": {
+      "post": {
         "tags": [
           "Documents"
         ],
-        "summary": "Delete a tender document (and its blob + related answers)",
-        "operationId": "DeleteTenderDocument",
-        "parameters": [
+        "summary": "Start filling tender question answers per consultant",
+        "operationId": "StartQuestionFill",
+        "parameters": [
           {
             "name": "id",
             "in": "path",
@@ -1612,51 +1647,16 @@
             }
           }
         ],
-        "responses": {
-          "204": {
-            "description": "No description"
-          },
-          "404": {
-            "description": "No description"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/{id}/documents/{docId}/extract-questions": {
-      "post": {
-        "tags": [
-          "Documents"
-        ],
-        "summary": "Start extraction of fillable questions from a document",
-        "operationId": "StartQuestionExtraction",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/questionFillRequest"
+              }
             }
           },
-          {
-            "name": "docId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
+          "required": true
+        },
         "responses": {
           "202": {
             "description": "Payload of Object",
@@ -1684,13 +1684,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}/fill-questions": {
-      "post": {
+    "/v1.0/tenders/{id}/documents/{docId}": {
+      "patch": {
         "tags": [
           "Documents"
         ],
-        "summary": "Start filling tender question answers per consultant",
-        "operationId": "StartQuestionFill",
+        "summary": "Patch tender document flags (e.g. set as competence matrix source)",
+        "operationId": "PatchTenderDocument",
         "parameters": [
           {
             "name": "id",
@@ -1713,19 +1713,19 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/questionFillRequest"
+                "$ref": "#/components/schemas/patchDocumentRequest"
               }
             }
           },
           "required": true
         },
         "responses": {
-          "202": {
-            "description": "Payload of Object",
+          "200": {
+            "description": "Payload of PatchDocumentResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object"
+                  "$ref": "#/components/schemas/patchDocumentResponse"
                 }
               }
             }
@@ -1744,37 +1744,37 @@
             "ApiKey": []
           }
         ]
-      }
-    },
-    "/v1.0/consultants": {
-      "get": {
+      },
+      "delete": {
         "tags": [
-          "Consultants"
+          "Documents"
         ],
-        "summary": "List all known consultants (for manual selection)",
-        "operationId": "ListConsultants",
+        "summary": "Delete a tender document (and its blob + related answers)",
+        "operationId": "DeleteTenderDocument",
         "parameters": [
           {
-            "name": "query",
-            "in": "query",
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
             "schema": {
               "type": "string"
             }
           }
         ],
         "responses": {
-          "200": {
-            "description": "Payload of Array of ConsultantSummary",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/consultantSummary"
-                  }
-                }
-              }
-            }
+          "204": {
+            "description": "No description"
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -1942,6 +1942,145 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
+        "parameters": [
+          {
+            "name": "sfId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of TenderView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of TenderView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the engagement.",
+        "operationId": "RefreshTenderSalesforceLink",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of TenderView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/opportunities": {
       "get": {
         "tags": [
@@ -2118,24 +2257,33 @@
         ]
       }
     },
-    "/v1.0/salesforce/opportunities/{sfId}/import": {
+    "/v1.0/tenders/{id}/consultants": {
       "post": {
         "tags": [
-          "Salesforce"
+          "Tenders"
         ],
-        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
-        "operationId": "ImportSalesforceOpportunity",
+        "summary": "Assign a consultant to a tender. Idempotent: assigning the same email twice refreshes Name/Note but does not create duplicates.",
+        "operationId": "AssignConsultant",
         "parameters": [
           {
-            "name": "sfId",
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "Salesforce Opportunity Id."
+            }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/assignedConsultant"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
             "description": "Payload of TenderView",
@@ -2149,9 +2297,6 @@
           },
           "404": {
             "description": "No description"
-          },
-          "409": {
-            "description": "A tender is already linked to this Opportunity."
           }
         },
         "security": [
@@ -2166,13 +2311,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/salesforce": {
+    "/v1.0/tenders/{id}/slack-messages": {
       "post": {
         "tags": [
-          "Salesforce"
+          "Tenders"
         ],
-        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
-        "operationId": "PromoteTenderToSalesforce",
+        "summary": "Queue a Slack message for a tender (Service Bus → notifications-function).",
+        "operationId": "SendTenderSlackMessage",
         "parameters": [
           {
             "name": "id",
@@ -2183,22 +2328,25 @@
             }
           }
         ],
-        "responses": {
-          "200": {
-            "description": "Payload of TenderView",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderView"
-                }
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sendTenderSlackMessageRequest"
               }
             }
           },
-          "404": {
+          "required": true
+        },
+        "responses": {
+          "204": {
             "description": "No description"
           },
-          "409": {
-            "description": "Tender is already linked to a Salesforce Opportunity."
+          "400": {
+            "description": "No description"
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -2213,13 +2361,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/salesforce/refresh": {
-      "post": {
+    "/v1.0/tenders/{id}/consultants/{email}": {
+      "delete": {
         "tags": [
-          "Salesforce"
+          "Tenders"
         ],
-        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the engagement.",
-        "operationId": "RefreshTenderSalesforceLink",
+        "summary": "Remove a consultant assignment from a tender. No-op if the email isn't assigned.",
+        "operationId": "UnassignConsultant",
         "parameters": [
           {
             "name": "id",
@@ -2228,6 +2376,14 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "email",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {
@@ -2462,133 +2618,6 @@
         ]
       }
     },
-    "/v1.0/tenders/backfill-slugs": {
-      "post": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Assign a slug to every tender that doesn't have one yet. Idempotent — safe to re-run.",
-        "operationId": "BackfillTenderSlugs",
-        "responses": {
-          "200": {
-            "description": "Payload of BackfillSlugsResult",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/backfillSlugsResult"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/{id}/reingest": {
-      "post": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
-        "operationId": "ReingestTender",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of AgentJob",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/agentJob"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "No description"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/{id}/jobs/{jobId}/snapshot": {
-      "get": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Return the tender as it looked right after a given agent job ran (time-travel view).",
-        "operationId": "GetTenderJobSnapshot",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "jobId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of TenderView",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderView"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "No description"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
     "/v1.0/tenders/{id}/cv-proposal": {
       "put": {
         "tags": [
@@ -2749,46 +2778,23 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/consultants": {
+    "/v1.0/tenders/backfill-slugs": {
       "post": {
         "tags": [
           "Tenders"
         ],
-        "summary": "Assign a consultant to a tender. Idempotent: assigning the same email twice refreshes Name/Note but does not create duplicates.",
-        "operationId": "AssignConsultant",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/assignedConsultant"
-              }
-            }
-          },
-          "required": true
-        },
+        "summary": "Assign a slug to every tender that doesn't have one yet. Idempotent — safe to re-run.",
+        "operationId": "BackfillTenderSlugs",
         "responses": {
           "200": {
-            "description": "Payload of TenderView",
+            "description": "Payload of BackfillSlugsResult",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/tenderView"
+                  "$ref": "#/components/schemas/backfillSlugsResult"
                 }
               }
             }
-          },
-          "404": {
-            "description": "No description"
           }
         },
         "security": [
@@ -2803,13 +2809,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/slack-messages": {
+    "/v1.0/tenders/{id}/reingest": {
       "post": {
         "tags": [
           "Tenders"
         ],
-        "summary": "Queue a Slack message for a tender (Service Bus → notifications-function).",
-        "operationId": "SendTenderSlackMessage",
+        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
+        "operationId": "ReingestTender",
         "parameters": [
           {
             "name": "id",
@@ -2820,23 +2826,17 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/sendTenderSlackMessageRequest"
+        "responses": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
               }
             }
           },
-          "required": true
-        },
-        "responses": {
-          "204": {
-            "description": "No description"
-          },
-          "400": {
-            "description": "No description"
-          },
           "404": {
             "description": "No description"
           }
@@ -2853,13 +2853,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/consultants/{email}": {
-      "delete": {
+    "/v1.0/tenders/{id}/jobs/{jobId}/snapshot": {
+      "get": {
         "tags": [
           "Tenders"
         ],
-        "summary": "Remove a consultant assignment from a tender. No-op if the email isn't assigned.",
-        "operationId": "UnassignConsultant",
+        "summary": "Return the tender as it looked right after a given agent job ran (time-travel view).",
+        "operationId": "GetTenderJobSnapshot",
         "parameters": [
           {
             "name": "id",
@@ -2870,7 +2870,7 @@
             }
           },
           {
-            "name": "email",
+            "name": "jobId",
             "in": "path",
             "required": true,
             "schema": {