@snokam/mcp-api 0.54.0 → 0.56.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/recruitment.json

@@ -1635,6 +1635,69 @@
           }
         ]
       }
+    },
+    "/v1.0/protected/candidates/{id}/issue-pin": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Generate or set a candidate PIN code and SMS it to them",
+        "description": "Issues the six-digit PIN that gates the candidate's tilbud-, signert- and onboarding-side. Pass an empty body to generate a fresh code; pass {\"pin\": \"123456\"} to override with a specific value (handy when the candidate calls in for help). Patches candidate.pin in Sanity and SMSes the code to candidate.telephone via notifications-function. Returns the updated candidate.",
+        "operationId": "IssueCandidatePin",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          }
+        ],
+        "requestBody": {
+          "description": "Optional override",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/issueCandidatePinRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of SanityCandidate",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/sanityCandidate"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "No description",
+            "x-ms-summary": "Invalid PIN value"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b9f9de6f-132f-4a9a-a583-e9054a46f2fa/.default"
+            ]
+          }
+        ]
+      }
     }
   },
   "components": {
@@ -1814,6 +1877,14 @@
           }
         }
       },
+      "issueCandidatePinRequest": {
+        "type": "object",
+        "properties": {
+          "pin": {
+            "type": "string"
+          }
+        }
+      },
       "jobPositionReference": {
         "type": "object",
         "properties": {
@@ -2081,6 +2152,9 @@
           "personalNumber": {
             "type": "string"
           },
+          "pin": {
+            "type": "string"
+          },
           "preferredDisplayName": {
             "type": "string"
           },
@@ -2711,6 +2785,9 @@
           "personalNumber": {
             "type": "string"
           },
+          "pin": {
+            "type": "string"
+          },
           "preferredDisplayName": {
             "type": "string"
           },

package/specs/production/sanity.json

@@ -31459,6 +31459,9 @@
             "type": "object",
             "nullable": true
           },
+          "pin": {
+            "type": "string"
+          },
           "personalNumber": {
             "type": "string"
           },
@@ -31747,6 +31750,10 @@
             "type": "string",
             "nullable": true
           },
+          "pin": {
+            "type": "string",
+            "nullable": true
+          },
           "contractSigner": {
             "allOf": [
               {