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.

links_getLinkFindthrough vritto_find

Get one saved link by ID, including notes and any AI summary. Resolve the ID with links_listLinks first.

Field	Type	Description
linkId*	string	Link ID from a prior links_listLinks result, never invented.

links_listLinksFindthrough vritto_find

List saved links (and the user's lists). Use for 'what did I save?', 'my unread articles', 'links from Alex', 'links tagged X', 'what's in my <list>', and to resolve link/list IDs before any write. Filter by status, list, tag, type, favorite, sharedByPersonId, or a text query, prefer a filter over listing everything. Rows are compact summaries (id, title, domain, status, tags, createdAt, tldrPreview); use links_getLink when the user needs a link's url, notes, description, or full TL;DR. By default returns active (non-archived) links.

Field	Type	Description
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 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).

links_saveLinkCreatethrough vritto_create

Save a URL to the link store. Pass the url; the server unfurls title, description, site, image, favicon, type, and read-time. Optionally set title, tags, a listId, who shared it (sharedByPersonId from people_listPeople, or sharedByName), sharedContext, a reminder (remindOn, YYYY-MM-DD), status, or a note. Saving a URL that already exists updates it instead of duplicating.

Field	Type	Description
url*	string	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 people_listPeople).
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).

Example input

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

links_addToListUpdatethrough vritto_update

Add a saved link to a list, or remove it with remove: true. Resolve both the linkId and listId with links_listLinks first (create the list with links_createList if it doesn't exist).

Field	Type	Description
linkId*	string	Link ID from a prior links_listLinks result, never invented.
listId*	string	List ID from a prior links_listLinks result, never invented.
remove	boolean	Remove the link from the list instead of adding it.

links_setLinkStatusUpdatethrough vritto_update

Quick change of a link's reading status and/or favorite flag without sending the whole record, e.g. mark read, archive, or star. Resolve the ID with links_listLinks first.

Field	Type	Description
linkId*	string	Link ID from a prior links_listLinks result, never invented.
status	one of unread, reading, read, archived	New reading status.
favorite	boolean	Star / unstar the link.

Example input

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

links_setReminderUpdatethrough vritto_update

Set or clear a 'read this' reminder on a saved link. The reminder appears in the user's notifications on the given date. Pass remindOn to set it, or null to clear. Resolve the ID with links_listLinks first.

Field	Type	Description
linkId*	string	Link ID from a prior links_listLinks result, never invented.
remindOn*	string	Date to be reminded (YYYY-MM-DD), or null to clear.

links_updateLinkUpdatethrough vritto_update

Update fields on an existing saved link (title, description, type, status, favorite, tags, listIds, sharedByPersonId, sharedContext, notes). Sent fields merge over the record. Resolve the id with links_listLinks first.

Field	Type	Description
record*	object	Link fields to change; id required.
record.id*	string	Existing link ID to update, from a prior links_listLinks result.
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_listPeople) 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.

links_deleteLinkDeletethrough vritto_delete

Delete (archive) one saved link. Only for explicit removal requests. Resolve the ID with links_listLinks first.

Field	Type	Description
linkId*	string	Link ID from a prior links_listLinks result, never invented.

Link List`link_list`

A collection that organizes saved links.

links_createListCreatethrough vritto_create

Create a new list (collection) to organize links into. Returns the list with its id.

Field	Type	Description
name*	string	List name, e.g. 'Recipes to try'.
description	string	Optional description.
color	string	Optional accent color (hex).

Example input

{
  "name": "Recipes to try"
}

links_updateListUpdatethrough vritto_update

Update an existing list's name, description, or color, e.g. 'rename my Recipes list'. Only sent fields change. Resolve the listId with links_listLinks first.

Field	Type	Description
listId*	string	List ID from a prior links_listLinks result, never invented.
name	string	New list name.
description	string	New description.
color	string	New accent color (hex).

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

Link Listlink_list

Kept in the Vritto app

Saved Link`link`

Link List`link_list`