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.
categorystring
Move to category
clearClosingRequisitesboolean
Remove all existing closing requisites before adding new ones
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.
descriptionstring
New description. Rendered as Markdown - use **bold**, lists, code, links, etc. Keep it short (a few sentences); use markdown for long-form docs.
jiraIssueKeystring
JIRA issue key to link (e.g. PROJ-123). Set to "unlink" to remove.
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.
namestring
New task title (rename the task)
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.
prioritynumber
New priority
projectIdstring
Project name or ID
sessionLabelstring
Optional short label for the linked session (e.g. "Feature draft").
slastring
New deadline
statusstring
New status: open, in_progress, blocked, review, done
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.
taskstringобязательный
Task name, visual ID (C1, T2), or UUID
toolTypeenum
Optional: your AI provider ("claude-code" / "opencode" / "codex" / "cursor" / "aider" / "other"). Required when aiSessionId is supplied.