Task Toggle¶
Complete, reopen, or toggle a native task atomically. Preserves an optional historical done date and the prior attention state for an idempotent reopen.
MCP name: task_toggle
Category: tasks
Mutates state (retry policy: verify_first)
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
client_mutation_id |
str |
No | Optional stable idempotency key. |
done |
bool |
No | True=complete, False=incomplete, omit=toggle |
done_date |
str |
No | ISO YYYY-MM-DD to stamp as the completion date when marking done. Defaults to today. Use for retroactive completion (e.g. the landing-commit date a completeness check uncovered). Ignored when reopening. |
expected_revision |
int |
No | Current task revision for compare-and-swap; the gateway pins it when omitted. |
task_id |
str |
Yes | Task ID (e.g., 't-xxxxxxxx') |