@snokam/mcp-api 2.44.0 → 2.45.0

package/specs/test/sanity.json

@@ -3278,6 +3278,130 @@
         "type": "object",
         "additionalProperties": true
       },
+      "SanityTask": {
+        "properties": {
+          "sanityId": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string"
+          },
+          "sanityCreatedAt": {
+            "type": "string"
+          },
+          "sanityUpdatedAt": {
+            "type": "string"
+          },
+          "sanityRev": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "onboarding",
+              "offboarding"
+            ]
+          },
+          "description": {
+            "items": {},
+            "type": "array",
+            "nullable": true,
+            "description": "Portable Text notes/instructions attached to this task."
+          },
+          "reminderWeeksBefore": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "reminderSlackChannel": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "required": [
+          "sanityId",
+          "sanityType",
+          "sanityCreatedAt",
+          "sanityUpdatedAt",
+          "sanityRev",
+          "title",
+          "type",
+          "description",
+          "reminderWeeksBefore",
+          "reminderSlackChannel"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "SanityCreateTask": {
+        "description": "Shape used to create a new task. `description` is Portable Text — callers\nin the admin typically pass a simple single-block paragraph.",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "onboarding",
+              "offboarding"
+            ]
+          },
+          "description": {
+            "items": {},
+            "type": "array",
+            "nullable": true
+          },
+          "reminderWeeksBefore": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "reminderSlackChannel": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "required": [
+          "title",
+          "type"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "SanityPatchTask": {
+        "description": "Partial update. Any field omitted is left unchanged.",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "onboarding",
+              "offboarding"
+            ]
+          },
+          "description": {
+            "items": {},
+            "type": "array",
+            "nullable": true
+          },
+          "reminderWeeksBefore": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "reminderSlackChannel": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "type": "object",
+        "additionalProperties": true
+      },
       "SanityTag": {
         "properties": {
           "slug": {
@@ -3741,6 +3865,53 @@
         },
         "type": "array"
       },
+      "SanityCreateSystem": {
+        "description": "Shape used to create a new system. Links are plain URL strings;\ndescription is Portable Text (the schema stores it as a block array).",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "links": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "nullable": true
+          },
+          "description": {
+            "items": {},
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "required": [
+          "title"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "SanityPatchSystem": {
+        "description": "Partial update. Any omitted field is left unchanged.",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "links": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "nullable": true
+          },
+          "description": {
+            "items": {},
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "type": "object",
+        "additionalProperties": true
+      },
       "SubscriptionListItemRef": {
         "properties": {
           "sanityId": {
@@ -30455,8 +30626,8 @@
           "track": {
             "type": "string",
             "enum": [
-              "developer",
-              "data_engineer"
+              "data_engineer",
+              "developer"
             ]
           },
           "fromApplication": {
@@ -42815,6 +42986,266 @@
         ]
       }
     },
+    "/v1.0/tasks/by-type/{type}": {
+      "get": {
+        "operationId": "GetTasksByType",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": {
+                    "$ref": "#/components/schemas/SanityTask"
+                  },
+                  "type": "array"
+                }
+              }
+            }
+          }
+        },
+        "description": "Returns every task of the given type (onboarding or offboarding)\nwith its Portable Text description so the admin panel can render\nthe checklist with contextual notes.",
+        "tags": [
+          "Tasks"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "type",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "onboarding",
+                "offboarding"
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": true,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/tasks/{id}": {
+      "get": {
+        "operationId": "GetTaskById",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/SanityTask"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Fetch a single task by id.",
+        "tags": [
+          "Tasks"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": true,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        ]
+      },
+      "patch": {
+        "operationId": "PatchTask",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/SanityTask"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Patch a task. Any omitted field is left unchanged. Pass `null`\nto explicitly clear an optional field (e.g. drop a reminder).",
+        "tags": [
+          "Tasks"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchTask"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DeleteTask",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/SanityTask"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Delete a task. Returns the deleted document so callers can\nupdate their local cache before the next refetch.",
+        "tags": [
+          "Tasks"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/tasks": {
+      "post": {
+        "operationId": "CreateTask",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/SanityTask"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a new onboarding or offboarding task.",
+        "tags": [
+          "Tasks"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateTask"
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1.0/tags": {
       "get": {
         "operationId": "GetTags",
@@ -42965,6 +43396,43 @@
             }
           }
         ]
+      },
+      "post": {
+        "operationId": "CreateSystem",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanitySystems"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a new system.",
+        "tags": [
+          "Systems"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateSystem"
+              }
+            }
+          }
+        }
       }
     },
     "/v1.0/systems/{id}": {
@@ -43020,6 +43488,88 @@
             }
           }
         ]
+      },
+      "patch": {
+        "operationId": "PatchSystem",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanitySystems"
+                }
+              }
+            }
+          }
+        },
+        "description": "Patch a system. Any omitted field is left unchanged.",
+        "tags": [
+          "Systems"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchSystem"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DeleteSystem",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanitySystems"
+                }
+              }
+            }
+          }
+        },
+        "description": "Delete a system by id. Returns the deleted document so callers\ncan update their local cache before the next refetch.",
+        "tags": [
+          "Systems"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
       }
     },
     "/v1.0/subscriptions": {