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.
Endpoint
client.bookmark.delete(input)
server/procedures/bookmarks.ts:121
Authentication
This endpoint requires authentication. See Authentication for details.
Request
ID of the bookmark to delete
Input Schema
Defined in lib/schema.ts:122.
Response
Returns a success confirmation object.
Always true when the deletion completes successfully
Examples
Using React Query Mutation
import { orpc } from '@/lib/orpc';
function DeleteBookmarkButton({ bookmarkId }: { bookmarkId: string }) {
const deleteMutation = orpc.bookmark.delete.useMutation();
const handleDelete = async () => {
await deleteMutation.mutateAsync({ id: bookmarkId });
console.log('Bookmark deleted successfully');
};
return (
<button
onClick={handleDelete}
disabled={deleteMutation.isPending}
>
{deleteMutation.isPending ? 'Deleting...' : 'Delete'}
</button>
);
}
Using Direct Client Call
import { client } from '@/lib/orpc';
const result = await client.bookmark.delete({
id: 'clx123456',
});
if (result.success) {
console.log('Bookmark deleted');
}
Server-Side Deletion
import { serverClient } from '@/lib/orpc.server';
async function deleteBookmark(bookmarkId: string) {
const result = await serverClient.bookmark.delete({
id: bookmarkId,
});
return result.success;
}
With Optimistic Updates
import { orpc } from '@/lib/orpc';
import { useQueryClient } from '@tanstack/react-query';
function BookmarkList() {
const queryClient = useQueryClient();
const { data: bookmarks } = orpc.bookmark.list.useQuery({});
const deleteMutation = orpc.bookmark.delete.useMutation({
onMutate: async (variables) => {
// Cancel outgoing refetches
await queryClient.cancelQueries({
queryKey: orpc.bookmark.list.getQueryKey({}),
});
// Snapshot previous value
const previous = queryClient.getQueryData(
orpc.bookmark.list.getQueryKey({})
);
// Optimistically remove bookmark
queryClient.setQueryData(
orpc.bookmark.list.getQueryKey({}),
(old: any[]) => old.filter(b => b.id !== variables.id)
);
return { previous };
},
onError: (err, variables, context) => {
// Rollback on error
if (context?.previous) {
queryClient.setQueryData(
orpc.bookmark.list.getQueryKey({}),
context.previous
);
}
},
});
return (
<div>
{bookmarks?.map(bookmark => (
<div key={bookmark.id}>
{bookmark.title}
<button onClick={() => deleteMutation.mutate({ id: bookmark.id })}>
Delete
</button>
</div>
))}
</div>
);
}
Implementation
From server/procedures/bookmarks.ts:121:
export const deleteBookmark = authed
.input(deleteByIdSchema)
.handler(async ({ context, input }) => {
await db.bookmark.deleteMany({
where: { id: input.id, userId: context.user.id },
});
return { success: true };
});
Behavior
Safe Deletion
The deletion is scoped to the authenticated user:
where: { id: input.id, userId: context.user.id }
Idempotent Operation
The endpoint uses deleteMany instead of delete, which means:
- If the bookmark doesn’t exist, the operation succeeds silently
- No error is thrown for non-existent IDs
- Always returns
{ success: true }
This makes the operation idempotent - calling it multiple times with the same ID has the same effect as calling it once.
No Cascade Information
The response only confirms the deletion was processed. It doesn’t include:
- Number of records deleted
- Whether the bookmark existed
- Related data that was deleted
If you need to verify the bookmark existed before deletion, query it first.
Errors
User is not authenticated.
Related Endpoints
Notes
- Deletion is permanent and cannot be undone
- The bookmark is immediately removed from the database
- Related data (metadata, etc.) is handled according to database cascade rules
- For deleting multiple bookmarks, use the bulk delete endpoint for better performance
