initiative-plugin-sdk 7.2.0 → 8.1.0

package/schemas/plugin-api.json

@@ -2,10 +2,10 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Initiative plug-in API",
-    "version": "7.2.0",
+    "version": "8.1.0",
     "x-initiative-source": {
-      "version": "0.75.3",
-      "commit": "b7992004243ed01bf3e971481b11561e1fb7ab58"
+      "version": "0.76.0",
+      "commit": "4aa7e82158a2d07a8b19690e6c7a99c7159600ac"
     }
   },
   "servers": [
@@ -2812,6 +2812,145 @@
         ]
       }
     },
+    "/projects/{project_id}/task-types/": {
+      "get": {
+        "tags": [
+          "task-types",
+          "task-types"
+        ],
+        "summary": "List Task Types",
+        "operationId": "list_task_types",
+        "security": [
+          {
+            "PluginToken": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/TaskTypeRead"
+                  },
+                  "title": "Response List Task Types"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        },
+        "x-plugin-scope": "projects:read",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "title": "Project Id"
+            }
+          },
+          {
+            "name": "session_token",
+            "in": "cookie",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Session Token"
+            }
+          }
+        ]
+      }
+    },
+    "/projects/{project_id}/task-types/gallery": {
+      "get": {
+        "tags": [
+          "task-types",
+          "task-types"
+        ],
+        "summary": "List Task Type Gallery",
+        "description": "The ready-made types the project can add, grouped by what they are for,\nin the reader's language.",
+        "operationId": "list_task_type_gallery",
+        "security": [
+          {
+            "PluginToken": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/TaskTypeGalleryGroup"
+                  },
+                  "title": "Response List Task Type Gallery"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        },
+        "x-plugin-scope": "projects:read",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "title": "Project Id"
+            }
+          },
+          {
+            "name": "session_token",
+            "in": "cookie",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Session Token"
+            }
+          }
+        ]
+      }
+    },
     "/tasks/": {
       "get": {
         "tags": [
@@ -3022,6 +3161,214 @@
         ]
       }
     },
+    "/tasks/groups": {
+      "get": {
+        "tags": [
+          "tasks"
+        ],
+        "summary": "List Task Groups",
+        "description": "The groups of the task list these filters answer with, in the order the\nlist shows them, and the groups each task is in.",
+        "operationId": "list_task_groups",
+        "security": [
+          {
+            "PluginToken": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GroupsResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        },
+        "x-plugin-scope": "projects:read",
+        "parameters": [
+          {
+            "name": "group_by",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "maxLength": 64,
+              "description": "The field the list is grouped by, as the field catalog's ``groupings`` name it, or ``property:<id>``",
+              "title": "Group By"
+            },
+            "description": "The field the list is grouped by, as the field catalog's ``groupings`` name it, or ``property:<id>``"
+          },
+          {
+            "name": "bucket",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "$ref": "#/components/schemas/DateBucket"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "For a date: the bucket of the calendar it groups by",
+              "title": "Bucket"
+            },
+            "description": "For a date: the bucket of the calendar it groups by"
+          },
+          {
+            "name": "conditions",
+            "in": "query",
+            "required": false,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/components/schemas/FilterCondition"
+                      },
+                      {
+                        "$ref": "#/components/schemas/FilterGroup"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          {
+            "name": "include_archived",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Include Archived"
+            }
+          },
+          {
+            "name": "tz",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Tz"
+            }
+          },
+          {
+            "name": "session_token",
+            "in": "cookie",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Session Token"
+            }
+          }
+        ]
+      }
+    },
+    "/tasks/column-limits": {
+      "get": {
+        "tags": [
+          "tasks"
+        ],
+        "summary": "List Column Limits",
+        "description": "Each limited board column of the named projects the reader can open:\nits limit, and how many open tasks it holds. A project with no limits, or\none the reader can't open, has none.",
+        "operationId": "list_column_limits",
+        "security": [
+          {
+            "PluginToken": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ColumnFillRead"
+                  },
+                  "title": "Response List Column Limits"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        },
+        "x-plugin-scope": "projects:read",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "integer"
+              },
+              "minItems": 1,
+              "maxItems": 100,
+              "title": "Project Id"
+            }
+          },
+          {
+            "name": "session_token",
+            "in": "cookie",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Session Token"
+            }
+          }
+        ]
+      }
+    },
     "/tasks/{task_id}": {
       "get": {
         "tags": [
@@ -10384,7 +10731,7 @@
           "properties"
         ],
         "summary": "Set Properties",
-        "description": "Replace the custom property values on one tool or sub-tool.\n\nRequires write on the tool that governs it: a tool itself, or the tool a\nsub-tool sits in (a task's project, an event's calendar). Each value's\ndefinition must belong to the same initiative, so a row that belongs to no\ninitiative carries none. Values are validated against each definition's\ntype and options. An installed plug-in names the person a person-valued\nproperty holds by its reference for them. An empty list clears them all.",
+        "description": "Replace the custom property values on one tool or sub-tool, or with\n``merge`` write only the ones named and leave the rest, and change options\nof multi-select values against what each holds.\n\nRequires write on the tool that governs it: a tool itself, or the tool a\nsub-tool sits in (a task's project, an event's calendar). Each value's\ndefinition must belong to the same initiative, so a row that belongs to no\ninitiative carries none. Values are validated against each definition's\ntype and options. An installed plug-in names the person a person-valued\nproperty holds by its reference for them. An empty list clears them all.",
         "operationId": "set_properties",
         "security": [
           {
@@ -11353,6 +11700,13 @@
             },
             "type": "array",
             "title": "Extra Starts"
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values"
           }
         },
         "type": "object",
@@ -11381,7 +11735,8 @@
           "attendees",
           "overridden_fields",
           "skipped_starts",
-          "extra_starts"
+          "extra_starts",
+          "plugin_values"
         ],
         "title": "CalendarEventRead"
       },
@@ -11427,6 +11782,19 @@
             ],
             "title": "Description"
           },
+          "description_base": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-mentions": "markdown",
+                "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Description Base"
+          },
           "location": {
             "anyOf": [
               {
@@ -12014,6 +12382,35 @@
         ],
         "title": "ChecklistProgress"
       },
+      "ColumnFillRead": {
+        "properties": {
+          "project_id": {
+            "type": "integer",
+            "title": "Project Id"
+          },
+          "status_id": {
+            "type": "integer",
+            "title": "Status Id"
+          },
+          "limit": {
+            "type": "integer",
+            "title": "Limit"
+          },
+          "count": {
+            "type": "integer",
+            "title": "Count"
+          }
+        },
+        "type": "object",
+        "required": [
+          "project_id",
+          "status_id",
+          "limit",
+          "count"
+        ],
+        "title": "ColumnFillRead",
+        "description": "One limited column of a project's board: its limit, and how many open\ntasks it holds."
+      },
       "CommentAudience": {
         "type": "string",
         "enum": [
@@ -12205,12 +12602,24 @@
               }
             ],
             "title": "Next Cursor"
+          },
+          "locked": {
+            "type": "boolean",
+            "title": "Locked",
+            "default": false
+          },
+          "can_moderate": {
+            "type": "boolean",
+            "title": "Can Moderate",
+            "default": false
           }
         },
         "type": "object",
         "required": [
           "comments",
-          "next_cursor"
+          "next_cursor",
+          "locked",
+          "can_moderate"
         ],
         "title": "CommentListResponse",
         "description": "One page of a thread: ``limit`` conversations, newest first, each with\nevery reply under it."
@@ -12421,6 +12830,16 @@
             "title": "Can Remove",
             "default": false
           },
+          "removed": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CommentRemoval"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "audience": {
             "$ref": "#/components/schemas/CommentAudience",
             "default": "members"
@@ -12460,12 +12879,37 @@
           "imported_author_name",
           "reactions",
           "can_remove",
+          "removed",
           "audience",
           "system_kind"
         ],
         "title": "CommentRead",
         "description": "One comment. ``project_id`` is its own for a comment on a project and\nthe task's for a task comment (filled by the service's serializer)."
       },
+      "CommentRemoval": {
+        "properties": {
+          "by": {
+            "$ref": "#/components/schemas/RemovedBy"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/RemovalReason"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object",
+        "required": [
+          "by",
+          "reason"
+        ],
+        "title": "CommentRemoval",
+        "description": "What a tombstone says in place of a comment: who took it out, and,\nfor a moderator, why. Never what it said, or who wrote it."
+      },
       "ContentCan": {
         "properties": {
           "edit": {
@@ -13107,6 +13551,13 @@
             "type": "array",
             "title": "Properties"
           },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values"
+          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -13133,6 +13584,7 @@
           "view_mode",
           "position",
           "properties",
+          "plugin_values",
           "created_at",
           "updated_at"
         ],
@@ -13351,6 +13803,18 @@
         ],
         "title": "CounterViewMode"
       },
+      "DateBucket": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week",
+          "month",
+          "quarter",
+          "year"
+        ],
+        "title": "DateBucket",
+        "description": "What a date is grouped by: the calendar's day, week, month, quarter or\nyear it falls in. A week starts on Monday, as Postgres counts one."
+      },
       "FileCreate": {
         "properties": {
           "properties": {
@@ -14420,6 +14884,13 @@
             },
             "type": "array",
             "title": "Properties"
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values"
           }
         },
         "type": "object",
@@ -14442,7 +14913,8 @@
           "updated_at",
           "version_count",
           "tags",
-          "properties"
+          "properties",
+          "plugin_values"
         ],
         "title": "GalleryImageRead"
       },
@@ -14501,6 +14973,19 @@
               }
             ],
             "title": "Tag Ids"
+          },
+          "caption_base": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-mentions": "markdown",
+                "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Caption Base"
           }
         },
         "type": "object",
@@ -15027,6 +15512,59 @@
         "type": "object",
         "title": "GalleryUpdate"
       },
+      "GroupRead": {
+        "properties": {
+          "key": {
+            "type": "string",
+            "title": "Key"
+          },
+          "label": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Label"
+          }
+        },
+        "type": "object",
+        "required": [
+          "key"
+        ],
+        "title": "GroupRead",
+        "description": "One group of a grouped list."
+      },
+      "GroupsResponse": {
+        "properties": {
+          "groups": {
+            "items": {
+              "$ref": "#/components/schemas/GroupRead"
+            },
+            "type": "array",
+            "title": "Groups"
+          },
+          "rows": {
+            "additionalProperties": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "type": "object",
+            "title": "Rows"
+          }
+        },
+        "type": "object",
+        "required": [
+          "groups",
+          "rows"
+        ],
+        "title": "GroupsResponse",
+        "description": "A list's groups by one field, and the groups each row is in."
+      },
       "HTTPValidationError": {
         "properties": {
           "detail": {
@@ -15052,6 +15590,11 @@
             "title": "Moderate",
             "default": false
           },
+          "roster": {
+            "type": "boolean",
+            "title": "Roster",
+            "default": false
+          },
           "view": {
             "items": {
               "$ref": "#/components/schemas/Tool"
@@ -15071,6 +15614,7 @@
         "required": [
           "manage",
           "moderate",
+          "roster",
           "view",
           "create"
         ],
@@ -15451,6 +15995,29 @@
         "title": "PluginPerson",
         "type": "object"
       },
+      "PluginValueSummary": {
+        "properties": {
+          "plugin_id": {
+            "type": "integer",
+            "title": "Plugin Id"
+          },
+          "key": {
+            "type": "string",
+            "title": "Key"
+          },
+          "value": {
+            "title": "Value"
+          }
+        },
+        "type": "object",
+        "required": [
+          "plugin_id",
+          "key",
+          "value"
+        ],
+        "title": "PluginValueSummary",
+        "description": "One value an installed plug-in shows on an item: a key its pinned\nversion declares as a field there. A list field's value is an array of its\nelements, newest first, each with its ``ref``."
+      },
       "PollOptionRead": {
         "properties": {
           "id": {
@@ -15994,6 +16561,18 @@
             "title": "Reactions Enabled",
             "default": true
           },
+          "comments_locked_at": {
+            "anyOf": [
+              {
+                "type": "string",
+                "format": "date-time"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Comments Locked At"
+          },
           "comment_count": {
             "type": "integer",
             "title": "Comment Count",
@@ -16022,6 +16601,13 @@
                 "type": "null"
               }
             ]
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values"
           }
         },
         "type": "object",
@@ -16051,10 +16637,12 @@
           "is_read",
           "read_count",
           "reactions_enabled",
+          "comments_locked_at",
           "comment_count",
           "reactions",
           "body",
-          "poll"
+          "poll",
+          "plugin_values"
         ],
         "title": "PostRead"
       },
@@ -16486,23 +17074,6 @@
               }
             ]
           },
-          "is_favorited": {
-            "type": "boolean",
-            "title": "Is Favorited",
-            "default": false
-          },
-          "last_viewed_at": {
-            "anyOf": [
-              {
-                "type": "string",
-                "format": "date-time"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Last Viewed At"
-          },
           "task_summary": {
             "$ref": "#/components/schemas/ProjectTaskSummary"
           },
@@ -16512,6 +17083,13 @@
             },
             "type": "array",
             "title": "Task Statuses"
+          },
+          "task_types": {
+            "items": {
+              "$ref": "#/components/schemas/TaskTypeRead"
+            },
+            "type": "array",
+            "title": "Task Types"
           }
         },
         "type": "object",
@@ -16539,10 +17117,9 @@
           "owner",
           "owner_plugin",
           "initiative",
-          "is_favorited",
-          "last_viewed_at",
           "task_summary",
-          "task_statuses"
+          "task_statuses",
+          "task_types"
         ],
         "title": "ProjectRead"
       },
@@ -16896,6 +17473,36 @@
         "title": "PropertyOption",
         "description": "One option entry for select / multi_select property definitions."
       },
+      "PropertyOptionsChange": {
+        "properties": {
+          "property_id": {
+            "type": "integer",
+            "title": "Property Id"
+          },
+          "add": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "maxItems": 100,
+            "title": "Add"
+          },
+          "remove": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "maxItems": 100,
+            "title": "Remove"
+          }
+        },
+        "type": "object",
+        "required": [
+          "property_id"
+        ],
+        "title": "PropertyOptionsChange",
+        "description": "Options put on and taken off one multi-select value, against the value\nas it stands when the change is written rather than a list that replaces\nit, so two people changing different options of it both stand."
+      },
       "PropertySummary": {
         "properties": {
           "property_id": {
@@ -17002,11 +17609,32 @@
             },
             "type": "array",
             "title": "Values"
+          },
+          "merge": {
+            "type": "boolean",
+            "title": "Merge",
+            "default": false
+          },
+          "removed": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array",
+            "maxItems": 100,
+            "title": "Removed"
+          },
+          "options": {
+            "items": {
+              "$ref": "#/components/schemas/PropertyOptionsChange"
+            },
+            "type": "array",
+            "maxItems": 100,
+            "title": "Options"
           }
         },
         "type": "object",
         "title": "PropertyValuesSetRequest",
-        "description": "Replace-all payload for ``PUT /properties/{target}/{entity_id}``.\n\nAn empty list clears every property value on the entity."
+        "description": "Payload for ``PUT /properties/{target}/{entity_id}``: replace-all, or\nwith ``merge`` only the properties it names.\n\nReplacing, an empty list clears every property value on the entity."
       },
       "QueueCreate": {
         "properties": {
@@ -17253,10 +17881,29 @@
             ],
             "title": "Held At Round"
           },
+          "created_by": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-identity": "person"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Created By"
+          },
           "created_at": {
             "type": "string",
             "format": "date-time",
             "title": "Created At"
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values"
           }
         },
         "type": "object",
@@ -17274,7 +17921,9 @@
           "properties",
           "attachment_count",
           "held_at_round",
-          "created_at"
+          "created_by",
+          "created_at",
+          "plugin_values"
         ],
         "title": "QueueItemRead"
       },
@@ -17379,6 +18028,19 @@
               }
             ],
             "title": "Tag Ids"
+          },
+          "notes_base": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-mentions": "markdown",
+                "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Notes Base"
           }
         },
         "type": "object",
@@ -17853,6 +18515,42 @@
         "title": "ReactionGroup",
         "description": "One emoji on one target, and who chose it."
       },
+      "RecurrenceStrategy": {
+        "type": "string",
+        "enum": [
+          "fixed",
+          "rolling"
+        ],
+        "title": "RecurrenceStrategy",
+        "description": "How a repeating task's next date is counted."
+      },
+      "RemovalReason": {
+        "type": "string",
+        "enum": [
+          "spam",
+          "harassment",
+          "hate",
+          "violence",
+          "sexual_content",
+          "self_harm",
+          "illegal",
+          "misinformation",
+          "other",
+          "off_topic",
+          "community_rule"
+        ],
+        "title": "RemovalReason",
+        "description": "Why a moderator took something down. Every reason a report can give,\nand two that only a community's own rules give."
+      },
+      "RemovedBy": {
+        "type": "string",
+        "enum": [
+          "moderator",
+          "author"
+        ],
+        "title": "RemovedBy",
+        "description": "Who took a comment out of the conversation."
+      },
       "ResourceAccessLevel": {
         "type": "string",
         "enum": [
@@ -18022,12 +18720,12 @@
         "description": "A jump-to target for the command palette: enough to render and route."
       },
       "SortDir": {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "title": "SortDir",
-        "type": "string"
+        "title": "SortDir"
       },
       "SortField": {
         "properties": {
@@ -18243,13 +18941,21 @@
             "title": "Recurrence"
           },
           "recurrence_strategy": {
-            "type": "string",
-            "enum": [
-              "fixed",
-              "rolling"
+            "$ref": "#/components/schemas/RecurrenceStrategy",
+            "default": "fixed"
+          },
+          "recurrence_limit": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "maximum": 24,
+                "minimum": 1
+              },
+              {
+                "type": "null"
+              }
             ],
-            "title": "Recurrence Strategy",
-            "default": "fixed"
+            "title": "Recurrence Limit"
           },
           "description": {
             "anyOf": [
@@ -18299,6 +19005,17 @@
             ],
             "title": "Task Status Id"
           },
+          "task_type_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Task Type Id"
+          },
           "tag_ids": {
             "items": {
               "type": "integer"
@@ -18368,14 +19085,22 @@
             "title": "Recurrence"
           },
           "recurrence_strategy": {
-            "type": "string",
-            "enum": [
-              "fixed",
-              "rolling"
-            ],
-            "title": "Recurrence Strategy",
+            "$ref": "#/components/schemas/RecurrenceStrategy",
             "default": "fixed"
           },
+          "recurrence_limit": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "maximum": 24,
+                "minimum": 1
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Recurrence Limit"
+          },
           "description_excerpt": {
             "anyOf": [
               {
@@ -18409,6 +19134,13 @@
           "task_status": {
             "$ref": "#/components/schemas/TaskStatusRead"
           },
+          "task_type_id": {
+            "type": "integer",
+            "title": "Task Type Id"
+          },
+          "task_type": {
+            "$ref": "#/components/schemas/TaskTypeRead"
+          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -18477,6 +19209,24 @@
             "title": "Recurrence Shift",
             "default": 0
           },
+          "recurrence_anchor": {
+            "anyOf": [
+              {
+                "type": "string",
+                "format": "date-time"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Recurrence Anchor"
+          },
+          "recurrence_anchor_count": {
+            "type": "integer",
+            "minimum": 0,
+            "title": "Recurrence Anchor Count",
+            "default": 0
+          },
           "recurrence_until": {
             "anyOf": [
               {
@@ -18591,6 +19341,14 @@
             "type": "array",
             "title": "Properties",
             "default": []
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values",
+            "default": []
           }
         },
         "type": "object",
@@ -18601,12 +19359,15 @@
           "due_date",
           "recurrence",
           "recurrence_strategy",
+          "recurrence_limit",
           "description_excerpt",
           "has_description",
           "id",
           "project_id",
           "task_status_id",
           "task_status",
+          "task_type_id",
+          "task_type",
           "created_at",
           "updated_at",
           "completed_at",
@@ -18616,6 +19377,8 @@
           "assignees",
           "recurrence_occurrence_count",
           "recurrence_shift",
+          "recurrence_anchor",
+          "recurrence_anchor_count",
           "recurrence_until",
           "comment_count",
           "blocked_by_open_count",
@@ -18627,7 +19390,8 @@
           "initiative_color",
           "checklist_progress",
           "tags",
-          "properties"
+          "properties",
+          "plugin_values"
         ],
         "title": "TaskListRead",
         "description": "Lightweight schema for task list endpoints - excludes heavy nested data"
@@ -18833,14 +19597,22 @@
             "title": "Recurrence"
           },
           "recurrence_strategy": {
-            "type": "string",
-            "enum": [
-              "fixed",
-              "rolling"
-            ],
-            "title": "Recurrence Strategy",
+            "$ref": "#/components/schemas/RecurrenceStrategy",
             "default": "fixed"
           },
+          "recurrence_limit": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "maximum": 24,
+                "minimum": 1
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Recurrence Limit"
+          },
           "description": {
             "anyOf": [
               {
@@ -18869,6 +19641,13 @@
           "task_status": {
             "$ref": "#/components/schemas/TaskStatusRead"
           },
+          "task_type_id": {
+            "type": "integer",
+            "title": "Task Type Id"
+          },
+          "task_type": {
+            "$ref": "#/components/schemas/TaskTypeRead"
+          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -18947,6 +19726,24 @@
             "title": "Recurrence Shift",
             "default": 0
           },
+          "recurrence_anchor": {
+            "anyOf": [
+              {
+                "type": "string",
+                "format": "date-time"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Recurrence Anchor"
+          },
+          "recurrence_anchor_count": {
+            "type": "integer",
+            "minimum": 0,
+            "title": "Recurrence Anchor Count",
+            "default": 0
+          },
           "recurrence_until": {
             "anyOf": [
               {
@@ -19003,134 +19800,374 @@
             "title": "Checklist",
             "default": []
           },
-          "checklist_progress": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/ChecklistProgress"
-              },
-              {
-                "type": "null"
-              }
-            ]
+          "checklist_progress": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ChecklistProgress"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tags": {
+            "items": {
+              "$ref": "#/components/schemas/TagSummary"
+            },
+            "type": "array",
+            "title": "Tags",
+            "default": []
+          },
+          "properties": {
+            "items": {
+              "$ref": "#/components/schemas/PropertySummary"
+            },
+            "type": "array",
+            "title": "Properties",
+            "default": []
+          },
+          "plugin_values": {
+            "items": {
+              "$ref": "#/components/schemas/PluginValueSummary"
+            },
+            "type": "array",
+            "title": "Plugin Values",
+            "default": []
+          }
+        },
+        "type": "object",
+        "required": [
+          "title",
+          "priority",
+          "start_date",
+          "due_date",
+          "recurrence",
+          "recurrence_strategy",
+          "recurrence_limit",
+          "description",
+          "id",
+          "project_id",
+          "task_status_id",
+          "task_status",
+          "task_type_id",
+          "task_type",
+          "created_at",
+          "updated_at",
+          "completed_at",
+          "position",
+          "archived_at",
+          "created_by",
+          "creator",
+          "assignees",
+          "recurrence_occurrence_count",
+          "recurrence_shift",
+          "recurrence_anchor",
+          "recurrence_anchor_count",
+          "recurrence_until",
+          "series_id",
+          "series_size",
+          "comment_count",
+          "blocked_by_open_count",
+          "project",
+          "checklist",
+          "checklist_progress",
+          "tags",
+          "properties",
+          "plugin_values"
+        ],
+        "title": "TaskRead"
+      },
+      "TaskStatusCategory": {
+        "type": "string",
+        "enum": [
+          "backlog",
+          "todo",
+          "in_progress",
+          "done"
+        ],
+        "title": "TaskStatusCategory"
+      },
+      "TaskStatusRead": {
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 100,
+            "minLength": 1,
+            "title": "Name"
+          },
+          "category": {
+            "$ref": "#/components/schemas/TaskStatusCategory"
+          },
+          "position": {
+            "type": "integer",
+            "minimum": 0,
+            "title": "Position"
+          },
+          "is_default": {
+            "type": "boolean",
+            "title": "Is Default",
+            "default": false
+          },
+          "color": {
+            "type": "string",
+            "maxLength": 9,
+            "minLength": 4,
+            "pattern": "^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
+            "title": "Color"
+          },
+          "icon": {
+            "type": "string",
+            "maxLength": 64,
+            "minLength": 1,
+            "title": "Icon"
+          },
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "project_id": {
+            "type": "integer",
+            "title": "Project Id"
+          }
+        },
+        "type": "object",
+        "required": [
+          "name",
+          "category",
+          "position",
+          "is_default",
+          "color",
+          "icon",
+          "id",
+          "project_id"
+        ],
+        "title": "TaskStatusRead"
+      },
+      "TaskTypeGalleryEntry": {
+        "properties": {
+          "key": {
+            "type": "string",
+            "title": "Key"
+          },
+          "name": {
+            "type": "string",
+            "title": "Name"
+          },
+          "hint": {
+            "type": "string",
+            "title": "Hint"
+          },
+          "icon": {
+            "type": "string",
+            "title": "Icon"
+          },
+          "color": {
+            "type": "string",
+            "title": "Color"
+          },
+          "layout_preset": {
+            "type": "string",
+            "title": "Layout Preset"
+          },
+          "fields": {
+            "items": {
+              "$ref": "#/components/schemas/TaskTypeGalleryField"
+            },
+            "type": "array",
+            "title": "Fields"
+          },
+          "starting_values": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/TaskTypeStartingValues"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object",
+        "required": [
+          "key",
+          "name",
+          "hint",
+          "icon",
+          "color",
+          "layout_preset",
+          "fields"
+        ],
+        "title": "TaskTypeGalleryEntry",
+        "description": "One ready-made type, in the reader's language."
+      },
+      "TaskTypeGalleryField": {
+        "properties": {
+          "name": {
+            "type": "string",
+            "title": "Name"
+          },
+          "type": {
+            "type": "string",
+            "title": "Type"
+          }
+        },
+        "type": "object",
+        "required": [
+          "name",
+          "type"
+        ],
+        "title": "TaskTypeGalleryField"
+      },
+      "TaskTypeGalleryGroup": {
+        "properties": {
+          "key": {
+            "type": "string",
+            "title": "Key"
           },
-          "tags": {
-            "items": {
-              "$ref": "#/components/schemas/TagSummary"
-            },
-            "type": "array",
-            "title": "Tags",
-            "default": []
+          "name": {
+            "type": "string",
+            "title": "Name"
           },
-          "properties": {
+          "entries": {
             "items": {
-              "$ref": "#/components/schemas/PropertySummary"
+              "$ref": "#/components/schemas/TaskTypeGalleryEntry"
             },
             "type": "array",
-            "title": "Properties",
-            "default": []
+            "title": "Entries"
           }
         },
         "type": "object",
         "required": [
-          "title",
-          "priority",
-          "start_date",
-          "due_date",
-          "recurrence",
-          "recurrence_strategy",
-          "description",
-          "id",
-          "project_id",
-          "task_status_id",
-          "task_status",
-          "created_at",
-          "updated_at",
-          "completed_at",
-          "position",
-          "archived_at",
-          "created_by",
-          "creator",
-          "assignees",
-          "recurrence_occurrence_count",
-          "recurrence_shift",
-          "recurrence_until",
-          "series_id",
-          "series_size",
-          "comment_count",
-          "blocked_by_open_count",
-          "project",
-          "checklist",
-          "checklist_progress",
-          "tags",
-          "properties"
-        ],
-        "title": "TaskRead"
-      },
-      "TaskStatusCategory": {
-        "type": "string",
-        "enum": [
-          "backlog",
-          "todo",
-          "in_progress",
-          "done"
+          "key",
+          "name",
+          "entries"
         ],
-        "title": "TaskStatusCategory"
+        "title": "TaskTypeGalleryGroup"
       },
-      "TaskStatusRead": {
+      "TaskTypeRead": {
         "properties": {
+          "id": {
+            "type": "integer",
+            "title": "Id"
+          },
+          "project_id": {
+            "type": "integer",
+            "title": "Project Id"
+          },
           "name": {
             "type": "string",
-            "maxLength": 100,
-            "minLength": 1,
             "title": "Name"
           },
-          "category": {
-            "$ref": "#/components/schemas/TaskStatusCategory"
-          },
           "position": {
             "type": "integer",
-            "minimum": 0,
             "title": "Position"
           },
           "is_default": {
             "type": "boolean",
-            "title": "Is Default",
-            "default": false
+            "title": "Is Default"
           },
           "color": {
             "type": "string",
-            "maxLength": 9,
-            "minLength": 4,
-            "pattern": "^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
             "title": "Color"
           },
           "icon": {
             "type": "string",
-            "maxLength": 64,
-            "minLength": 1,
             "title": "Icon"
           },
-          "id": {
-            "type": "integer",
-            "title": "Id"
+          "layout_preset": {
+            "type": "string",
+            "title": "Layout Preset"
           },
-          "project_id": {
-            "type": "integer",
-            "title": "Project Id"
+          "starting_values": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/TaskTypeStartingValues"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "type": "object",
         "required": [
+          "id",
+          "project_id",
           "name",
-          "category",
           "position",
           "is_default",
           "color",
           "icon",
-          "id",
-          "project_id"
+          "layout_preset",
+          "starting_values"
         ],
-        "title": "TaskStatusRead"
+        "title": "TaskTypeRead",
+        "description": "One kind of task in a project, and the shape its page is drawn as until\nthe page is changed."
+      },
+      "TaskTypeStartingValues": {
+        "properties": {
+          "description": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-mentions": "markdown",
+                "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Description"
+          },
+          "checklist": {
+            "items": {
+              "type": "string",
+              "maxLength": 2000,
+              "minLength": 1,
+              "x-mentions": "markdown",
+              "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+            },
+            "type": "array",
+            "maxItems": 50,
+            "title": "Checklist"
+          },
+          "priority": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/TaskPriority"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "recurrence": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 4000,
+                "description": "RFC 5545 recurrence lines: one RRULE, and optional EXDATE and RDATE lines in UTC. The rule's days are as picked in the request's tz, or UTC days without one. POST /recurrence/preview lists its next starts."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Recurrence"
+          },
+          "recurrence_strategy": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/RecurrenceStrategy"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object",
+        "title": "TaskTypeStartingValues",
+        "description": "What a new task of a type starts with, field by field, where whoever\nmakes it leaves that field empty. A repeat starts only on a task with a\ndate to count from."
       },
       "TaskUpdate": {
         "properties": {
@@ -19172,6 +20209,19 @@
             ],
             "title": "Description"
           },
+          "description_base": {
+            "anyOf": [
+              {
+                "type": "string",
+                "x-mentions": "markdown",
+                "description": "A person is mentioned as `@[](<reference>)`, by your reference for them, with no name: read who they are from the members search (`members:read`). Write a mention the same way. A stored file comes without its path: `![alt]()`, `[name]()`."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Description Base"
+          },
           "task_status_id": {
             "anyOf": [
               {
@@ -19183,6 +20233,27 @@
             ],
             "title": "Task Status Id"
           },
+          "task_type_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Task Type Id"
+          },
+          "status_category": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/TaskStatusCategory"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "priority": {
             "anyOf": [
               {
@@ -19208,6 +20279,38 @@
             ],
             "title": "Assignee Ids"
           },
+          "add_assignee_ids": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string",
+                  "x-identity": "person"
+                },
+                "type": "array",
+                "maxItems": 100
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Add Assignee Ids"
+          },
+          "remove_assignee_ids": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string",
+                  "x-identity": "person"
+                },
+                "type": "array",
+                "maxItems": 100
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Remove Assignee Ids"
+          },
           "start_date": {
             "anyOf": [
               {
@@ -19260,17 +20363,25 @@
           "recurrence_strategy": {
             "anyOf": [
               {
-                "type": "string",
-                "enum": [
-                  "fixed",
-                  "rolling"
-                ]
+                "$ref": "#/components/schemas/RecurrenceStrategy"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "recurrence_limit": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "maximum": 24,
+                "minimum": 1
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Recurrence Strategy"
+            "title": "Recurrence Limit"
           },
           "tag_ids": {
             "anyOf": [
@@ -20081,6 +21192,18 @@
               }
             ],
             "title": "Content Version"
+          },
+          "comments_locked_at": {
+            "anyOf": [
+              {
+                "type": "string",
+                "format": "date-time"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Comments Locked At"
           }
         },
         "type": "object",
@@ -20105,7 +21228,8 @@
           "original_filename",
           "smart_link_url",
           "content",
-          "content_version"
+          "content_version",
+          "comments_locked_at"
         ],
         "title": "WikiPageRead",
         "description": "One page, opened."