taskstringобязательный
Task name, visual ID (C1, T2), or UUID
namestring
New task title (rename the task)
prioritynumber
New priority
statusstring
New status: open, in_progress, blocked, review, done
slastring
New deadline
descriptionstring
New description. Rendered as Markdown - use `**bold**`, lists, `code`, links, etc. Keep it short (a few sentences); use `markdown` for long-form docs.
markdownstring
Long-form markdown content — use for investigation findings, technical/functional docs, solution design, root cause analysis. Overwrites existing markdown; read first with karea_get_markdown to append.
categorystring
Move to category
notestring
Add a human-readable note (the user reads these). Markdown is supported (lists, **bold**, `code`, links) - use it when it makes the note more readable; plain text is also fine. For private AI cross-session working memory use karea_set_context instead.
tagsstring[]
Tags to attach. STRICT: only pass tags that already exist in this project (check karea_view_task first). Do NOT invent new tags unless the user explicitly asked for one — the API upserts by name and typos create duplicates. When unsure, omit and ask.
clearTagsboolean
Remove all existing tags before adding new ones
closingRequisitesstring[]
Closing requisites to add. Keep each short and concrete - 1 short sentence, ideally under ~120 chars. Do NOT write paragraphs.
clearClosingRequisitesboolean
Remove all existing closing requisites before adding new ones
jiraIssueKeystring
JIRA issue key to link (e.g. PROJ-123). Set to "unlink" to remove.
projectIdstring
Project name or ID
aiSessionIdstring
Optional: your current AI CLI session ID. When paired with toolType, atomically links this session to the affected task (equivalent to calling karea_link_session, but saves the round-trip). For Claude Code use the id from `claude --resume`.
toolTypeenum
Optional: your AI provider ("claude-code" / "opencode" / "codex" / "cursor" / "aider" / "other"). Required when aiSessionId is supplied.
sessionLabelstring
Optional short label for the linked session (e.g. "Feature draft").