task description auto

api/openapi.yaml

@@ -1311,7 +1311,7 @@ components:
       properties:
         id: { type: string }
         project_id: { type: string }
-        title: { type: string }
+        title: { type: string, description: "Empty until the task's agent names it with set_task_title, when the task was created without one." }
         merge_title: { type: string, description: "The title of the squash commit Merge makes: the task title until the agent sets another with set_merge_title." }
         branch: { type: string }
         worktree_path: { type: string }
@@ -1391,9 +1391,12 @@ components:
 
     TaskCreate:
       type: object
-      required: [title]
       properties:
-        title: { type: string }
+        title:
+          type: string
+          description: >
+            The task's title. Without it the task starts untitled, and its agent names it with set_task_title.
+            Required with workflow.
         prompt:
           type: string
           description: Starts the task's agent with this as its first message, in the same request. Not with workflow.