hjarni

Previous value: -"Archive (true) or unarchive (false) the note. Personal notes only."New value: +"Archive (true) or unarchive (false) the note. Works on your own personal notes and on team notes where you have the editor role; notes in shared containers can only be archived by their owner."

Previous value: -"Parent container ID for nesting. Must belong to the same scope (personal or team) as the new container."New value: +"Parent container ID for nesting, or null/omitted for a top-level container. Must belong to the same scope (personal or team) as the new container."

Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]

Previous value: -"New parent container ID (null for root). Must belong to the same scope as the container."New value: +"New parent container ID, or null to move the container to root level. Must belong to the same scope as the container."

Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]

Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]

Previous value: -"Permanently delete a note. This action cannot be undone."New value: +"Move a note to Trash (recoverable with notes-restore until its purge date)."

Previous value: -"Filter scope (default: active). 'inbox' and 'favorited' only for personal notes."New value: +"Filter scope (default: active). 'inbox' and 'favorited' only for personal notes; 'trashed' lists the recoverable Trash — restore an entry with notes-restore."

Previous value: -[
-  "active",
-  "archived",
-  "inbox",
-  "favorited"
-]New value: +[
+  "active",
+  "archived",
+  "inbox",
+  "favorited",
+  "trashed"
+]

Added value: +{
+  "description": "What does NOT belong in this folder (e.g. 'No meeting notes, those go in Meetings'). Helps route notes away from the wrong place.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "What does NOT belong in this folder, or null to clear it.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Optional ISO 8601 datetime after which the note should be treated as stale. Use for time-boxed notes (e.g. '2026-12-31').",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Filter to notes whose freshness is stale — past their review_after date or unverified beyond the freshness window (default: not filtered)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "ISO 8601 datetime after which the note should be treated as stale (time-boxing), or null to clear it.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Pass true to mark the note re-confirmed as still true as of now (the 'mark verified' affordance). Refreshes verified_at and clears 'stale' status. Only send after the user has confirmed the note is still accurate.",
+  "type": "boolean"
+}

Previous value: -"Move to this container"New value: +"Folder (container) id to move the note into; pass null to move it to the inbox (remove it from its folder)"

Previous value: -"Update a note. Supports partial updates — only provided fields are changed. Body-mutation modes (body, append_body, insert_body, replace_find) are mutually exclusive."New value: +"Update a note. Supports partial updates — only provided fields are changed. The body-mutation modes (body, append_body, insert_body, replace_find, replace_section, append_to_section, rename_heading, check_item, uncheck_item) are mutually exclusive — supply at most one per call."

Previous value: -"Content to append to the existing body. Mutually exclusive with body, insert_body, and replace_find."New value: +"Content to append to the existing body. Mutually exclusive with the other body-mutation modes."

Added value: +{
+  "description": "Heading to append content to (with or without leading '#'). Adds section_body at the END of that section — the safe way to 'insert under a heading'. Pair with section_body. Heading must match exactly one.",
+  "type": "string"
+}

Previous value: -"New body content — full replacement. Mutually exclusive with append_body, insert_body, and replace_find. Pair with expected_lock_version for concurrent-edit safety."New value: +"New body content — full replacement. Mutually exclusive with the other body-mutation modes. Pair with expected_lock_version for concurrent-edit safety."

Added value: +{
+  "description": "Text of a checklist item to tick (set to '[x]'). Matched case- and whitespace-insensitively; a leading bullet/checkbox in the text is ignored. Must match exactly one item.",
+  "type": "string"
+}

Previous value: -"Text to insert. Must be paired with either insert_after or insert_before. Mutually exclusive with body, append_body, and replace_find."New value: +"Text to insert. Must be paired with either insert_after or insert_before. Mutually exclusive with the other body-mutation modes."

Added value: +{
+  "description": "New heading text for rename_heading. The original level is preserved unless this carries its own leading '#' markers.",
+  "type": "string"
+}

Added value: +{
+  "description": "Heading to rename (with or without leading '#'). Pair with new_heading. Heading must match exactly one.",
+  "type": "string"
+}

Previous value: -"Snippet to find in the existing body. Must match exactly once. Mutually exclusive with body, append_body, and insert_body."New value: +"Snippet to find in the existing body. Must match exactly once. Mutually exclusive with the other body-mutation modes."

Added value: +{
+  "description": "Heading whose section content should be replaced (with or without leading '#', e.g. '## Status' or 'Status'). Replaces everything under the heading up to the next same-or-higher-level heading, keeping the heading line. Pair with section_body. Heading must match exactly one.",
+  "type": "string"
+}

Added value: +{
+  "description": "The content for replace_section / append_to_section. Required when either is given.",
+  "type": "string"
+}

Added value: +{
+  "description": "Text of a checklist item to untick (set to '[ ]'). Same matching rules as check_item.",
+  "type": "string"
+}

Previous value: -"Short summary of the note"New value: +"A 2-3 sentence summary of the note. Always provide one."

Previous value: -"Text to replace replace_find with. Use an empty string to delete the matched snippet."New value: +"Optional replacement for replace_find. Omit it (or pass an empty string) to delete the matched snippet."

Added value: +"brain"

Previous value: -"Instruction level: 'brain' (global), 'personal_root', 'container', or 'team' (required)"New value: +"Instruction level: 'brain' (global), 'personal_root', 'container', or 'team'. Defaults to 'brain' if omitted or blank."

Previous value: -[
-  "level"
-]New value: +[]

Previous value: -"New body content — full replacement. Mutually exclusive with append_body, insert_body, and replace_find."New value: +"New body content — full replacement. Mutually exclusive with append_body, insert_body, and replace_find. Pair with expected_lock_version for concurrent-edit safety."

Added value: +{
+  "description": "Optional concurrent-edit guard. Pass the lock_version you saw when you last read the note; if it doesn't match the current version, the update is rejected and you should re-read and re-apply. Checked whenever supplied — covers title, summary, container_id, body, anything else. Surgical body edits without this param still work and remain anchor-safe; supply it any time you want a stale-write guard for the other fields too.",
+  "type": "integer"
+}