Cluing

List Topics

List all topics accessible to the authenticated user. Returns topic metadata including id, name, description, and tenant.

Get Topic

Fetch a single topic by its ID, including all non-archived snippets and role information.

Create Summary

Create a SUMMARY snippet (the user's distilled write-up of a web page). Requires url + content. Content must be HTML, not Markdown.

Create Bookmark

Create a BOOKMARK snippet for a web page. Requires url + content. Content must be HTML, not Markdown.

Create Idea

Create an IDEA snippet — a free-form note that does not need a source URL. Requires content. Content must be HTML, not Markdown.

Create Topic

Create a new Topic in the user's workspace. Requires name. Optionally place inside an existing cluster.

Create Smart Document

Create a Smart Document — a full Markdown document readable in the Cluing reader and searchable by AI. Use for anything longer than a snippet: reports, drafts, guides, articles. Requires name + markdown.

List Workspace Users

List the people in the workspace who can be notified. Returns {userId, name, email, isSelf, availableChannels} per member. Call this before send_notification to resolve names to user ids — never guess a userId.

Send Notification

Send a notification to one or more workspace members over the in-app inbox, email and/or Slack. Optionally link a Cluing entity to make it clickable. Write title and message as plain prose with NO Markdown — none of these channels render it, so **bold**, headings, bullets, backticks and [text](url) arrive as literal characters; link the entity instead of writing a Markdown link. Returns a per-recipient, per-channel status — report anything that is not SENT instead of retrying.