@snokam/mcp-api 0.73.2 → 0.73.4

package/specs/test/recruitment.json

@@ -261,14 +261,14 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/notification-preview": {
-      "get": {
+    "/v1.0/protected/candidates/{id}/promote": {
+      "post": {
         "tags": [
           "Candidates"
         ],
-        "summary": "Preview the email/SMS that would be sent for a candidate event",
-        "description": "Renders the email + SMS templates for the given event using the candidate's current data. Use to populate the confirm modal before a status change.",
-        "operationId": "GetCandidateNotificationPreview",
+        "summary": "Promote a public job application to the pipeline",
+        "description": "Flips fromApplication=false and bumps status to INTRODUCTION so the candidate appears in the admin pipeline.",
+        "operationId": "PromoteApplication",
         "parameters": [
           {
             "name": "id",
@@ -278,31 +278,22 @@
               "type": "string"
             },
             "x-ms-summary": "Candidate Sanity id"
-          },
-          {
-            "name": "event",
-            "in": "query",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "Event name: Created, Introduction, Offer, Signed, Onboarding, UserCreationReview, Offboarding"
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of CandidateNotificationPreview",
+            "description": "The promoted candidate",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/candidateNotificationPreview"
+                  "$ref": "#/components/schemas/sanityCandidate"
                 }
               }
             },
             "x-ms-summary": "Success"
           },
           "400": {
-            "description": "Payload of Object",
+            "description": "Candidate is not a public job application",
             "content": {
               "application/json": {
                 "schema": {
@@ -330,20 +321,150 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/notification-preview": {
+    "/v1.0/protected/candidates/{id}/reject": {
       "post": {
         "tags": [
           "Candidates"
         ],
-        "summary": "Preview a candidate notification before the candidate is created",
-        "description": "Used by the create form to render the email/SMS that will be sent on submit, given the in-progress candidate fields. No recruiter resolution — uses the team-fallback signoff.",
-        "operationId": "PreviewCandidateNotification",
+        "summary": "Reject a candidate",
+        "description": "Sets status=REJECTED. Optionally sends an admin-edited rejection email and/or SMS — both default to off so the status flip is the only guaranteed side-effect.",
+        "operationId": "RejectCandidate",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          }
+        ],
         "requestBody": {
-          "description": "Event + candidate-shaped fields",
+          "description": "Optional admin-edited email/SMS draft + per-channel send flags. Omit to reject without notifying.",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/candidateNotificationPreviewRequest"
+                "$ref": "#/components/schemas/rejectCandidateMessage"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of SanityCandidate",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/sanityCandidate"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/job-positions": {
+      "get": {
+        "tags": [
+          "JobPositions"
+        ],
+        "summary": "List published job positions",
+        "description": "Returns every job position document. Used by the admin stillinger page.",
+        "operationId": "ListJobPositions",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SanityJobPosition",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanityJobPosition"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/systems": {
+      "get": {
+        "tags": [
+          "Systems"
+        ],
+        "summary": "List systems used for onboarding checklists",
+        "description": "Returns every system document. Used by the candidate detail and systems library pages.",
+        "operationId": "ListSystems",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SanitySystemsInner",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanitySystemsInner"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Systems"
+        ],
+        "summary": "Create a system",
+        "description": "Adds a new system to the onboarding/offboarding system library.",
+        "operationId": "CreateSystem",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityCreateSystem"
               }
             }
           },
@@ -351,11 +472,11 @@
         },
         "responses": {
           "200": {
-            "description": "Payload of CandidateNotificationPreview",
+            "description": "Payload of SanitySystemsInner",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/candidateNotificationPreview"
+                  "$ref": "#/components/schemas/sanitySystemsInner"
                 }
               }
             },
@@ -386,55 +507,143 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/promote": {
-      "post": {
+    "/v1.0/protected/onboarding-chain/automated-system-titles": {
+      "get": {
         "tags": [
-          "Candidates"
+          "Systems"
         ],
-        "summary": "Promote a public job application to the pipeline",
-        "description": "Flips fromApplication=false and bumps status to INTRODUCTION so the candidate appears in the admin pipeline.",
-        "operationId": "PromoteApplication",
-        "parameters": [
+        "summary": "List systems handled end-to-end by the onboarding chain",
+        "description": "Returns title + maturity status (stable / beta) so the admin UI can badge systems that need no per-row admin action and flag the experimental ones.",
+        "operationId": "GetChainAutomatedSystemTitles",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of ChainAutomatedSystem",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/chainAutomatedSystem"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
           {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/onboarding-tasks": {
+      "get": {
+        "tags": [
+          "Tasks"
+        ],
+        "summary": "List every onboarding task",
+        "description": "Returns all onboarding tasks with their Portable Text description so the admin can render an editable checklist with contextual notes.",
+        "operationId": "ListOnboardingTasks",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SanityTask",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanityTask"
+                  }
+                }
+              }
             },
-            "x-ms-summary": "Candidate Sanity id"
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
           }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/offboarding-tasks": {
+      "get": {
+        "tags": [
+          "Tasks"
         ],
+        "summary": "List every offboarding task",
+        "description": "Returns all offboarding tasks with their Portable Text description for the admin offboarding checklist.",
+        "operationId": "ListOffboardingTasks",
         "responses": {
           "200": {
-            "description": "The promoted candidate",
+            "description": "Payload of Array of SanityTask",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanityCandidate"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanityTask"
+                  }
                 }
               }
             },
             "x-ms-summary": "Success"
           },
-          "400": {
-            "description": "Candidate is not a public job application",
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/onboarding-tasks/with-reminder": {
+      "get": {
+        "tags": [
+          "Tasks"
+        ],
+        "summary": "List onboarding tasks with a Slack reminder",
+        "description": "Returns onboarding tasks that have reminderWeeksBefore + reminderSlackChannel set. Used by the admin oppgaver page.",
+        "operationId": "ListOnboardingTasksWithReminder",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SanityOnboardingTask",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanityOnboardingTask"
+                  }
                 }
               }
             },
-            "x-ms-summary": "Bad Request"
+            "x-ms-summary": "Success"
           },
           "401": {
             "description": "No description",
             "x-ms-summary": "Unauthorized"
-          },
-          "404": {
-            "description": "No description",
-            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -446,41 +655,31 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/onboard/{system}": {
+    "/v1.0/protected/tasks": {
       "post": {
         "tags": [
-          "Candidates"
+          "Tasks"
         ],
-        "summary": "Trigger automated onboarding for a single chain step",
-        "description": "Re-runs one named onboarding step (slug matches the timeline step ids — e.g. 'microsoft-365', 'license-assignment', 'github-org-invite'). Used by the admin UI's per-step retry button when an earlier chain run partially failed.",
-        "operationId": "OnboardCandidateSystem",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "Candidate Sanity id"
+        "summary": "Create an onboarding or offboarding task",
+        "description": "Adds a new task document to the library with optional Portable Text description and Slack reminder settings.",
+        "operationId": "CreateTask",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityCreateTask"
+              }
+            }
           },
-          {
-            "name": "system",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "System slug (e.g. 'microsoft-365')"
-          }
-        ],
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Uniform onboarding result with status + message",
+            "description": "Payload of SanityTask",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/onboardingResult"
+                  "$ref": "#/components/schemas/sanityTask"
                 }
               }
             },
@@ -500,10 +699,6 @@
           "401": {
             "description": "No description",
             "x-ms-summary": "Unauthorized"
-          },
-          "404": {
-            "description": "No description",
-            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -515,14 +710,14 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/offboard/{system}": {
-      "post": {
+    "/v1.0/protected/tasks/{id}": {
+      "patch": {
         "tags": [
-          "Candidates"
+          "Tasks"
         ],
-        "summary": "Trigger automated offboarding for a single chain step",
-        "description": "Mirror of OnboardCandidateSystem for the offboarding chain. Re-runs one named offboarding step (e.g. 'microsoft-365-disable', 'license-revoke', 'github-org-remove').",
-        "operationId": "OffboardCandidateSystem",
+        "summary": "Update an onboarding or offboarding task",
+        "description": "Partially updates a task. Omitted fields are left unchanged; pass null to clear an optional field.",
+        "operationId": "PatchTask",
         "parameters": [
           {
             "name": "id",
@@ -530,26 +725,26 @@
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "Candidate Sanity id"
-          },
-          {
-            "name": "system",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "Step slug (e.g. 'microsoft-365-disable')"
+            }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityPatchTask"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Uniform onboarding result with status + message",
+            "description": "Payload of SanityTask",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/onboardingResult"
+                  "$ref": "#/components/schemas/sanityTask"
                 }
               }
             },
@@ -582,16 +777,14 @@
             ]
           }
         ]
-      }
-    },
-    "/v1.0/protected/candidates/{id}/onboard-full/stream": {
-      "post": {
+      },
+      "delete": {
         "tags": [
-          "Candidates"
+          "Tasks"
         ],
-        "summary": "Run the onboarding chain with a live SSE event feed",
-        "description": "Same chain as /onboard-full but streams Server-Sent Events (`event: step`) as each step starts (`status:running`) and finishes (`succeeded`/`failed`). Closes with `event: done`. Frontend uses fetch streaming so we can pass a Bearer token; EventSource doesn't support custom headers.",
-        "operationId": "OnboardCandidateFullStream",
+        "summary": "Delete a task",
+        "description": "Removes a task from the library. Does not touch candidate checklists that reference it.",
+        "operationId": "DeleteTask",
         "parameters": [
           {
             "name": "id",
@@ -604,48 +797,11 @@
         ],
         "responses": {
           "200": {
-            "description": "No description",
-            "x-ms-summary": "SSE stream of OnboardingResult frames"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/candidates/{id}/onboard-full": {
-      "post": {
-        "tags": [
-          "Candidates"
-        ],
-        "summary": "Run the full automated onboarding chain",
-        "description": "Provisions the candidate's Microsoft 365 user, then triggers an Azure AD → Sanity sync to create the matching employee doc. Returns one OnboardingResult row per step so the admin UI can render a live timeline.",
-        "operationId": "OnboardCandidateFull",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "Candidate Sanity id"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Per-step results",
+            "description": "Payload of SanityTask",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/onboardingResult"
-                  }
+                  "$ref": "#/components/schemas/sanityTask"
                 }
               }
             },
@@ -669,14 +825,13 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/offboard-full": {
-      "post": {
+    "/v1.0/protected/systems/{id}": {
+      "patch": {
         "tags": [
-          "Candidates"
+          "Systems"
         ],
-        "summary": "Run the full automated offboarding chain",
-        "description": "Disables the candidate's Microsoft 365 user and triggers an Azure AD → Sanity sync so the employee doc reflects the disabled state.",
-        "operationId": "OffboardCandidateFull",
+        "summary": "Update a system",
+        "operationId": "PatchSystem",
         "parameters": [
           {
             "name": "id",
@@ -687,21 +842,39 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityPatchSystem"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Per-step results",
+            "description": "Payload of SanitySystemsInner",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/onboardingResult"
-                  }
+                  "$ref": "#/components/schemas/sanitySystemsInner"
                 }
               }
             },
             "x-ms-summary": "Success"
           },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
           "401": {
             "description": "No description",
             "x-ms-summary": "Unauthorized"
@@ -718,16 +891,13 @@
             ]
           }
         ]
-      }
-    },
-    "/v1.0/protected/candidates/{id}/offboard-full/stream": {
-      "post": {
+      },
+      "delete": {
         "tags": [
-          "Candidates"
+          "Systems"
         ],
-        "summary": "Offboarding chain with a live SSE event feed",
-        "description": "Streams the offboarding chain step-by-step as Server-Sent Events. Mirrors /onboard-full/stream.",
-        "operationId": "OffboardCandidateFullStream",
+        "summary": "Delete a system",
+        "operationId": "DeleteSystem",
         "parameters": [
           {
             "name": "id",
@@ -740,8 +910,23 @@
         ],
         "responses": {
           "200": {
+            "description": "Payload of SanitySystemsInner",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/sanitySystemsInner"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
             "description": "No description",
-            "x-ms-summary": "SSE stream of OnboardingResult frames"
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -753,42 +938,24 @@
         ]
       }
     },
-    "/v1.0/protected/candidates/{id}/reject": {
-      "post": {
-        "tags": [
-          "Candidates"
-        ],
-        "summary": "Reject a candidate",
-        "description": "Sets status=REJECTED. Optionally sends an admin-edited rejection email and/or SMS — both default to off so the status flip is the only guaranteed side-effect.",
-        "operationId": "RejectCandidate",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "x-ms-summary": "Candidate Sanity id"
-          }
-        ],
-        "requestBody": {
-          "description": "Optional admin-edited email/SMS draft + per-channel send flags. Omit to reject without notifying.",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/rejectCandidateMessage"
-              }
-            }
-          }
-        },
+    "/v1.0/protected/employees": {
+      "get": {
+        "tags": [
+          "Employees"
+        ],
+        "summary": "List employees for buddy/recruiter assignment",
+        "description": "Lightweight employee list used by the candidate detail page's buddy and recruiter dropdowns.",
+        "operationId": "ListRecruitmentEmployees",
         "responses": {
           "200": {
-            "description": "Payload of SanityCandidate",
+            "description": "Payload of Array of SanityBasicEmployee",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanityCandidate"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/sanityBasicEmployee"
+                  }
                 }
               }
             },
@@ -797,10 +964,6 @@
           "401": {
             "description": "No description",
             "x-ms-summary": "Unauthorized"
-          },
-          "404": {
-            "description": "No description",
-            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -1029,245 +1192,7 @@
           },
           "404": {
             "description": "No description",
-            "x-ms-summary": "Not Found"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/job-positions": {
-      "get": {
-        "tags": [
-          "JobPositions"
-        ],
-        "summary": "List published job positions",
-        "description": "Returns every job position document. Used by the admin stillinger page.",
-        "operationId": "ListJobPositions",
-        "responses": {
-          "200": {
-            "description": "Payload of Array of SanityJobPosition",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanityJobPosition"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/systems": {
-      "get": {
-        "tags": [
-          "Systems"
-        ],
-        "summary": "List systems used for onboarding checklists",
-        "description": "Returns every system document. Used by the candidate detail and systems library pages.",
-        "operationId": "ListSystems",
-        "responses": {
-          "200": {
-            "description": "Payload of Array of SanitySystemsInner",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanitySystemsInner"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      },
-      "post": {
-        "tags": [
-          "Systems"
-        ],
-        "summary": "Create a system",
-        "description": "Adds a new system to the onboarding/offboarding system library.",
-        "operationId": "CreateSystem",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/sanityCreateSystem"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Payload of SanitySystemsInner",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/sanitySystemsInner"
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "400": {
-            "description": "Payload of Object",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            },
-            "x-ms-summary": "Bad Request"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/onboarding-chain/automated-system-titles": {
-      "get": {
-        "tags": [
-          "Systems"
-        ],
-        "summary": "List systems handled end-to-end by the onboarding chain",
-        "description": "Returns title + maturity status (stable / beta) so the admin UI can badge systems that need no per-row admin action and flag the experimental ones.",
-        "operationId": "GetChainAutomatedSystemTitles",
-        "responses": {
-          "200": {
-            "description": "Payload of Array of ChainAutomatedSystem",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/chainAutomatedSystem"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/onboarding-tasks": {
-      "get": {
-        "tags": [
-          "Tasks"
-        ],
-        "summary": "List every onboarding task",
-        "description": "Returns all onboarding tasks with their Portable Text description so the admin can render an editable checklist with contextual notes.",
-        "operationId": "ListOnboardingTasks",
-        "responses": {
-          "200": {
-            "description": "Payload of Array of SanityTask",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanityTask"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/protected/offboarding-tasks": {
-      "get": {
-        "tags": [
-          "Tasks"
-        ],
-        "summary": "List every offboarding task",
-        "description": "Returns all offboarding tasks with their Portable Text description for the admin offboarding checklist.",
-        "operationId": "ListOffboardingTasks",
-        "responses": {
-          "200": {
-            "description": "Payload of Array of SanityTask",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanityTask"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "No description",
-            "x-ms-summary": "Unauthorized"
+            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -1279,32 +1204,64 @@
         ]
       }
     },
-    "/v1.0/protected/onboarding-tasks/with-reminder": {
+    "/v1.0/protected/candidates/{id}/notification-preview": {
       "get": {
         "tags": [
-          "Tasks"
+          "Candidates"
+        ],
+        "summary": "Preview the email/SMS that would be sent for a candidate event",
+        "description": "Renders the email + SMS templates for the given event using the candidate's current data. Use to populate the confirm modal before a status change.",
+        "operationId": "GetCandidateNotificationPreview",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          },
+          {
+            "name": "event",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Event name: Created, Introduction, Offer, Signed, Onboarding, UserCreationReview, Offboarding"
+          }
         ],
-        "summary": "List onboarding tasks with a Slack reminder",
-        "description": "Returns onboarding tasks that have reminderWeeksBefore + reminderSlackChannel set. Used by the admin oppgaver page.",
-        "operationId": "ListOnboardingTasksWithReminder",
         "responses": {
           "200": {
-            "description": "Payload of Array of SanityOnboardingTask",
+            "description": "Payload of CandidateNotificationPreview",
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanityOnboardingTask"
-                  }
+                  "$ref": "#/components/schemas/candidateNotificationPreview"
                 }
               }
             },
             "x-ms-summary": "Success"
           },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
           "401": {
             "description": "No description",
             "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
           }
         },
         "security": [
@@ -1316,19 +1273,20 @@
         ]
       }
     },
-    "/v1.0/protected/tasks": {
+    "/v1.0/protected/candidates/notification-preview": {
       "post": {
         "tags": [
-          "Tasks"
+          "Candidates"
         ],
-        "summary": "Create an onboarding or offboarding task",
-        "description": "Adds a new task document to the library with optional Portable Text description and Slack reminder settings.",
-        "operationId": "CreateTask",
+        "summary": "Preview a candidate notification before the candidate is created",
+        "description": "Used by the create form to render the email/SMS that will be sent on submit, given the in-progress candidate fields. No recruiter resolution — uses the team-fallback signoff.",
+        "operationId": "PreviewCandidateNotification",
         "requestBody": {
+          "description": "Event + candidate-shaped fields",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/sanityCreateTask"
+                "$ref": "#/components/schemas/candidateNotificationPreviewRequest"
               }
             }
           },
@@ -1336,11 +1294,11 @@
         },
         "responses": {
           "200": {
-            "description": "Payload of SanityTask",
+            "description": "Payload of CandidateNotificationPreview",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanityTask"
+                  "$ref": "#/components/schemas/candidateNotificationPreview"
                 }
               }
             },
@@ -1371,14 +1329,14 @@
         ]
       }
     },
-    "/v1.0/protected/tasks/{id}": {
-      "patch": {
+    "/v1.0/protected/candidates/{id}/offboard/{system}": {
+      "post": {
         "tags": [
-          "Tasks"
+          "Candidates"
         ],
-        "summary": "Update an onboarding or offboarding task",
-        "description": "Partially updates a task. Omitted fields are left unchanged; pass null to clear an optional field.",
-        "operationId": "PatchTask",
+        "summary": "Trigger automated offboarding for a single chain step",
+        "description": "Mirror of OnboardCandidateSystem for the offboarding chain. Re-runs one named offboarding step (e.g. 'microsoft-365-disable', 'license-revoke', 'github-org-remove').",
+        "operationId": "OffboardCandidateSystem",
         "parameters": [
           {
             "name": "id",
@@ -1386,26 +1344,26 @@
             "required": true,
             "schema": {
               "type": "string"
-            }
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          },
+          {
+            "name": "system",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Step slug (e.g. 'microsoft-365-disable')"
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/sanityPatchTask"
-              }
-            }
-          },
-          "required": true
-        },
         "responses": {
           "200": {
-            "description": "Payload of SanityTask",
+            "description": "Uniform onboarding result with status + message",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanityTask"
+                  "$ref": "#/components/schemas/onboardingResult"
                 }
               }
             },
@@ -1438,14 +1396,16 @@
             ]
           }
         ]
-      },
-      "delete": {
+      }
+    },
+    "/v1.0/protected/candidates/{id}/offboard-full": {
+      "post": {
         "tags": [
-          "Tasks"
+          "Candidates"
         ],
-        "summary": "Delete a task",
-        "description": "Removes a task from the library. Does not touch candidate checklists that reference it.",
-        "operationId": "DeleteTask",
+        "summary": "Run the full automated offboarding chain",
+        "description": "Disables the candidate's Microsoft 365 user and triggers an Azure AD → Sanity sync so the employee doc reflects the disabled state.",
+        "operationId": "OffboardCandidateFull",
         "parameters": [
           {
             "name": "id",
@@ -1458,11 +1418,14 @@
         ],
         "responses": {
           "200": {
-            "description": "Payload of SanityTask",
+            "description": "Per-step results",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanityTask"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/onboardingResult"
+                  }
                 }
               }
             },
@@ -1486,13 +1449,14 @@
         ]
       }
     },
-    "/v1.0/protected/systems/{id}": {
-      "patch": {
+    "/v1.0/protected/candidates/{id}/offboard-full/stream": {
+      "post": {
         "tags": [
-          "Systems"
+          "Candidates"
         ],
-        "summary": "Update a system",
-        "operationId": "PatchSystem",
+        "summary": "Offboarding chain with a live SSE event feed",
+        "description": "Streams the offboarding chain step-by-step as Server-Sent Events. Mirrors /onboard-full/stream.",
+        "operationId": "OffboardCandidateFullStream",
         "parameters": [
           {
             "name": "id",
@@ -1503,23 +1467,56 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/sanityPatchSystem"
-              }
-            }
-          },
-          "required": true
+        "responses": {
+          "200": {
+            "description": "No description",
+            "x-ms-summary": "SSE stream of OnboardingResult frames"
+          }
         },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/candidates/{id}/onboard/{system}": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Trigger automated onboarding for a single chain step",
+        "description": "Re-runs one named onboarding step (slug matches the timeline step ids — e.g. 'microsoft-365', 'license-assignment', 'github-org-invite'). Used by the admin UI's per-step retry button when an earlier chain run partially failed.",
+        "operationId": "OnboardCandidateSystem",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          },
+          {
+            "name": "system",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "System slug (e.g. 'microsoft-365')"
+          }
+        ],
         "responses": {
           "200": {
-            "description": "Payload of SanitySystemsInner",
+            "description": "Uniform onboarding result with status + message",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanitySystemsInner"
+                  "$ref": "#/components/schemas/onboardingResult"
                 }
               }
             },
@@ -1552,13 +1549,16 @@
             ]
           }
         ]
-      },
-      "delete": {
+      }
+    },
+    "/v1.0/protected/candidates/{id}/onboard-full": {
+      "post": {
         "tags": [
-          "Systems"
+          "Candidates"
         ],
-        "summary": "Delete a system",
-        "operationId": "DeleteSystem",
+        "summary": "Run the full automated onboarding chain",
+        "description": "Provisions the candidate's Microsoft 365 user, then triggers an Azure AD → Sanity sync to create the matching employee doc. Returns one OnboardingResult row per step so the admin UI can render a live timeline.",
+        "operationId": "OnboardCandidateFull",
         "parameters": [
           {
             "name": "id",
@@ -1566,16 +1566,20 @@
             "required": true,
             "schema": {
               "type": "string"
-            }
+            },
+            "x-ms-summary": "Candidate Sanity id"
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of SanitySystemsInner",
+            "description": "Per-step results",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/sanitySystemsInner"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/onboardingResult"
+                  }
                 }
               }
             },
@@ -1599,32 +1603,28 @@
         ]
       }
     },
-    "/v1.0/protected/employees": {
-      "get": {
+    "/v1.0/protected/candidates/{id}/onboard-full/stream": {
+      "post": {
         "tags": [
-          "Employees"
+          "Candidates"
+        ],
+        "summary": "Run the onboarding chain with a live SSE event feed",
+        "description": "Same chain as /onboard-full but streams Server-Sent Events (`event: step`) as each step starts (`status:running`) and finishes (`succeeded`/`failed`). Closes with `event: done`. Frontend uses fetch streaming so we can pass a Bearer token; EventSource doesn't support custom headers.",
+        "operationId": "OnboardCandidateFullStream",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
         ],
-        "summary": "List employees for buddy/recruiter assignment",
-        "description": "Lightweight employee list used by the candidate detail page's buddy and recruiter dropdowns.",
-        "operationId": "ListRecruitmentEmployees",
         "responses": {
           "200": {
-            "description": "Payload of Array of SanityBasicEmployee",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/sanityBasicEmployee"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
             "description": "No description",
-            "x-ms-summary": "Unauthorized"
+            "x-ms-summary": "SSE stream of OnboardingResult frames"
           }
         },
         "security": [