Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ephraimduncan/minimal.so/llms.txt
Use this file to discover all available pages before exploring further.
Update the visibility of multiple bookmarks in a single operation. Useful for batch privacy updates or when preparing bookmarks for public sharing.
Endpoint
bookmark.bulkSetVisibility
server/procedures/bookmarks.ts:186
Input
Array of bookmark IDs to update (minimum 1)
Visibility setting to apply to all bookmarks:
true - Make all bookmarks publicfalse - Make all bookmarks privatenull - All bookmarks inherit visibility from their parent groups
Response
The number of bookmarks successfully updated
Behavior
- Only bookmarks owned by the authenticated user are updated
- Bookmarks not owned by the user are silently skipped (no error)
- The operation returns the total count of successfully updated bookmarks
- All updates are atomic within a single database transaction
Usage examples
React Query (client component)
'use client';
import { client } from '@/lib/orpc';
import { useSelectedBookmarks } from '@/hooks/use-selection';
function BulkVisibilityControls() {
const selectedIds = useSelectedBookmarks();
const { mutate, isPending } = client.bookmark.bulkSetVisibility.useMutation();
const handleMakeAllPublic = () => {
mutate({
ids: selectedIds,
isPublic: true,
});
};
const handleMakeAllPrivate = () => {
mutate({
ids: selectedIds,
isPublic: false,
});
};
return (
<div>
<button onClick={handleMakeAllPublic} disabled={isPending}>
Make selected public
</button>
<button onClick={handleMakeAllPrivate} disabled={isPending}>
Make selected private
</button>
</div>
);
}
Server component
import { serverClient } from '@/lib/orpc.server';
async function makeGroupBookmarksPublic(groupId: string) {
// First, get all bookmarks in the group
const bookmarks = await serverClient.bookmark.list({ groupId });
const bookmarkIds = bookmarks.map(b => b.id);
// Then bulk update visibility
const result = await serverClient.bookmark.bulkSetVisibility({
ids: bookmarkIds,
isPublic: true,
});
console.log(`Updated ${result.count} bookmarks to public`);
return result;
}
Direct client with error handling
import { client } from '@/lib/orpc';
try {
const result = await client.bookmark.bulkSetVisibility.mutate({
ids: ['bookmark_1', 'bookmark_2', 'bookmark_3'],
isPublic: false,
});
console.log(`Successfully made ${result.count} bookmarks private`);
} catch (error) {
console.error('Failed to update visibility:', error);
}
Use cases
Preparing for public profile
Make all bookmarks in a group public before enabling the group’s visibility:
const bookmarks = await client.bookmark.list.query({ groupId });
await client.bookmark.bulkSetVisibility.mutate({
ids: bookmarks.map(b => b.id),
isPublic: true,
});
Privacy cleanup
Quickly make all selected bookmarks private:
await client.bookmark.bulkSetVisibility.mutate({
ids: selectedBookmarkIds,
isPublic: false,
});
Reset to group defaults
Remove explicit visibility overrides and let bookmarks inherit from their groups:
await client.bookmark.bulkSetVisibility.mutate({
ids: bookmarkIds,
isPublic: null, // Inherit from parent groups
});
Related endpoints
