@snokam/mcp-api 0.154.0 → 0.155.0

package/specs/production/sales.json

@@ -1288,35 +1288,40 @@
         ]
       }
     },
-    "/v1.0/consultants": {
-      "get": {
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
         "tags": [
-          "Consultants"
+          "Salesforce"
         ],
-        "summary": "List all known consultants (for manual selection)",
-        "operationId": "ListConsultants",
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
         "parameters": [
           {
-            "name": "query",
-            "in": "query",
+            "name": "sfId",
+            "in": "path",
+            "required": true,
             "schema": {
               "type": "string"
-            }
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of ConsultantSummary",
+            "description": "Payload of TenderView",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/consultantSummary"
-                  }
+                  "$ref": "#/components/schemas/tenderView"
                 }
               }
             }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
           }
         },
         "security": [
@@ -1331,13 +1336,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents": {
-      "get": {
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
         "tags": [
-          "Documents"
+          "Salesforce"
         ],
-        "summary": "List documents for a tender",
-        "operationId": "ListTenderDocuments",
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
         "parameters": [
           {
             "name": "id",
@@ -1350,20 +1355,20 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of TenderDocument",
+            "description": "Payload of TenderView",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/tenderDocument"
-                  }
+                  "$ref": "#/components/schemas/tenderView"
                 }
               }
             }
           },
           "404": {
             "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
           }
         },
         "security": [
@@ -1376,13 +1381,15 @@
             "ApiKey": []
           }
         ]
-      },
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
       "post": {
         "tags": [
-          "Documents"
+          "Salesforce"
         ],
-        "summary": "Upload a new document to a tender",
-        "operationId": "UploadTenderDocument",
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the engagement.",
+        "operationId": "RefreshTenderSalesforceLink",
         "parameters": [
           {
             "name": "id",
@@ -1395,11 +1402,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of TenderDocument",
+            "description": "Payload of TenderView",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/tenderDocument"
+                  "$ref": "#/components/schemas/tenderView"
                 }
               }
             }
@@ -1420,44 +1427,45 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}/download-url": {
+    "/v1.0/salesforce/opportunities": {
       "get": {
         "tags": [
-          "Documents"
+          "Salesforce"
         ],
-        "summary": "Get a short-lived download URL for a document",
-        "operationId": "GetDocumentDownloadUrl",
+        "summary": "List Salesforce Opportunities (open by default).",
+        "operationId": "ListSalesforceOpportunities",
         "parameters": [
           {
-            "name": "id",
-            "in": "path",
-            "required": true,
+            "name": "includeClosed",
+            "in": "query",
             "schema": {
-              "type": "string"
-            }
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include closed opportunities (default false)."
           },
           {
-            "name": "docId",
-            "in": "path",
-            "required": true,
+            "name": "limit",
+            "in": "query",
             "schema": {
-              "type": "string"
-            }
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Row cap, max 200 (default 100)."
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Object",
+            "description": "Payload of Array of CrmOpportunity",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/crmOpportunity"
+                  }
                 }
               }
             }
-          },
-          "404": {
-            "description": "No description"
           }
         },
         "security": [
@@ -1472,24 +1480,81 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}/download": {
+    "/v1.0/salesforce/opportunity-stages": {
       "get": {
         "tags": [
-          "Documents"
+          "Salesforce"
         ],
-        "summary": "Download a single document",
-        "operationId": "DownloadDocument",
-        "parameters": [
+        "summary": "List the SF org's Opportunity pipeline stages in configured order.",
+        "operationId": "ListSalesforceOpportunityStages",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of CrmStage",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/crmStage"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
           {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Batch-refresh the cached Salesforce state on every linked engagement for the current business.",
+        "operationId": "RefreshAllSalesforceLinks",
+        "responses": {
+          "200": {
+            "description": "Payload of CrmRefreshResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/crmRefreshResult"
+                }
+              }
             }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
           },
           {
-            "name": "docId",
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/stage": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Move the linked SF Opportunity to a new stage and refresh the cache.",
+        "operationId": "UpdateTenderSalesforceStage",
+        "parameters": [
+          {
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
@@ -1497,18 +1562,31 @@
             }
           }
         ],
+        "requestBody": {
+          "description": "The SF stage masterLabel/apiName to switch to.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/updateSalesforceStageRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Payload of Array of Byte",
+            "description": "Payload of TenderView",
             "content": {
-              "application/octet-stream": {
+              "application/json": {
                 "schema": {
-                  "type": "string",
-                  "format": "binary"
+                  "$ref": "#/components/schemas/tenderView"
                 }
               }
             }
           },
+          "400": {
+            "description": "Tender has no Salesforce link, or stageName is missing."
+          },
           "404": {
             "description": "No description"
           }
@@ -1525,18 +1603,17 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/download-all": {
+    "/v1.0/consultants": {
       "get": {
         "tags": [
-          "Documents"
+          "Consultants"
         ],
-        "summary": "Download all tender documents as a ZIP archive",
-        "operationId": "DownloadAllDocuments",
+        "summary": "List all known consultants (for manual selection)",
+        "operationId": "ListConsultants",
         "parameters": [
           {
-            "name": "id",
-            "in": "path",
-            "required": true,
+            "name": "query",
+            "in": "query",
             "schema": {
               "type": "string"
             }
@@ -1544,18 +1621,17 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of Byte",
+            "description": "Payload of Array of ConsultantSummary",
             "content": {
-              "application/zip": {
+              "application/json": {
                 "schema": {
-                  "type": "string",
-                  "format": "binary"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/consultantSummary"
+                  }
                 }
               }
             }
-          },
-          "404": {
-            "description": "No description"
           }
         },
         "security": [
@@ -1570,13 +1646,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}/extract-questions": {
-      "post": {
+    "/v1.0/tenders/{id}/documents": {
+      "get": {
         "tags": [
           "Documents"
         ],
-        "summary": "Start extraction of fillable questions from a document",
-        "operationId": "StartQuestionExtraction",
+        "summary": "List documents for a tender",
+        "operationId": "ListTenderDocuments",
         "parameters": [
           {
             "name": "id",
@@ -1585,23 +1661,18 @@
             "schema": {
               "type": "string"
             }
-          },
-          {
-            "name": "docId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
           }
         ],
         "responses": {
-          "202": {
-            "description": "Payload of Object",
+          "200": {
+            "description": "Payload of Array of TenderDocument",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/tenderDocument"
+                  }
                 }
               }
             }
@@ -1620,15 +1691,13 @@
             "ApiKey": []
           }
         ]
-      }
-    },
-    "/v1.0/tenders/{id}/documents/{docId}/fill-questions": {
+      },
       "post": {
         "tags": [
           "Documents"
         ],
-        "summary": "Start filling tender question answers per consultant",
-        "operationId": "StartQuestionFill",
+        "summary": "Upload a new document to a tender",
+        "operationId": "UploadTenderDocument",
         "parameters": [
           {
             "name": "id",
@@ -1637,33 +1706,15 @@
             "schema": {
               "type": "string"
             }
-          },
-          {
-            "name": "docId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/questionFillRequest"
-              }
-            }
-          },
-          "required": true
-        },
         "responses": {
-          "202": {
-            "description": "Payload of Object",
+          "200": {
+            "description": "Payload of TenderDocument",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object"
+                  "$ref": "#/components/schemas/tenderDocument"
                 }
               }
             }
@@ -1684,13 +1735,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/documents/{docId}": {
-      "patch": {
+    "/v1.0/tenders/{id}/documents/{docId}/download-url": {
+      "get": {
         "tags": [
           "Documents"
         ],
-        "summary": "Patch tender document flags (e.g. set as competence matrix source)",
-        "operationId": "PatchTenderDocument",
+        "summary": "Get a short-lived download URL for a document",
+        "operationId": "GetDocumentDownloadUrl",
         "parameters": [
           {
             "name": "id",
@@ -1709,23 +1760,13 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/patchDocumentRequest"
-              }
-            }
-          },
-          "required": true
-        },
         "responses": {
           "200": {
-            "description": "Payload of PatchDocumentResponse",
+            "description": "Payload of Object",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/patchDocumentResponse"
+                  "type": "object"
                 }
               }
             }
@@ -1744,13 +1785,15 @@
             "ApiKey": []
           }
         ]
-      },
-      "delete": {
+      }
+    },
+    "/v1.0/tenders/{id}/documents/{docId}/download": {
+      "get": {
         "tags": [
           "Documents"
         ],
-        "summary": "Delete a tender document (and its blob + related answers)",
-        "operationId": "DeleteTenderDocument",
+        "summary": "Download a single document",
+        "operationId": "DownloadDocument",
         "parameters": [
           {
             "name": "id",
@@ -1770,8 +1813,16 @@
           }
         ],
         "responses": {
-          "204": {
-            "description": "No description"
+          "200": {
+            "description": "Payload of Array of Byte",
+            "content": {
+              "application/octet-stream": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
           },
           "404": {
             "description": "No description"
@@ -1789,16 +1840,16 @@
         ]
       }
     },
-    "/v1.0/protected/health/{provider}": {
+    "/v1.0/tenders/{id}/documents/download-all": {
       "get": {
         "tags": [
-          "Health"
+          "Documents"
         ],
-        "summary": "Checks an integration's connectivity",
-        "operationId": "SalesIntegrationHealth",
+        "summary": "Download all tender documents as a ZIP archive",
+        "operationId": "DownloadAllDocuments",
         "parameters": [
           {
-            "name": "provider",
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
@@ -1808,14 +1859,18 @@
         ],
         "responses": {
           "200": {
-            "description": "Health result",
+            "description": "Payload of Array of Byte",
             "content": {
-              "application/json": {
+              "application/zip": {
                 "schema": {
-                  "$ref": "#/components/schemas/integrationHealthResult"
+                  "type": "string",
+                  "format": "binary"
                 }
               }
             }
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -1830,35 +1885,44 @@
         ]
       }
     },
-    "/v1.0/realtime/negotiate": {
+    "/v1.0/tenders/{id}/documents/{docId}/extract-questions": {
       "post": {
         "tags": [
-          "Realtime"
+          "Documents"
         ],
-        "summary": "Issue a SignalR access token + URL for the sales-live hub",
-        "operationId": "NegotiateSignalR",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/negotiateRequest"
-              }
+        "summary": "Start extraction of fillable questions from a document",
+        "operationId": "StartQuestionExtraction",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
             }
           }
-        },
+        ],
         "responses": {
-          "200": {
-            "description": "Payload of NegotiateResponse",
+          "202": {
+            "description": "Payload of Object",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/negotiateResponse"
+                  "type": "object"
                 }
               }
             }
           },
-          "503": {
-            "description": "SignalR is not configured on this instance; fall back to SSE"
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
@@ -1873,109 +1937,54 @@
         ]
       }
     },
-    "/v1.0/stream": {
-      "get": {
+    "/v1.0/tenders/{id}/documents/{docId}/fill-questions": {
+      "post": {
         "tags": [
-          "Realtime"
+          "Documents"
         ],
-        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
-        "operationId": "StreamAll",
+        "summary": "Start filling tender question answers per consultant",
+        "operationId": "StartQuestionFill",
         "parameters": [
           {
-            "name": "channels",
-            "in": "query",
-            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
+            "name": "id",
+            "in": "path",
+            "required": true,
             "schema": {
               "type": "string"
             }
-          }
-        ],
-        "responses": {},
-        "security": [
-          {
-            "Implicit": [
-              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
-            ]
           },
           {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
-        "operationId": "DeprecatedTenderStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
-            ]
-          },
-          {
-            "ApiKey": []
-          }
-        ]
-      }
-    },
-    "/v1.0/crawl/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
-        "operationId": "DeprecatedCrawlStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/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",
+            "name": "docId",
             "in": "path",
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "Salesforce Opportunity Id."
+            }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/questionFillRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
-          "200": {
-            "description": "Payload of TenderView",
+          "202": {
+            "description": "Payload of Object",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/tenderView"
+                  "type": "object"
                 }
               }
             }
           },
           "404": {
             "description": "No description"
-          },
-          "409": {
-            "description": "A tender is already linked to this Opportunity."
           }
         },
         "security": [
@@ -1990,13 +1999,13 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/salesforce": {
-      "post": {
+    "/v1.0/tenders/{id}/documents/{docId}": {
+      "patch": {
         "tags": [
-          "Salesforce"
+          "Documents"
         ],
-        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
-        "operationId": "PromoteTenderToSalesforce",
+        "summary": "Patch tender document flags (e.g. set as competence matrix source)",
+        "operationId": "PatchTenderDocument",
         "parameters": [
           {
             "name": "id",
@@ -2005,24 +2014,39 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/patchDocumentRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Payload of TenderView",
+            "description": "Payload of PatchDocumentResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/tenderView"
+                  "$ref": "#/components/schemas/patchDocumentResponse"
                 }
               }
             }
           },
           "404": {
             "description": "No description"
-          },
-          "409": {
-            "description": "Tender is already linked to a Salesforce Opportunity."
           }
         },
         "security": [
@@ -2035,15 +2059,13 @@
             "ApiKey": []
           }
         ]
-      }
-    },
-    "/v1.0/tenders/{id}/salesforce/refresh": {
-      "post": {
+      },
+      "delete": {
         "tags": [
-          "Salesforce"
+          "Documents"
         ],
-        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the engagement.",
-        "operationId": "RefreshTenderSalesforceLink",
+        "summary": "Delete a tender document (and its blob + related answers)",
+        "operationId": "DeleteTenderDocument",
         "parameters": [
           {
             "name": "id",
@@ -2052,18 +2074,19 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {
-          "200": {
-            "description": "Payload of TenderView",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderView"
-                }
-              }
-            }
+          "204": {
+            "description": "No description"
           },
           "404": {
             "description": "No description"
@@ -2081,42 +2104,30 @@
         ]
       }
     },
-    "/v1.0/salesforce/opportunities": {
+    "/v1.0/protected/health/{provider}": {
       "get": {
         "tags": [
-          "Salesforce"
+          "Health"
         ],
-        "summary": "List Salesforce Opportunities (open by default).",
-        "operationId": "ListSalesforceOpportunities",
+        "summary": "Checks an integration's connectivity",
+        "operationId": "SalesIntegrationHealth",
         "parameters": [
           {
-            "name": "includeClosed",
-            "in": "query",
-            "schema": {
-              "type": "boolean"
-            },
-            "x-ms-summary": "Include closed opportunities (default false)."
-          },
-          {
-            "name": "limit",
-            "in": "query",
+            "name": "provider",
+            "in": "path",
+            "required": true,
             "schema": {
-              "type": "integer",
-              "format": "int32"
-            },
-            "x-ms-summary": "Row cap, max 200 (default 100)."
+              "type": "string"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of CrmOpportunity",
+            "description": "Health result",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/crmOpportunity"
-                  }
+                  "$ref": "#/components/schemas/integrationHealthResult"
                 }
               }
             }
@@ -2134,26 +2145,35 @@
         ]
       }
     },
-    "/v1.0/salesforce/opportunity-stages": {
-      "get": {
+    "/v1.0/realtime/negotiate": {
+      "post": {
         "tags": [
-          "Salesforce"
+          "Realtime"
         ],
-        "summary": "List the SF org's Opportunity pipeline stages in configured order.",
-        "operationId": "ListSalesforceOpportunityStages",
+        "summary": "Issue a SignalR access token + URL for the sales-live hub",
+        "operationId": "NegotiateSignalR",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/negotiateRequest"
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
-            "description": "Payload of Array of CrmStage",
+            "description": "Payload of NegotiateResponse",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/crmStage"
-                  }
+                  "$ref": "#/components/schemas/negotiateResponse"
                 }
               }
             }
+          },
+          "503": {
+            "description": "SignalR is not configured on this instance; fall back to SSE"
           }
         },
         "security": [
@@ -2168,25 +2188,24 @@
         ]
       }
     },
-    "/v1.0/salesforce/refresh": {
-      "post": {
+    "/v1.0/stream": {
+      "get": {
         "tags": [
-          "Salesforce"
+          "Realtime"
         ],
-        "summary": "Batch-refresh the cached Salesforce state on every linked engagement for the current business.",
-        "operationId": "RefreshAllSalesforceLinks",
-        "responses": {
-          "200": {
-            "description": "Payload of SalesforceRefreshResult",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/salesforceRefreshResult"
-                }
-              }
+        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
+        "operationId": "StreamAll",
+        "parameters": [
+          {
+            "name": "channels",
+            "in": "query",
+            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
+            "schema": {
+              "type": "string"
             }
           }
-        },
+        ],
+        "responses": {},
         "security": [
           {
             "Implicit": [
@@ -2199,52 +2218,15 @@
         ]
       }
     },
-    "/v1.0/tenders/{id}/salesforce/stage": {
-      "post": {
+    "/v1.0/tenders/stream-redirect": {
+      "get": {
         "tags": [
-          "Salesforce"
-        ],
-        "summary": "Move the linked SF Opportunity to a new stage and refresh the cache.",
-        "operationId": "UpdateTenderSalesforceStage",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
+          "Realtime"
         ],
-        "requestBody": {
-          "description": "The SF stage masterLabel/apiName to switch to.",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/updateSalesforceStageRequest"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Payload of TenderView",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderView"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Tender has no Salesforce link, or stageName is missing."
-          },
-          "404": {
-            "description": "No description"
-          }
-        },
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
+        "operationId": "DeprecatedTenderStream",
+        "responses": {},
+        "deprecated": true,
         "security": [
           {
             "Implicit": [
@@ -2257,6 +2239,24 @@
         ]
       }
     },
+    "/v1.0/crawl/stream-redirect": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
+        "operationId": "DeprecatedCrawlStream",
+        "responses": {},
+        "deprecated": true,
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/consultants": {
       "post": {
         "tags": [
@@ -3875,6 +3875,19 @@
           }
         }
       },
+      "crmRefreshResult": {
+        "type": "object",
+        "properties": {
+          "checked": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "updated": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
       "crmStage": {
         "type": "object",
         "properties": {
@@ -4265,19 +4278,6 @@
         },
         "nullable": true
       },
-      "salesforceRefreshResult": {
-        "type": "object",
-        "properties": {
-          "checked": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "updated": {
-            "type": "integer",
-            "format": "int32"
-          }
-        }
-      },
       "sendTenderSlackMessageRequest": {
         "type": "object",
         "properties": {