Links

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.

Saved Link`link`

A saved URL for later reading. The same operations reach the lists that organize saved links (type 'list').

links_findFindthrough vritto_find

Read Links: saved links filtered by status, list, tag, type, favorite, who shared them or text, with the user's lists (compact rows, active links by default); or one link by id with its url, notes and full TL;DR. Use it to resolve link and list IDs before any write.

Note: Returns the user's lists beside the links.

Field	Type	Description
id	string	One saved link: its url, notes, description and AI summary.
status	one of unread, reading, read, archived	Filter to one reading status.
listId	string	Only links in this list.
tag	string	Only links with this tag.
type	one of article, video, product, social, audio, image, pdf, document, app, other	Only links of this content type.
favorite	boolean	Only starred links when true.
sharedByPersonId	string	Only links shared by this person.
query	string	Free-text search over title, description, domain, tags.
detail	one of summary, full	Row shape: "summary" (default, id/title/domain/status/tags/createdAt/tldrPreview) or "full" (every field incl. url, description, notes, and the stored AI summary).
includeArchived	boolean	Include archived links (default false).
limit	integer	Max links to return (default 50 in summary mode, 200 in full).
linkId	string	Older name for id.

Example input

{
  "status": "unread"
}

links_addCreatethrough vritto_create

Add to Links: save a URL (the server unfurls title, description, site, image, type and read-time; a URL already saved is updated, not duplicated), optionally with title, tags, a listId, who shared it, sharedContext, a reminder (remindOn), status or a note. Or make a new list (type 'list' with a name).

Note: Saves any web page or video link, YouTube included. type 'list' with a name makes a new list.

Field	Type	Description
type	one of link, list	Record type: 'link' (default) a saved URL; 'list' a collection that organizes saved links.
url	string	A link: the URL to save, e.g. 'https://example.com/article'.
title	string	Override the auto-fetched title.
note	string	A note to attach to the link.
tags	list of string	Topic tags.
listId	string	File the link into this existing list.
status	one of unread, reading, read, archived	Initial reading status (default 'unread').
favorite	boolean	Star it on save.
sharedByPersonId	string	Person ID of who shared it (from the People module).
sharedByName	string	Name of who shared it, if not a saved contact.
sharedContext	string	Where/how it was shared, e.g. 'via Slack'.
remindOn	string	Set a 'read this' reminder for this date (YYYY-MM-DD).
name	string	Type 'list': the list name, e.g. 'Recipes to try'.
description	string	Type 'list': an optional description.
color	string	Type 'list': an optional accent color (hex).

Example input

{
  "url": "https://www.nytimes.com/2026/09/24/well/eat/weeknight-dinners.html",
  "note": "Try the lentil one",
  "sharedByName": "Priya"
}

links_changeUpdatethrough vritto_update

Change one saved link by id: record merges field changes (title, description, type, tags, listIds, sharedByPersonId, sharedContext, notes); status and favorite mark it read, archived or starred; remindOn sets or (null) clears a reminder; listId files it into a list (remove true takes it out). Or a list (type 'list' with its id: name, description, color).

Field	Type	Description
type	one of link, list	Record type: 'link' (default) a saved URL; 'list' a collection that organizes saved links.
id	string	The link, or with type 'list' the list, to change.
record	object	A link's fields to change; the rest stay.
record.id	string	Existing link ID to update, from a prior links_find result (or send it as id).
record.title	string	Human title for the link. The server auto-fills this on save.
record.description	string	Short description / summary of the page.
record.type	one of article, video, product, social, audio, image, pdf, document, app, other	Content type: article, video, product, social, pdf, etc.
record.status	one of unread, reading, read, archived	Reading status: unread → reading → read, or archived.
record.favorite	boolean	Star the link.
record.tags	list of string	Topic tags, e.g. ['ai', 'productivity'].
record.listIds	list of string	IDs of the lists this link belongs to (replaces the set).
record.sharedByPersonId	string	Person ID (from people_find) of who shared this link. Empty string clears it.
record.sharedContext	string	Where/how it was shared, e.g. 'via Slack' or 'in our DM'.
record.notes	string	The user's own notes/thoughts on the link.
status	one of unread, reading, read, archived	New reading status.
favorite	boolean	Star or unstar the link.
remindOn	string	Date to be reminded (YYYY-MM-DD), or null to clear.
listId	string	A link: the list to file it into (or with remove, take it out of).
remove	boolean	With listId: remove the link from the list instead of adding it.
name	string	Type 'list': a new name.
description	string	Type 'list': a new description.
color	string	Type 'list': a new accent color (hex).
linkId	string	Older name for a link's id.

Example input

{
  "id": "link_dinners",
  "status": "read"
}

links_removeDeletethrough vritto_delete

Remove (archive) one saved link, or delete a list (type 'list'; its links stay saved). Only for explicit removal requests. Resolve the id with links_find first.

Note: A link is archived. type 'list' deletes a list; its links stay saved.

Field	Type	Description
type	one of link, list	Record type: 'link' (default) a saved URL; 'list' a collection that organizes saved links.
id	string	The link, or with type 'list' the list, to remove.
linkId	string	Older name for a link's id.

Kept in the Vritto app

links_summarizeLink: Runs Vritto's own AI; the calling assistant is already an AI.
links_autoTagLink: Runs Vritto's own AI; the calling assistant is already an AI.

Links

Saved Linklink

Kept in the Vritto app

Saved Link`link`