Notes

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

Note`note`

A note, meeting note, idea, decision, or reference. The same operations reach the notebooks that file notes (type 'notebook').

notes_findFindthrough vritto_find

Read Notes: search notes by free text, kind, notebook, tag or linked record, most recently updated first, one note by id, or type 'notebook' for the notebooks with their note counts. ALWAYS pass from/to (updated dates) when the question concerns a period. Compact rows unless detail is 'full'.

Field	Type	Description
type	one of note, notebook	'note' (default) or 'notebook' (lists notebooks; includeArchived for archived ones).
id	string	Return just this note.
noteId	string	Older name for id.
query	string	Search text.
kind	one of note, daily, meeting, decision, idea, reference
notebook	string	Notebook name filter.
notebookId	string	Only notes filed in this notebook.
tag	string	Exact tag filter.
from	string	Only notes updated ON or AFTER this YYYY-MM-DD date.
to	string	Only notes updated ON or BEFORE this YYYY-MM-DD date.
updatedFrom	string	Older name for from.
updatedTo	string	Older name for to.
linkedModuleId	string	Only notes linked to records of this module.
linkedEntityId	string	Only notes linked to this record ID.
view	one of active, archived, trash	"active" (default), "archived", or "trash" (notes deleted in the last 30 days).
includeArchived	boolean	Include archived notes (or notebooks) alongside active ones; default false.
detail	one of summary, full	"summary" (default, id/title/excerpt/tags/updatedAt/checklistCount) or "full" (every field incl. the complete body and checklist).
limit	integer	Max records (default 50 in summary mode).

Example input

{
  "query": "kitchen"
}

notes_addCreatethrough vritto_create

Add a note for durable context, meeting notes, ideas, decisions, references, or freeform capture: a title, plus body (HTML or plain text), kind, notebook, tags, checklist and linked records from the user's words. type 'notebook' adds a notebook (a name already on file returns it).

Field	Type	Description
type	one of note, notebook	'note' (default) or 'notebook'.
record	object	The note (title required) or, with type 'notebook', the notebook (name required).
record.title	string	Note title.
record.body	string	Note body as HTML or plain text. Write ordinary prose markup (p, h1-h3, ul/ol, blockquote, pre/code, tables, and task lists via <ul data-type="taskList">); it is converted to the note's rich document server-side.
record.kind	one of note, daily, meeting, decision, idea, reference	Note kind (default 'note').
record.status	one of active, archived, deleted	Note lifecycle status (default 'active'). Set 'archived' to archive a note without deleting it.
record.notebook	string	Notebook or collection name.
record.tags	list of string	Tags.
record.linkedRefs	list of object	Linked module records this note references.
record.sourceRefs	list of object	Module records this note was captured from (its provenance).
record.checklist	list of object	Checklist edits addressed BY ID: pass {id, done} to tick or untick an existing item, {id, title} to rename it. Read the ids with notes_find first. Items live inside the note body, so add new ones by writing the body, not here.
record.notebookId	string	Notebook ID; prefer this over the name when known.
record.pinned	boolean	Pinned note.
record.favorite	boolean	Favorite note.
record.aiContextEnabled	boolean	Available to SahAI context retrieval (default true).
record.idempotencyKey	string	Stable dedupe key.
record.name	string	Type 'notebook': its name. Required when adding one.
record.accent	integer	Type 'notebook': accent colour index.
note	object	Older form of record (notes_createNote).
note.title	string
notebook	object	Older form (notes_createNotebook): the notebook.
notebook.name	string

Example input

{
  "record": {
    "title": "Kitchen remodel ideas",
    "body": "Open shelving, warmer lighting, move the fridge.",
    "kind": "idea",
    "tags": [
      "home"
    ]
  }
}

notes_changeUpdatethrough vritto_update

Change one note by record.id: sent fields change, others are kept. Pin, favorite, archive (status 'archived'), tick a checklist item by id, or bring a deleted note back from Trash (status 'active'). type 'notebook' renames a notebook or changes its accent.

Note: Archive with status 'archived'; status 'active' brings a note back from Trash.

Field	Type	Description
type	one of note, notebook	'note' (default) or 'notebook'.
record	object	The record's id plus the fields to change.
record.title	string	Note title.
record.body	string	Note body as HTML or plain text. Write ordinary prose markup (p, h1-h3, ul/ol, blockquote, pre/code, tables, and task lists via <ul data-type="taskList">); it is converted to the note's rich document server-side.
record.kind	one of note, daily, meeting, decision, idea, reference	Note kind (default 'note').
record.status	one of active, archived, deleted	Note lifecycle status (default 'active'). Set 'archived' to archive a note without deleting it.
record.notebook	string	Notebook or collection name.
record.tags	list of string	Tags.
record.linkedRefs	list of object	Linked module records this note references.
record.sourceRefs	list of object	Module records this note was captured from (its provenance).
record.checklist	list of object	Checklist edits addressed BY ID: pass {id, done} to tick or untick an existing item, {id, title} to rename it. Read the ids with notes_find first. Items live inside the note body, so add new ones by writing the body, not here.
record.notebookId	string	Notebook ID; prefer this over the name when known.
record.pinned	boolean	Pinned note.
record.favorite	boolean	Favorite note.
record.aiContextEnabled	boolean	Available to SahAI context retrieval (default true).
record.idempotencyKey	string	Stable dedupe key.
record.id*	string	The note (or notebook) to change.
record.name	string	Type 'notebook': its name. Required when adding one.
record.accent	integer	Type 'notebook': accent colour index.
expectedRevision	integer	Revision guard from the last read.
noteId	string	Older form: the note, with patch (notes_patchNote) or alone to restore it (notes_restoreNote).
patch	object	Older form, with noteId or notebookId: the fields to change.
patch.aiContextEnabled	boolean
note	object	Older form (notes_updateNote): the note's fields with its id.
note.id	string
note.aiContextEnabled	boolean
notebookId	string	Older form (notes_patchNotebook): the notebook, with patch.

Example input

{
  "record": {
    "id": "note_kitchen",
    "pinned": true
  }
}

notes_removeDeletethrough vritto_delete

Move one note to Trash, where it stays recoverable for 30 days, or (type 'notebook') delete a notebook and move its notes elsewhere (Inbox by default; notes are never deleted). Only for explicit deletion requests.

Note: Moves the note to trash, recoverable for 30 days. type 'notebook' deletes a notebook; its notes move to the Inbox.

Field	Type	Description
type	one of note, notebook	'note' (default) or 'notebook'.
id	string	The note (or notebook) to delete.
expectedRevision	integer	Revision guard from the last read.
moveToNotebookId	string	Type 'notebook': where its notes go; defaults to Inbox.
noteId	string	Older name for id (a note).
notebookId	string	Older name for id (a notebook).

Notes

Notenote

Note`note`