Omphalis

List the Library items grouped within a specified Collection.

Create a new, empty Collection. Use library_organize with the returned id to file items into it.

List your Collections (your groupings of Library items).

List the Connections that link a specified Library item to other items.

List your Connections across the Library, most recently created first.

Get a single Library item, including its readable content. Long items are returned in windows: the response includes content_total_length and content_truncated so you can tell whether more of the body remains beyond what was returned.

List your Library items, newest first by default. Narrow with content_type, tag, space_id, or collection_id. Use sort_by='longest' or 'shortest' to answer questions like 'what's the longest item in my library' in one call instead of paging through everything. Use offset to page past the first page.

Organize a Library item: add or remove tags, file it in a Collection or a Space, or star it. Everything this does can be undone.

Save something to your Library. Pass 'url' to save a link (article, PDF, YouTube video, podcast, and more), or pass 'text' to save a note you or the person you are helping wrote. Exactly one of the two. Returns the new item's id right away with status 'processing' (a link's readable content is extracted in the background, so fetch it with library_get a little later), or 'duplicate' with the existing item's id if that link or that note was already saved.

Attach a personal note to an existing Mark — a system annotation or your own highlight. Use this to record your own thinking on a Mark (e.g. 'this argument seems weak') so it's saved in your Library, not just said in chat. Calling this again on the same Mark replaces its existing note rather than appending to it.