@snokam/mcp-api 0.27.0 → 0.29.0

package/specs/test/recruitment.json

@@ -451,8 +451,8 @@
         "tags": [
           "Candidates"
         ],
-        "summary": "Trigger automated onboarding for a given system",
-        "description": "Dispatches to the right onboarding handler based on the system slug. Microsoft 365 is the primary target; other systems report 'not implemented' until their handler lands.",
+        "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": [
           {
@@ -515,6 +515,75 @@
         ]
       }
     },
+    "/v1.0/protected/candidates/{id}/offboard/{system}": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "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",
+            "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": "Step slug (e.g. 'microsoft-365-disable')"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Uniform onboarding result with status + message",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/onboardingResult"
+                }
+              }
+            },
+            "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": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/candidates/{id}/onboard-full/stream": {
       "post": {
         "tags": [
@@ -1464,20 +1533,15 @@
             "type": "string",
             "default": "CREATED"
           },
-          "track": {
-            "enum": [
-              "developer",
-              "data_engineer"
-            ],
-            "type": "string",
-            "default": "developer"
-          },
           "candidate": {
             "type": "string"
           },
           "email": {
             "type": "string"
           },
+          "jobPositionId": {
+            "type": "string"
+          },
           "recruiter": {
             "type": "string"
           },
@@ -1510,6 +1574,24 @@
           }
         }
       },
+      "jobPositionReference": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "reference"
+            ],
+            "type": "string",
+            "default": "reference"
+          },
+          "sanityRef": {
+            "type": "string"
+          },
+          "sanityWeak": {
+            "type": "boolean"
+          }
+        }
+      },
       "onboardingResult": {
         "type": "object",
         "properties": {
@@ -1533,6 +1615,30 @@
           }
         }
       },
+      "pageMetaImage": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "image"
+            ],
+            "type": "string",
+            "default": "image"
+          },
+          "asset": {
+            "$ref": "#/components/schemas/sanityImageAssetReference"
+          },
+          "crop": {
+            "$ref": "#/components/schemas/sanityImageCrop"
+          },
+          "hotspot": {
+            "$ref": "#/components/schemas/sanityImageHotspot"
+          },
+          "media": {
+            "type": "object"
+          }
+        }
+      },
       "sanityAssetSourceData": {
         "type": "object",
         "properties": {
@@ -1614,14 +1720,6 @@
             "type": "string",
             "default": "CREATED"
           },
-          "track": {
-            "enum": [
-              "data_engineer",
-              "developer"
-            ],
-            "type": "string",
-            "default": "data_engineer"
-          },
           "address": {
             "$ref": "#/components/schemas/sanityCandidateAddress"
           },
@@ -1658,6 +1756,9 @@
           "grades": {
             "$ref": "#/components/schemas/sanityCandidateGrades"
           },
+          "jobPosition": {
+            "$ref": "#/components/schemas/sanityCandidateJobPosition"
+          },
           "offboardingChecklist": {
             "type": "array",
             "items": {
@@ -1707,6 +1808,9 @@
           "shortUrl": {
             "type": "string"
           },
+          "slipperSize": {
+            "type": "string"
+          },
           "startDate": {
             "type": "string"
           },
@@ -1756,6 +1860,54 @@
           }
         }
       },
+      "sanityCandidateJobPosition": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "jobPosition"
+            ],
+            "type": "string",
+            "default": "jobPosition"
+          },
+          "askForGrades": {
+            "type": "boolean"
+          },
+          "deadline": {
+            "type": "string"
+          },
+          "description": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/sanitySystemsInnerDescriptionInner"
+            }
+          },
+          "image": {
+            "$ref": "#/components/schemas/pageMetaImage"
+          },
+          "metaDescription": {
+            "type": "string"
+          },
+          "sanityCreatedAt": {
+            "type": "string"
+          },
+          "sanityId": {
+            "type": "string"
+          },
+          "sanityRev": {
+            "type": "string"
+          },
+          "sanityUpdatedAt": {
+            "type": "string"
+          },
+          "slug": {
+            "$ref": "#/components/schemas/slug"
+          },
+          "title": {
+            "type": "string"
+          }
+        }
+      },
       "sanityCandidateOffboardingChecklistInner": {
         "type": "object",
         "properties": {
@@ -2175,15 +2327,6 @@
             "default": "CREATED",
             "nullable": true
           },
-          "track": {
-            "enum": [
-              "developer",
-              "data_engineer"
-            ],
-            "type": "string",
-            "default": "developer",
-            "nullable": true
-          },
           "address": {
             "$ref": "#/components/schemas/sanityPatchCandidateAddress"
           },
@@ -2221,6 +2364,9 @@
           "grades": {
             "$ref": "#/components/schemas/sanityPatchCandidateApplicationLetter"
           },
+          "jobPosition": {
+            "$ref": "#/components/schemas/jobPositionReference"
+          },
           "offboardingChecklist": {
             "type": "array",
             "items": {
@@ -2259,6 +2405,9 @@
           "shortUrl": {
             "type": "string"
           },
+          "slipperSize": {
+            "type": "string"
+          },
           "startDate": {
             "type": "string"
           },