@snokam/mcp-api 1.21.1 → 2.0.0

package/specs/production/employees.json

@@ -42,12 +42,41 @@
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
+    "/v1.0/presentations": {
+      "get": {
+        "tags": [
+          "CV"
+        ],
+        "summary": "Gets all presentations held by consultants",
+        "description": "Aggregates the presentations listed across all consultant CVs in CvPartner, including the speaker for each presentation. Public endpoint used by the snokam.no/presentasjoner page.",
+        "operationId": "GetPresentations",
+        "responses": {
+          "200": {
+            "description": "List of presentations retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/consultantPresentation"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
     "/v1.0/cvs/my-cv": {
       "get": {
         "tags": [
@@ -80,363 +109,2217 @@
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/cvs/{email}": {
+    "/v1.0/cvs/{slug}": {
       "get": {
         "tags": [
           "CV"
         ],
-        "summary": "Gets CV data for a specific employee by email",
-        "description": "Retrieves CV data for a specific consultant from CvPartner by their email address.",
-        "operationId": "GetEmployeeCvByEmail",
+        "summary": "Gets CV data for a specific employee by slug",
+        "description": "Retrieves CV data for a specific consultant from CvPartner by their Sanity slug (e.g. 'hakon-grotte').",
+        "operationId": "GetEmployeeCvBySlug",
         "parameters": [
           {
-            "name": "email",
+            "name": "slug",
             "in": "path",
-            "description": "The email address of the consultant to retrieve CV data for",
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "The email address of the employee"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Consultant CV profile retrieved successfully",
+            "description": "Payload of ConsultantCv",
             "content": {
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/consultantCv"
                 }
               }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            }
           },
           "404": {
-            "description": "Employee not found in CvPartner",
-            "x-ms-summary": "Not Found"
+            "description": "No description"
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/protected": {
+    "/v1.0/me/cv/pdf": {
       "get": {
         "tags": [
-          "Protected"
+          "CV"
         ],
-        "summary": "Gets all protected employees",
-        "description": "Retrieves a list of all protected employees.",
-        "operationId": "GetEmployeesProtected",
+        "summary": "Downloads the authenticated user's CV as PDF",
+        "operationId": "GetMyCvPdf",
         "responses": {
           "200": {
-            "description": "List of protected employees retrieved successfully",
+            "description": "Payload of Array of Byte",
             "content": {
-              "application/json": {
+              "application/pdf": {
                 "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/protectedEmployee"
-                  }
+                  "type": "string",
+                  "format": "binary"
                 }
               }
-            },
-            "x-ms-summary": "Success"
+            }
           },
           "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            "description": "No description"
+          },
+          "404": {
+            "description": "No description"
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/protected/me": {
+    "/v1.0/cvs/{slug}/pdf": {
       "get": {
         "tags": [
-          "Protected"
+          "CV"
+        ],
+        "summary": "Downloads a specific consultant's CV as PDF by slug",
+        "operationId": "GetEmployeeCvPdfBySlug",
+        "parameters": [
+          {
+            "name": "slug",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
         ],
-        "summary": "Gets the authenticated user's protected employee data",
-        "description": "Retrieves the protected employee data for the authenticated user.",
-        "operationId": "GetMeProtected",
         "responses": {
           "200": {
-            "description": "Authenticated user's protected employee data retrieved successfully",
+            "description": "Payload of Array of Byte",
             "content": {
-              "application/json": {
+              "application/pdf": {
                 "schema": {
-                  "$ref": "#/components/schemas/protectedEmployee"
+                  "type": "string",
+                  "format": "binary"
                 }
               }
-            },
-            "x-ms-summary": "Success"
+            }
           },
           "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            "description": "No description"
           },
           "404": {
-            "description": "Employee not found",
-            "x-ms-summary": "Not Found"
+            "description": "No description"
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
-      },
-      "put": {
+      }
+    },
+    "/v1.0/proposals": {
+      "post": {
         "tags": [
-          "Protected"
+          "Proposals"
         ],
-        "summary": "Updates the authenticated user's protected employee data",
-        "description": "Updates the protected employee data for the authenticated user.",
-        "operationId": "PatchMeProtected",
+        "summary": "Create a Flowcase proposal",
+        "operationId": "CreateProposal",
         "requestBody": {
-          "description": "Employee data to update",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/patchEmployee"
+                "$ref": "#/components/schemas/createProposalRequest"
               }
             }
           },
           "required": true
         },
         "responses": {
-          "200": {
-            "description": "Authenticated user's protected employee data updated successfully",
+          "201": {
+            "description": "Payload of FlowcaseProposal",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/protectedEmployee"
+                  "$ref": "#/components/schemas/flowcaseProposal"
                 }
               }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            }
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
     },
-    "/v1.0/protected/{id}": {
+    "/v1.0/proposals/{proposalId}": {
       "get": {
         "tags": [
-          "Protected"
+          "Proposals"
         ],
-        "summary": "Gets a protected employee by ID",
-        "description": "Retrieves a protected employee by their ID.",
-        "operationId": "GetEmployeeProtected",
+        "summary": "Get a Flowcase proposal by id",
+        "operationId": "GetProposal",
         "parameters": [
           {
-            "name": "id",
+            "name": "proposalId",
             "in": "path",
-            "description": "The ID of the protected employee to retrieve",
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "The ID of the employee"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Protected employee retrieved successfully",
+            "description": "Payload of FlowcaseProposal",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/protectedEmployee"
+                  "$ref": "#/components/schemas/flowcaseProposal"
                 }
               }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            }
           },
           "404": {
-            "description": "Employee not found",
-            "x-ms-summary": "Not Found"
+            "description": "No description"
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
-      }
-    },
-    "/v1.0/protected/me/gadgetbudget": {
-      "get": {
+      },
+      "patch": {
         "tags": [
-          "Protected"
+          "Proposals"
         ],
-        "summary": "Gets the authenticated user's gadget budget",
-        "description": "Retrieves the gadget budget for the authenticated user.",
-        "operationId": "GetMyGadgetBudget",
+        "summary": "Update / patch a Flowcase proposal",
+        "operationId": "UpdateProposal",
+        "parameters": [
+          {
+            "name": "proposalId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/updateProposalRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Authenticated user's gadget budget retrieved successfully",
+            "description": "Payload of FlowcaseProposal",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/gadgetBudget"
+                  "$ref": "#/components/schemas/flowcaseProposal"
                 }
               }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "User is not authorized",
-            "x-ms-summary": "Unauthorized"
+            }
           }
         },
         "security": [
           {
             "Implicit": [
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
-      }
-    },
-    "/v1.0/public/{slugOrId}": {
-      "get": {
+      },
+      "delete": {
         "tags": [
-          "Public"
+          "Proposals"
         ],
-        "summary": "Gets a public employee by slug or id",
-        "description": "Retrieves a public employee by their slug or id.",
-        "operationId": "GetEmployeePublic",
+        "summary": "Archive a proposal — Flowcase has no hard-delete; we PUT archived=true.",
+        "operationId": "ArchiveProposal",
         "parameters": [
           {
-            "name": "slugOrId",
+            "name": "proposalId",
             "in": "path",
-            "description": "The slug or id of the public employee to retrieve",
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "x-ms-summary": "The slug or id of the employee"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Public employee retrieved successfully",
+            "description": "Payload of FlowcaseProposal",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/publicEmployee"
+                  "$ref": "#/components/schemas/flowcaseProposal"
                 }
               }
-            },
-            "x-ms-summary": "Success"
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
           },
-          "404": {
-            "description": "Employee not found",
-            "x-ms-summary": "Not Found"
+          {
+            "ApiKey": []
           }
-        }
+        ]
       }
     },
-    "/v1.0/public": {
-      "get": {
+    "/v1.0/proposals/{proposalId}/cvs": {
+      "post": {
         "tags": [
-          "Public"
+          "Proposals"
         ],
-        "summary": "Gets all public employees",
-        "description": "Retrieves a list of all public employees.",
-        "operationId": "GetEmployeesPublic",
-        "responses": {
-          "200": {
-            "description": "List of public employees retrieved successfully",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/publicEmployee"
-                  }
-                }
-              }
-            },
-            "x-ms-summary": "Success"
+        "summary": "Attach a consultant's CV to a proposal; Flowcase copies the default CV into an editable tailored CV.",
+        "operationId": "AttachCvToProposal",
+        "parameters": [
+          {
+            "name": "proposalId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
-        }
-      }
-    },
-    "/v1.0/feedback": {
-      "post": {
-        "tags": [
-          "Public"
         ],
-        "summary": "Submit anonymous feedback",
-        "description": "Allows anyone to send anonymous text feedback.",
-        "operationId": "PostAnonymousFeedback",
         "requestBody": {
-          "description": "Feedback payload",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/feedback"
+                "$ref": "#/components/schemas/addCvToProposalRequest"
               }
             }
           },
           "required": true
         },
         "responses": {
-          "200": {
-            "description": "Feedback received",
-            "x-ms-summary": "Success"
-          },
-          "400": {
-            "description": "Invalid input",
-            "x-ms-summary": "Bad Request"
+          "201": {
+            "description": "Payload of FlowcaseTailoredCv",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/flowcaseTailoredCv"
+                }
+              }
+            }
           }
-        }
-      }
-    }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/proposals/{proposalId}/cvs/{tailoredCvId}": {
+      "delete": {
+        "tags": [
+          "Proposals"
+        ],
+        "summary": "Remove a tailored CV from a proposal.",
+        "operationId": "DetachCvFromProposal",
+        "parameters": [
+          {
+            "name": "proposalId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "tailoredCvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/cvs/users/{userId}/{cvId}/pdf": {
+      "get": {
+        "tags": [
+          "Proposals"
+        ],
+        "summary": "Download any CV (including tailored CVs) as PDF by user_id + cv_id.",
+        "operationId": "DownloadTailoredCvPdf",
+        "parameters": [
+          {
+            "name": "userId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "cvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of Byte",
+            "content": {
+              "application/pdf": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/cvs/users/{userId}/{cvId}": {
+      "get": {
+        "tags": [
+          "Proposals"
+        ],
+        "summary": "Get any CV (including tailored CVs) as raw Flowcase JSON by user_id + cv_id.",
+        "operationId": "GetRawCv",
+        "parameters": [
+          {
+            "name": "userId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "cvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/cvs/users/{userId}/{cvId}/sections/{sectionType}/{sectionId}": {
+      "put": {
+        "tags": [
+          "CV"
+        ],
+        "summary": "Edit a single CV section (PUT /v3/cvs/{user}/{cv}/{section_type}/{section_id}).",
+        "operationId": "UpdateCvSection",
+        "parameters": [
+          {
+            "name": "userId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "cvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "sectionType",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "sectionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Section body — shape depends on section_type (see Flowcase CV API).",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/public/{slugOrId}/cv": {
+      "get": {
+        "tags": [
+          "Public"
+        ],
+        "summary": "Gets the full CV for a public employee by slug or id",
+        "description": "Resolves the employee by Sanity slug or id and returns the verbatim CvPartner (Flowcase) CV payload, including project experiences, recommendations and presentations.",
+        "operationId": "GetPublicEmployeeCv",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "description": "The slug or id of the public employee whose CV to retrieve",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the employee"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Raw CvPartner CV payload retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "404": {
+            "description": "Employee or CV not found",
+            "x-ms-summary": "Not Found"
+          }
+        }
+      }
+    },
+    "/v1.0/protected": {
+      "get": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Gets all protected employees",
+        "description": "Retrieves a list of all protected employees.",
+        "operationId": "GetEmployeesProtected",
+        "parameters": [
+          {
+            "name": "includeBots",
+            "in": "query",
+            "description": "Include AI / bot employees (Olaf et al.). Defaults to false.",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include bots"
+          },
+          {
+            "name": "includeExternals",
+            "in": "query",
+            "description": "Include external employees (contractors). Defaults to false.",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include externals"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of protected employees retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/protectedEmployee"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/me": {
+      "get": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Gets the authenticated user's protected employee data",
+        "description": "Retrieves the protected employee data for the authenticated user.",
+        "operationId": "GetMeProtected",
+        "responses": {
+          "200": {
+            "description": "Authenticated user's protected employee data retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "Employee not found",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Updates the authenticated user's protected employee data",
+        "description": "Updates the protected employee data for the authenticated user.",
+        "operationId": "PatchMeProtected",
+        "requestBody": {
+          "description": "Employee data to update",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/patchEmployee"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Authenticated user's protected employee data updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/me/photo": {
+      "post": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Uploads the authenticated user's profile photo",
+        "description": "Stores the photo and a blurred variant on the employee. Body is the raw image bytes.",
+        "operationId": "SetMyPhoto",
+        "requestBody": {
+          "description": "Raw image bytes",
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Photo updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/{id}": {
+      "put": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Updates protected employee data by id or email",
+        "description": "Updates protected employee data for a specified employee id or email.",
+        "operationId": "PatchEmployeeProtected",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Sanity id or employee email",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The employee id or email"
+          }
+        ],
+        "requestBody": {
+          "description": "Employee data to update",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/patchEmployee"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Protected employee data updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "get": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Gets a protected employee by ID",
+        "description": "Retrieves a protected employee by their ID.",
+        "operationId": "GetEmployeeProtected",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the protected employee to retrieve",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The ID of the employee"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Protected employee retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "Employee not found",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/{id}/photo": {
+      "post": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Uploads a profile photo for an employee (admin)",
+        "description": "Stores the photo and a blurred variant on the given employee. Body is the raw image bytes.",
+        "operationId": "SetEmployeePhoto",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The employee Sanity id"
+          }
+        ],
+        "requestBody": {
+          "description": "Raw image bytes",
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Photo updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/protectedEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/me/gadgetbudget": {
+      "get": {
+        "tags": [
+          "Protected"
+        ],
+        "summary": "Gets the authenticated user's gadget budget",
+        "description": "Retrieves the gadget budget for the authenticated user.",
+        "operationId": "GetMyGadgetBudget",
+        "responses": {
+          "200": {
+            "description": "Authenticated user's gadget budget retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/gadgetBudget"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "User is not authorized",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/public/{slugOrId}": {
+      "get": {
+        "tags": [
+          "Public"
+        ],
+        "summary": "Gets a public employee by slug or id",
+        "description": "Retrieves a public employee by their slug or id.",
+        "operationId": "GetEmployeePublic",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "description": "The slug or id of the public employee to retrieve",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the employee"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Public employee retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/publicEmployee"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "404": {
+            "description": "Employee not found",
+            "x-ms-summary": "Not Found"
+          }
+        }
+      }
+    },
+    "/v1.0/public": {
+      "get": {
+        "tags": [
+          "Public"
+        ],
+        "summary": "Gets all public employees",
+        "description": "Retrieves a list of all public employees.",
+        "operationId": "GetEmployeesPublic",
+        "responses": {
+          "200": {
+            "description": "List of public employees retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/publicEmployee"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/feedback": {
+      "post": {
+        "tags": [
+          "Public"
+        ],
+        "summary": "Submit anonymous feedback",
+        "description": "Allows anyone to send anonymous text feedback.",
+        "operationId": "PostAnonymousFeedback",
+        "requestBody": {
+          "description": "Feedback payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/feedback"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Feedback received",
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Invalid input",
+            "x-ms-summary": "Bad Request"
+          }
+        }
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}/groups/{groupId}": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Add the directory user to a security group",
+        "description": "Returns changed: false when the user already was a member.",
+        "operationId": "AddDirectoryUserToGroup",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "groupId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DirectoryOperationResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/directoryOperationResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Remove the directory user from a security group",
+        "description": "Returns changed: false when the user was not a member.",
+        "operationId": "RemoveDirectoryUserFromGroup",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "groupId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DirectoryOperationResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/directoryOperationResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}/app-roles": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Assign an app-role on a service principal to the directory user",
+        "description": "Returns changed: false when the assignment already existed.",
+        "operationId": "AssignDirectoryAppRole",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/appRoleAssignmentRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of DirectoryOperationResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/directoryOperationResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "get": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Map the directory user's app-role assignments by service principal",
+        "description": "Returns { servicePrincipalObjectId: appRoleId } for every Enterprise App the user is assigned to.",
+        "operationId": "ListDirectoryUserAppRoles",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Dictionary of String",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}/app-roles/{servicePrincipalObjectId}": {
+      "delete": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Remove the directory user's app-role assignment(s) on a service principal",
+        "operationId": "RemoveDirectoryAppRole",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "servicePrincipalObjectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DirectoryOperationResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/directoryOperationResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/service-principals/{servicePrincipalObjectId}/app-roles": {
+      "get": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "List a service principal's enabled app-roles",
+        "operationId": "ListDirectoryAppRoles",
+        "parameters": [
+          {
+            "name": "servicePrincipalObjectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SystemRoleOption",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/systemRoleOption"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}/licenses/{skuId}": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Assign a license SKU to the directory user",
+        "operationId": "AssignDirectoryLicense",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "skuId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No description",
+            "x-ms-summary": "Assigned"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Revoke a license SKU from the directory user",
+        "operationId": "RevokeDirectoryLicense",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "skuId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No description",
+            "x-ms-summary": "Revoked"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/licenses/{skuId}": {
+      "get": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Get seat availability for a license SKU",
+        "operationId": "GetDirectoryLicenseAvailability",
+        "parameters": [
+          {
+            "name": "skuId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of LicenseAvailability",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/licenseAvailability"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "SKU unknown"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/licenses/primary": {
+      "get": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Auto-select the tenant's primary productivity license SKU",
+        "description": "Returns skuId: null when no productivity SKU has a free seat.",
+        "operationId": "ResolvePrimaryDirectoryLicense",
+        "responses": {
+          "200": {
+            "description": "Payload of LicenseSkuRef",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/licenseSkuRef"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/systems/batch": {
+      "post": {
+        "tags": [
+          "EmployeeSystems"
+        ],
+        "summary": "Bulk list per-employee system access for a set of UPNs",
+        "description": "Resolves every UPN's third-party system seats in one roundtrip — fans out the Graph calls server-side.",
+        "operationId": "ListEmployeeSystemAccessBatch",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/listEmployeeSystemAccessBatchRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of Array of EmployeeSystemAccessRow",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/employeeSystemAccessRow"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/systems-config": {
+      "get": {
+        "tags": [
+          "EmployeeSystems"
+        ],
+        "summary": "List the system registry with per-tenant configuration",
+        "description": "Which Enterprise App (service principal) backs each registered system, and the optional default role. Unconfigured systems have servicePrincipalId: null.",
+        "operationId": "GetEmployeeSystemsConfig",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of EmployeeSystemConfig",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/employeeSystemConfig"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/systems/{upn}": {
+      "get": {
+        "tags": [
+          "EmployeeSystems"
+        ],
+        "summary": "List an employee's third-party system access",
+        "description": "Per registered system (e.g. Salesforce): whether the employee has a seat, which app-role backs it, and the selectable roles.",
+        "operationId": "ListEmployeeSystemAccess",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Employee UPN (work email)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of EmployeeSystemAccess",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/employeeSystemAccess"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Employee not found in the directory"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/systems/{upn}/{systemKey}": {
+      "post": {
+        "tags": [
+          "EmployeeSystems"
+        ],
+        "summary": "Grant the employee a seat in a third-party system",
+        "description": "Assigns the backing app-role on the system's Enterprise App. SCIM/provisioning then creates the account automatically.",
+        "operationId": "AssignEmployeeSystem",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "systemKey",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Stable system key (e.g. \"salesforce\")"
+          },
+          {
+            "name": "roleId",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "App-role id to assign; falls back to the tenant's default role when omitted. Assigning a different role than the current one replaces the assignment."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of EmployeeSystemAccess",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/employeeSystemAccess"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Unknown system or employee"
+          },
+          "501": {
+            "description": "No description",
+            "x-ms-summary": "System not configured in this environment"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "EmployeeSystems"
+        ],
+        "summary": "Revoke the employee's seat in a third-party system",
+        "description": "Removes the backing app-role assignment. SCIM/provisioning deactivates the account on the next sync.",
+        "operationId": "RevokeEmployeeSystem",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "systemKey",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of EmployeeSystemAccess",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/employeeSystemAccess"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Unknown system or employee"
+          },
+          "501": {
+            "description": "No description",
+            "x-ms-summary": "System not configured in this environment"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Create (or adopt) a directory user",
+        "description": "Creates the Entra user, or patches an existing one with the supplied fields. Returns the temporary password only on fresh creation.",
+        "operationId": "CreateDirectoryUser",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/createUserInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of CreateUserResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/createUserResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}": {
+      "patch": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Patch a directory user from candidate fields",
+        "operationId": "PatchDirectoryUser",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/createUserInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No description",
+            "x-ms-summary": "Patched"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{objectId}/photo": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Upload a profile photo to the directory user",
+        "description": "Fetches the image from the supplied URL and PUTs it as the user's Entra profile photo.",
+        "operationId": "UploadDirectoryUserPhoto",
+        "parameters": [
+          {
+            "name": "objectId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/uploadPhotoRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of UploadPhotoResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/uploadPhotoResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/by-upn/{upn}": {
+      "get": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Resolve a UPN to the directory user's object id",
+        "description": "Returns userObjectId: null when no directory user exists for the UPN.",
+        "operationId": "GetDirectoryUserByUpn",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DirectoryUserRef",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/directoryUserRef"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{upn}/disable": {
+      "post": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Disable the directory user (offboarding)",
+        "operationId": "DisableDirectoryUser",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DisableUserResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/disableUserResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/directory/users/{upn}": {
+      "delete": {
+        "tags": [
+          "Directory"
+        ],
+        "summary": "Delete the directory user (recoverable in Entra for 30 days)",
+        "operationId": "DeleteDirectoryUser",
+        "parameters": [
+          {
+            "name": "upn",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of DisableUserResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/disableUserResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    }
   },
   "components": {
     "schemas": {
+      "addCvToProposalRequest": {
+        "type": "object",
+        "properties": {
+          "user_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "cv_id": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "appRoleAssignmentRequest": {
+        "type": "object",
+        "properties": {
+          "servicePrincipalObjectId": {
+            "type": "string"
+          },
+          "appRoleId": {
+            "type": "string"
+          }
+        }
+      },
       "commissionTierReference": {
         "type": "object",
         "properties": {
@@ -455,133 +2338,630 @@
           }
         }
       },
-      "componentBlocksInnerOneOfChildrenInner": {
+      "componentBlocksInnerOneOfChildrenInner": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "span"
+            ],
+            "type": "string",
+            "default": "span"
+          },
+          "marks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "sanityKey": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          }
+        }
+      },
+      "componentBlocksInnerOneOfMarkDefsInner": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "link"
+            ],
+            "type": "string",
+            "default": "link"
+          },
+          "href": {
+            "type": "string"
+          },
+          "sanityKey": {
+            "type": "string"
+          }
+        }
+      },
+      "componentGalleryMediaInner": {
+        "type": "object",
+        "properties": {
+          "actualInstance": {
+            "type": "object"
+          },
+          "isNullable": {
+            "type": "boolean"
+          },
+          "schemaType": {
+            "type": "string"
+          }
+        }
+      },
+      "consultantCv": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "nullable": true
+          },
+          "email": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "defaultCvId": {
+            "type": "string",
+            "nullable": true
+          },
+          "technologies": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "roles": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "yearsExperience": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "about": {
+            "type": "string",
+            "nullable": true
+          },
+          "cvText": {
+            "type": "string",
+            "nullable": true
+          },
+          "projectExperiences": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/consultantProjectExperience"
+            },
+            "nullable": true
+          },
+          "workExperiences": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/consultantWorkExperience"
+            },
+            "nullable": true
+          },
+          "educations": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/consultantEducation"
+            },
+            "nullable": true
+          },
+          "cvRoles": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/consultantCvRole"
+            },
+            "nullable": true
+          },
+          "keyQualifications": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/consultantKeyQualification"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "consultantCvRole": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "longDescription": {
+            "type": "string",
+            "nullable": true
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "consultantEducation": {
+        "type": "object",
+        "properties": {
+          "school": {
+            "type": "string",
+            "nullable": true
+          },
+          "degree": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "yearFrom": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "yearTo": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          }
+        }
+      },
+      "consultantKeyQualification": {
+        "type": "object",
+        "properties": {
+          "label": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "consultantPresentation": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "longDescription": {
+            "type": "string",
+            "nullable": true
+          },
+          "year": {
+            "type": "string",
+            "nullable": true
+          },
+          "month": {
+            "type": "string",
+            "nullable": true
+          },
+          "speaker": {
+            "$ref": "#/components/schemas/presentationSpeaker"
+          }
+        }
+      },
+      "consultantProjectExperience": {
+        "type": "object",
+        "properties": {
+          "customer": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "longDescription": {
+            "type": "string",
+            "nullable": true
+          },
+          "industry": {
+            "type": "string",
+            "nullable": true
+          },
+          "yearFrom": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "monthFrom": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "yearTo": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "monthTo": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "roleTitle": {
+            "type": "string",
+            "nullable": true
+          },
+          "roleDescription": {
+            "type": "string",
+            "nullable": true
+          },
+          "technologies": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "consultantWorkExperience": {
+        "type": "object",
+        "properties": {
+          "employer": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "yearFrom": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "monthFrom": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "yearTo": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "monthTo": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          }
+        }
+      },
+      "createProposalRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "owner_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "createUserInput": {
+        "type": "object",
+        "properties": {
+          "userPrincipalName": {
+            "type": "string"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "givenName": {
+            "type": "string"
+          },
+          "surname": {
+            "type": "string"
+          },
+          "jobTitle": {
+            "type": "string"
+          },
+          "mobilePhone": {
+            "type": "string"
+          },
+          "streetAddress": {
+            "type": "string"
+          },
+          "city": {
+            "type": "string"
+          },
+          "postalCode": {
+            "type": "string"
+          },
+          "country": {
+            "type": "string"
+          },
+          "sanityId": {
+            "type": "string"
+          }
+        }
+      },
+      "createUserResult": {
+        "type": "object",
+        "properties": {
+          "alreadyExisted": {
+            "type": "boolean"
+          },
+          "userObjectId": {
+            "type": "string"
+          },
+          "userPrincipalName": {
+            "type": "string"
+          },
+          "temporaryPassword": {
+            "type": "string"
+          }
+        }
+      },
+      "directoryOperationResult": {
+        "type": "object",
+        "properties": {
+          "changed": {
+            "type": "boolean"
+          }
+        }
+      },
+      "directoryUserRef": {
+        "type": "object",
+        "properties": {
+          "userObjectId": {
+            "type": "string"
+          }
+        }
+      },
+      "disableUserResult": {
+        "type": "object",
+        "properties": {
+          "found": {
+            "type": "boolean"
+          },
+          "wasAlreadyDisabled": {
+            "type": "boolean"
+          },
+          "userObjectId": {
+            "type": "string"
+          },
+          "userPrincipalName": {
+            "type": "string"
+          }
+        }
+      },
+      "employeeReference": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "reference"
+            ],
+            "type": "string",
+            "default": "reference"
+          },
+          "sanityRef": {
+            "type": "string"
+          },
+          "sanityWeak": {
+            "type": "boolean"
+          }
+        }
+      },
+      "employeeSystemAccess": {
         "type": "object",
         "properties": {
-          "sanityType": {
-            "enum": [
-              "span"
-            ],
-            "type": "string",
-            "default": "span"
+          "key": {
+            "type": "string"
           },
-          "marks": {
+          "label": {
+            "type": "string"
+          },
+          "assigned": {
+            "type": "boolean"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "notImplemented": {
+            "type": "boolean"
+          },
+          "assignedRoleId": {
+            "type": "string"
+          },
+          "availableRoles": {
             "type": "array",
             "items": {
-              "type": "string"
+              "$ref": "#/components/schemas/systemRoleOption"
             }
           },
-          "sanityKey": {
+          "manageable": {
+            "type": "boolean"
+          },
+          "inheritedVia": {
             "type": "string"
           },
-          "text": {
+          "provisioningStatus": {
+            "type": "string"
+          },
+          "provisioningError": {
             "type": "string"
           }
         }
       },
-      "componentBlocksInnerOneOfMarkDefsInner": {
+      "employeeSystemAccessRow": {
         "type": "object",
         "properties": {
-          "sanityType": {
-            "enum": [
-              "link"
-            ],
-            "type": "string",
-            "default": "link"
-          },
-          "href": {
+          "upn": {
             "type": "string"
           },
-          "sanityKey": {
-            "type": "string"
+          "systems": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/employeeSystemAccess"
+            }
           }
         }
       },
-      "componentGalleryMediaInner": {
+      "employeeSystemConfig": {
         "type": "object",
         "properties": {
-          "actualInstance": {
-            "type": "object"
+          "key": {
+            "type": "string"
           },
-          "isNullable": {
-            "type": "boolean"
+          "label": {
+            "type": "string"
           },
-          "schemaType": {
+          "kind": {
+            "type": "string"
+          },
+          "servicePrincipalId": {
+            "type": "string"
+          },
+          "defaultRoleId": {
             "type": "string"
           }
         }
       },
-      "consultantCv": {
+      "feedback": {
         "type": "object",
         "properties": {
-          "userId": {
+          "message": {
+            "type": "string"
+          }
+        }
+      },
+      "flowcaseProposal": {
+        "type": "object",
+        "properties": {
+          "id": {
             "type": "string",
             "nullable": true
           },
-          "email": {
+          "name": {
             "type": "string",
             "nullable": true
           },
-          "name": {
+          "api_owner_id": {
             "type": "string",
             "nullable": true
           },
-          "defaultCvId": {
+          "api_owner_name": {
             "type": "string",
             "nullable": true
           },
-          "technologies": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
+          "owner_id": {
+            "type": "string",
             "nullable": true
           },
-          "roles": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
+          "owner_name": {
+            "type": "string",
             "nullable": true
           },
-          "yearsExperience": {
-            "type": "integer",
-            "format": "int32",
+          "status": {
+            "type": "string",
             "nullable": true
           },
-          "about": {
+          "archived": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "created_at": {
             "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "cvText": {
+          "updated_at": {
             "type": "string",
+            "format": "date-time",
             "nullable": true
           }
         }
       },
-      "employeeReference": {
+      "flowcaseTailoredCv": {
         "type": "object",
         "properties": {
-          "sanityType": {
-            "enum": [
-              "reference"
-            ],
+          "id": {
             "type": "string",
-            "default": "reference"
+            "nullable": true
           },
-          "sanityRef": {
-            "type": "string"
+          "user_id": {
+            "type": "string",
+            "nullable": true
           },
-          "sanityWeak": {
-            "type": "boolean"
-          }
-        }
-      },
-      "feedback": {
-        "type": "object",
-        "properties": {
-          "message": {
-            "type": "string"
+          "proposal_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "email": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "nullable": true
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
           }
         }
       },
@@ -618,27 +2998,72 @@
           }
         }
       },
-      "geopoint": {
+      "geopoint": {
+        "type": "object",
+        "properties": {
+          "sanityType": {
+            "enum": [
+              "geopoint"
+            ],
+            "type": "string",
+            "default": "geopoint"
+          },
+          "alt": {
+            "type": "number",
+            "format": "double"
+          },
+          "lat": {
+            "type": "number",
+            "format": "double"
+          },
+          "lng": {
+            "type": "number",
+            "format": "double"
+          }
+        }
+      },
+      "licenseAvailability": {
+        "type": "object",
+        "properties": {
+          "skuId": {
+            "type": "string"
+          },
+          "skuPartNumber": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "consumed": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "available": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "isConfigured": {
+            "type": "boolean"
+          }
+        }
+      },
+      "licenseSkuRef": {
+        "type": "object",
+        "properties": {
+          "skuId": {
+            "type": "string"
+          }
+        }
+      },
+      "listEmployeeSystemAccessBatchRequest": {
         "type": "object",
         "properties": {
-          "sanityType": {
-            "enum": [
-              "geopoint"
-            ],
-            "type": "string",
-            "default": "geopoint"
-          },
-          "alt": {
-            "type": "number",
-            "format": "double"
-          },
-          "lat": {
-            "type": "number",
-            "format": "double"
-          },
-          "lng": {
-            "type": "number",
-            "format": "double"
+          "upns": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         }
       },
@@ -707,6 +3132,15 @@
             "default": "single",
             "nullable": true
           },
+          "parentalLeaveCoverage": {
+            "enum": [
+              "80",
+              "100"
+            ],
+            "type": "string",
+            "default": "80",
+            "nullable": true
+          },
           "sanityType": {
             "enum": [
               "employee"
@@ -765,6 +3199,12 @@
               "$ref": "#/components/schemas/pageEquipmentInner"
             }
           },
+          "externalId": {
+            "type": "string"
+          },
+          "github": {
+            "type": "string"
+          },
           "graduationYear": {
             "type": "number",
             "format": "double",
@@ -788,6 +3228,25 @@
             "format": "double",
             "nullable": true
           },
+          "isBot": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isExternal": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isPublic": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isSeekingProject": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "linkedin": {
+            "type": "string"
+          },
           "manager": {
             "$ref": "#/components/schemas/employeeReference"
           },
@@ -811,9 +3270,21 @@
             "format": "double",
             "nullable": true
           },
+          "parentalLeaveStartDate": {
+            "type": "string"
+          },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },
+          "salaryConfig": {
+            "$ref": "#/components/schemas/pickSanityPatchEmployeeExcludeKeyofSanityPatchEmployeeScopeGrantsSalaryConfig"
+          },
+          "settings": {
+            "$ref": "#/components/schemas/pickSanityPatchEmployeeExcludeKeyofSanityPatchEmployeeScopeGrantsSettings"
+          },
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
@@ -843,6 +3314,53 @@
           }
         }
       },
+      "pickSanityPatchEmployeeExcludeKeyofSanityPatchEmployeeScopeGrantsSalaryConfig": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "enum": [
+              "snokam.ceo",
+              "snokam.employee"
+            ],
+            "type": "string",
+            "default": "snokam.ceo",
+            "nullable": true
+          }
+        }
+      },
+      "pickSanityPatchEmployeeExcludeKeyofSanityPatchEmployeeScopeGrantsSettings": {
+        "type": "object",
+        "properties": {
+          "colorScheme": {
+            "enum": [
+              "dark",
+              "light",
+              "system"
+            ],
+            "type": "string",
+            "default": "dark",
+            "nullable": true
+          }
+        }
+      },
+      "presentationSpeaker": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "email": {
+            "type": "string",
+            "nullable": true
+          },
+          "flowcaseUserId": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "protectedEmployee": {
         "type": "object",
         "properties": {
@@ -869,6 +3387,15 @@
             "default": "cohabitant",
             "nullable": true
           },
+          "parentalLeaveCoverage": {
+            "enum": [
+              "80",
+              "100"
+            ],
+            "type": "string",
+            "default": "80",
+            "nullable": true
+          },
           "sanityType": {
             "enum": [
               "employee"
@@ -895,7 +3422,7 @@
             "type": "string"
           },
           "blurred_image": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImage"
           },
           "boardMember": {
             "type": "boolean"
@@ -924,6 +3451,12 @@
               "$ref": "#/components/schemas/sanityEmployeeEquipmentInner"
             }
           },
+          "externalId": {
+            "type": "string"
+          },
+          "github": {
+            "type": "string"
+          },
           "graduationYear": {
             "type": "number",
             "format": "double"
@@ -935,7 +3468,7 @@
             }
           },
           "image": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImage"
           },
           "innovativeSalary": {
             "type": "boolean"
@@ -944,13 +3477,28 @@
             "type": "number",
             "format": "double"
           },
+          "isBot": {
+            "type": "boolean"
+          },
+          "isExternal": {
+            "type": "boolean"
+          },
+          "isPublic": {
+            "type": "boolean"
+          },
+          "isSeekingProject": {
+            "type": "boolean"
+          },
+          "linkedin": {
+            "type": "string"
+          },
           "manager": {
             "$ref": "#/components/schemas/sanityEmployeeManager"
           },
           "media": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerContentInnerOneOf4MediaInner"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsDescriptionInnerOneOf4MediaInner"
             }
           },
           "name": {
@@ -966,9 +3514,18 @@
             "type": "number",
             "format": "double"
           },
+          "parentalLeaveStartDate": {
+            "type": "string"
+          },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },
+          "salaryConfig": {
+            "$ref": "#/components/schemas/sanityEmployeeSalaryConfig"
+          },
           "sanityCreatedAt": {
             "type": "string"
           },
@@ -981,6 +3538,15 @@
           "sanityUpdatedAt": {
             "type": "string"
           },
+          "scopeGrants": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "settings": {
+            "$ref": "#/components/schemas/sanityEmployeeSettings"
+          },
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
@@ -990,7 +3556,7 @@
           "tags": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTechnologiesInnerParent"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsEmployeesInnerTagsInner"
             }
           },
           "technologies": {
@@ -1017,6 +3583,10 @@
             "type": "boolean",
             "nullable": true
           },
+          "isPublic": {
+            "type": "boolean",
+            "nullable": true
+          },
           "image": {
             "$ref": "#/components/schemas/sanityImage"
           },
@@ -1038,7 +3608,7 @@
           "media": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerContentInnerOneOf4MediaInner"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsDescriptionInnerOneOf4MediaInner"
             }
           },
           "name": {
@@ -1065,6 +3635,12 @@
           "about": {
             "type": "string"
           },
+          "linkedin": {
+            "type": "string"
+          },
+          "github": {
+            "type": "string"
+          },
           "birthDate": {
             "type": "string",
             "format": "date-time",
@@ -1271,7 +3847,7 @@
           "images": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsArticlesInnerMediaOneOf"
             }
           },
           "sanityId": {
@@ -1299,7 +3875,7 @@
             }
           },
           "image": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+            "$ref": "#/components/schemas/sanityTechnologyWithRelationsArticlesInnerMediaOneOf"
           },
           "leaders": {
             "type": "array",
@@ -1310,6 +3886,9 @@
           "name": {
             "type": "string"
           },
+          "permissions": {
+            "type": "string"
+          },
           "sanityCreatedAt": {
             "type": "string"
           },
@@ -1321,6 +3900,12 @@
           },
           "sanityUpdatedAt": {
             "type": "string"
+          },
+          "scopeGrants": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         }
       },
@@ -1338,7 +3923,15 @@
             "type": "string"
           },
           "image": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImage"
+          },
+          "isBot": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isExternal": {
+            "type": "boolean",
+            "nullable": true
           },
           "name": {
             "type": "string"
@@ -1352,7 +3945,7 @@
           "tags": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTechnologiesInnerParent"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsEmployeesInnerTagsInner"
             }
           },
           "telephone": {
@@ -1381,6 +3974,35 @@
           }
         }
       },
+      "sanityEmployeeSalaryConfig": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "enum": [
+              "snokam.ceo",
+              "snokam.employee"
+            ],
+            "type": "string",
+            "default": "snokam.ceo",
+            "nullable": true
+          }
+        }
+      },
+      "sanityEmployeeSettings": {
+        "type": "object",
+        "properties": {
+          "colorScheme": {
+            "enum": [
+              "dark",
+              "light",
+              "system"
+            ],
+            "type": "string",
+            "default": "dark",
+            "nullable": true
+          }
+        }
+      },
       "sanityGadgetBudgetYearlyBudgetsInner": {
         "type": "object",
         "properties": {
@@ -1733,7 +4355,15 @@
             "type": "string"
           },
           "image": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo"
+            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImage"
+          },
+          "isBot": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isExternal": {
+            "type": "boolean",
+            "nullable": true
           },
           "name": {
             "type": "string"
@@ -1747,7 +4377,7 @@
           "tags": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTechnologiesInnerParent"
+              "$ref": "#/components/schemas/sanityTechnologyWithRelationsEmployeesInnerTagsInner"
             }
           },
           "telephone": {
@@ -1834,31 +4464,36 @@
           }
         }
       },
-      "sanityTechnologyWithRelationsProjectsInnerTechnologiesInner": {
+      "sanityTechnologyWithRelationsArticlesInnerMediaOneOf": {
         "type": "object",
         "properties": {
           "sanityType": {
             "enum": [
-              "technology"
+              "image"
             ],
             "type": "string",
-            "default": "technology"
-          },
-          "parent": {
-            "$ref": "#/components/schemas/sanityTechnologyWithRelationsProjectsInnerTechnologiesInnerParent"
+            "default": "image"
           },
-          "sanityId": {
-            "type": "string"
+          "asset": {
+            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImageAsset"
+          }
+        }
+      },
+      "sanityTechnologyWithRelationsDescriptionInnerOneOf4MediaInner": {
+        "type": "object",
+        "properties": {
+          "actualInstance": {
+            "type": "object"
           },
-          "slug": {
-            "$ref": "#/components/schemas/slug"
+          "isNullable": {
+            "type": "boolean"
           },
-          "title": {
+          "schemaType": {
             "type": "string"
           }
         }
       },
-      "sanityTechnologyWithRelationsProjectsInnerTechnologiesInnerParent": {
+      "sanityTechnologyWithRelationsEmployeesInnerTagsInner": {
         "type": "object",
         "properties": {
           "sanityType": {
@@ -1879,32 +4514,27 @@
           }
         }
       },
-      "sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerContentInnerOneOf4MediaInner": {
-        "type": "object",
-        "properties": {
-          "actualInstance": {
-            "type": "object"
-          },
-          "isNullable": {
-            "type": "boolean"
-          },
-          "schemaType": {
-            "type": "string"
-          }
-        }
-      },
-      "sanityTechnologyWithRelationsProjectsInnerTestimonialsInnerCustomerLogo": {
+      "sanityTechnologyWithRelationsProjectsInnerTechnologiesInner": {
         "type": "object",
         "properties": {
           "sanityType": {
             "enum": [
-              "image"
+              "technology"
             ],
             "type": "string",
-            "default": "image"
+            "default": "technology"
           },
-          "asset": {
-            "$ref": "#/components/schemas/sanityTvCategoryDashboardsInnerBackgroundImageAsset"
+          "parent": {
+            "$ref": "#/components/schemas/sanityTechnologyWithRelationsEmployeesInnerTagsInner"
+          },
+          "sanityId": {
+            "type": "string"
+          },
+          "slug": {
+            "$ref": "#/components/schemas/slug"
+          },
+          "title": {
+            "type": "string"
           }
         }
       },
@@ -1965,6 +4595,17 @@
           }
         }
       },
+      "systemRoleOption": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        }
+      },
       "tag": {
         "type": "object",
         "properties": {
@@ -2001,6 +4642,40 @@
             "$ref": "#/components/schemas/tag"
           }
         }
+      },
+      "updateProposalRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "archived": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "uploadPhotoRequest": {
+        "type": "object",
+        "properties": {
+          "imageUrl": {
+            "type": "string"
+          }
+        }
+      },
+      "uploadPhotoResult": {
+        "type": "object",
+        "properties": {
+          "bytes": {
+            "type": "integer",
+            "format": "int64"
+          }
+        }
       }
     },
     "securitySchemes": {
@@ -2008,14 +4683,19 @@
         "type": "oauth2",
         "flows": {
           "implicit": {
-            "authorizationUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/oauth2/v2.0/authorize",
-            "tokenUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/oauth2/v2.0/token",
-            "refreshUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/oauth2/v2.0/token",
+            "authorizationUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize",
+            "tokenUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/token",
+            "refreshUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/token",
             "scopes": {
-              "api://1c7354b7-6006-4c53-9ba4-c277b2ba31bb/.default": "Default function scope"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default": "Default function scope"
             }
           }
         }
+      },
+      "ApiKey": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT"
       }
     }
   }