updateTask

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID."
    },
    "taskId": {
      "type": "string"
    },
    "versionTimestamp": {
      "type": "number",
      "description": "Version timestamp from getTask() for optimistic locking."
    },
    "title": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "priority": {
      "type": "string"
    },
    "urgency": {
      "type": "string"
    },
    "owner_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "User UUID to assign as owner, or null to unassign. MUTUALLY EXCLUSIVE with owner_team_id — when switching from a user to a team owner, send `owner_id: null` in the same call as `owner_team_id`. Use listAssignablePrincipals(projectId, kind='user', q='…') to look up valid UUIDs."
    },
    "owner_team_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Team UUID to assign as owner, or null to unassign. MUTUALLY EXCLUSIVE with owner_id — when switching from a team to a user owner, send `owner_team_id: null` in the same call as `owner_id`. Use listTeams or listAssignablePrincipals(kind='team') to look up valid UUIDs."
    },
    "target_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "position": {
      "type": "number"
    },
    "description": {
      "type": "string"
    },
    "wbs_code": {
      "type": "string"
    },
    "percent_complete": {
      "type": "number",
      "description": "Progress percentage (0-100). Null to clear."
    },
    "problem_statement": {
      "type": "string"
    },
    "desired_outcome": {
      "type": "string"
    },
    "business_impact": {
      "type": "string"
    },
    "user_impact": {
      "type": "string"
    },
    "why_now": {
      "type": "string"
    },
    "acceptance_criteria": {
      "type": "array",
      "description": "Acceptance criteria — ordered list of pass/fail statements that define \"done\" for this item. Each row is `{ id, text }` with server-stamped `updated_at / updated_by / updated_by_credential_name`. REPLACES the whole array on update. Echo back existing `id`s on rows you keep so attribution stamps survive. Bare strings are accepted for convenience (e.g. `[\"row 1\", \"row 2\"]`) and auto-converted to `{ id, text }`.",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "description": "Shorthand for `{ text: \"...\" }`."
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Optional — server mints one if omitted. Preserve on edits."
              },
              "text": {
                "type": "string"
              },
              "updated_at": {
                "type": "string",
                "description": "Server-stamped. Echo back unchanged; ignored on new rows."
              },
              "updated_by": {
                "type": "string",
                "description": "Server-stamped user id. Echo back unchanged."
              },
              "updated_by_credential_name": {
                "type": "string",
                "description": "Server-stamped credential label. Echo back unchanged."
              }
            },
            "required": [
              "text"
            ]
          }
        ]
      }
    },
    "checklist": {
      "type": "array",
      "description": "Tick-box checklist shown above acceptance_criteria. The full array REPLACES the stored list on update, and array order = display order — to edit, fetch via getTask/getImprovement, modify, and send back the whole list. Operations: mark done with `completed: true`; un-mark with `completed: false`; add rows by appending `{ text }` (id is auto-minted); remove by omitting; reorder by rearranging. Echo back each existing `id` you keep so per-row attribution (who added/completed it, when) survives.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Optional — server mints one if omitted. Preserve on edits."
          },
          "text": {
            "type": "string"
          },
          "due_date": {
            "type": "string",
            "description": "Optional YYYY-MM-DD; null to clear."
          },
          "completed": {
            "type": "boolean",
            "description": "true = ticked, false/omitted = not done. Server stamps timestamp + actor."
          },
          "completed_at": {
            "type": "string",
            "description": "Server-stamped ISO timestamp. Prefer `completed`; an explicit value here wins if both are sent."
          },
          "completed_by": {
            "type": "string",
            "description": "Server-stamped user id. Echo back unchanged."
          },
          "completed_by_credential_name": {
            "type": "string",
            "description": "Server-stamped credential label. Echo back unchanged."
          },
          "updated_at": {
            "type": "string",
            "description": "Server-stamped. Echo back unchanged; ignored on new rows."
          },
          "updated_by": {
            "type": "string",
            "description": "Server-stamped user id. Echo back unchanged."
          },
          "updated_by_credential_name": {
            "type": "string",
            "description": "Server-stamped credential label. Echo back unchanged."
          }
        },
        "required": [
          "text"
        ]
      }
    },
    "constraints": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "non_goals": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "impacted_documents": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "linked_document_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Document IDs to link."
    },
    "impacted_diagrams": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "impacted_components": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "impacted_repositories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "agent_ready": {
      "type": "boolean"
    },
    "agent_missing_info": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "agent_recommended_action": {
      "type": "string"
    },
    "agent_complexity": {
      "type": "string"
    },
    "agent_confidence": {
      "type": "number"
    },
    "agent_brief": {
      "type": "string"
    },
    "resolution_summary": {
      "type": "string"
    },
    "resolution_pr_url": {
      "type": "string"
    },
    "docs_updated": {
      "type": "boolean"
    },
    "follow_up_needed": {
      "type": "boolean"
    },
    "blocked_comment": {
      "type": "string",
      "description": "Required when status=blocked."
    },
    "rejection_comment": {
      "type": "string",
      "description": "Required when status=rejected."
    },
    "completion_comment": {
      "type": "string",
      "description": "Required when status=done."
    },
    "reopened_comment": {
      "type": "string",
      "description": "Required when moving OUT of a closed status. The closed set is blocked, done, rejected and deferred — note that `blocked` counts as closed, so blocked -> in_progress needs this comment."
    },
    "relationships": {
      "type": "object",
      "description": "Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). REPLACES the stored object wholesale — read it first and send the complete set."
    },
    "metadata": {
      "type": "object",
      "description": "Free-form JSON. MERGES into the stored object key by key: keys you don't send are left alone, and sending a key with value null deletes it. Send metadata_replace:true to overwrite the whole object instead. (Merging is the default so a partial write can never destroy a sibling key written by another actor.)"
    },
    "metadata_replace": {
      "type": "boolean",
      "description": "Opt out of the metadata merge: true means the object you send REPLACES everything stored, deleting any key you omit. Default false."
    },
    "plan_id": {
      "type": "string",
      "description": "Link to plan. Null to unlink."
    },
    "phase_id": {
      "type": "string",
      "description": "Assign to phase. Null to unassign."
    }
  },
  "required": [
    "taskId",
    "versionTimestamp"
  ]
}