Create smart bookmark
POST /api/browser/bookmark
Create locally analyzed bookmark with automatic tagging, summarization, and suggestions.
Creates intelligent bookmark with generated tags, one-sentence summary, and usage suggestions for project integration. Stores bookmark in ChromaDB for semantic searchability and retrieval. Supports both manual and analyzed bookmark creation.
Request Body:
url: URL to bookmark (required)title: Page titlecontent: Page content for local analysisproject: Project context for organization (default: “general”)tags: User-defined tags for categorizationai_analysis: Enable local tagging and analysis (default: true)
Returns:
- BookmarkResponse containing:
bookmark_id: Unique identifier for the created bookmarkai_tags: Generated tags for categorization (5-7 tags)ai_summary: Generated one-sentence summarysuggestions: Generated usage suggestions for project
Raises:
HTTPException 500: For unexpected errors during bookmark creation
Local Analysis (when enabled):
- Generates 5-7 relevant tags for categorization
- Creates concise one-sentence summary
- Suggests how content could be used in project
- Analyzes content for context and relevance
ChromaDB Storage:
- Stored in “ishvana_bookmarks” collection
- Searchable by content, tags, title, and summary
- Queryable by project and tag filters
Example Request:
{
"url": "https://example.com/vector-db-intro",
"title": "Introduction to Vector Databases",
"content": "Vector databases enable semantic search...",
"project": "research",
"tags": ["database", "reference"],
"ai_analysis": true
}Example Response:
{
"bookmark_id": "bookmark_1702905000",
"ai_tags": ["vector-database", "semantic-search", "embeddings"],
"ai_summary": "Guide to vector databases and semantic search.",
"suggestions": [
"Reference for database selection in research projects",
"Include in technical documentation",
"Consider for research paper citations"
]
}Request Body required
Section titled “Request Body required ”Request model for creating locally analyzed smart bookmarks.
Used for creating intelligent bookmarks with automatic local tagging, summarization, and project relevance analysis for efficient knowledge management.
Fields:
url: The URL to bookmarktitle: The page titlecontent: The page content for analysiscategory: Bookmark category for organizationdescription: User-provided description or notesproject: Project context for organizationtags: User-defined tags for categorizationai_analysis: Whether to perform local analysis
Categories:
research: Research papers and academic contentreference: Documentation and reference materialsdocumentation: Technical documentation and guidesinspiration: Creative and inspirational contentother: Uncategorized bookmarks
Local Analysis Features (when enabled):
- Automatic tag generation based on content
- Extractive summarization
- Entity recognition
- Project relevance scoring
- Reading time estimation
- Content classification
Usage: POST /api/browser/bookmark for creating smart bookmarks.
JSON Example:
{
"url": "https://example.com/typescript-guide",
"title": "TypeScript Best Practices",
"content": "TypeScript is a typed superset...",
"category": "documentation",
"description": "Comprehensive guide to TypeScript best practices",
"project": "ishvana_docs",
"tags": ["typescript", "reference"],
"aiAnalysis": true
}Integration:
- Bookmark Service: Creates and stores bookmarks
- Local analysis: Generates tags and summary if enabled
- ChromaDB: Indexes bookmark content for semantic search
- Frontend: Displays bookmarks with generated research metadata
object
URL to bookmark
Page title
Page content
Bookmark category
User-provided description or notes
Project context
User-defined tags
Whether to perform local analysis
Responses
Section titled “ Responses ”Successful Response
Response model for bookmark creation results - COMPLETE BOOKMARK DATA.
Contains the complete bookmark including all user-provided data, generated tags, summary, and usage suggestions for knowledge organization. This is the SINGLE SOURCE OF TRUTH for bookmark structure - frontend consumes this schema.
Fields:
bookmark_id: Unique identifier for the bookmarkurl: Bookmarked URLtitle: Page titlecontent: Page contentcategory: Bookmark category (research/reference/documentation/inspiration/other)description: User-provided description or notesproject: Project contextuser_tags: User-defined tagsai_tags: Generated tags for categorizationai_summary: Generated summary of the contentsuggestions: Generated suggestions for usagecreated_at: ISO 8601 timestamp of bookmark creation
Research Tags: Generated based on content analysis, typically 3-7 tags capturing:
- Primary topics
- Technologies mentioned
- Content type (tutorial, reference, etc.)
- Difficulty level
Research Summary: 2-3 sentence summary of bookmark content and utility.
Suggestions: Actionable recommendations like:
- “Use for React performance optimization reference”
- “Apply patterns to Ishvana frontend components”
- “Share with team for TypeScript best practices”
Usage: Returned from POST /api/browser/bookmark endpoint.
JSON Example:
{
"bookmarkId": "bm_abc123",
"url": "https://example.com/typescript-guide",
"title": "TypeScript Best Practices",
"content": "TypeScript is a typed superset...",
"category": "documentation",
"description": "Comprehensive guide to TypeScript best practices",
"project": "ishvana_docs",
"userTags": ["typescript", "reference"],
"aiTags": ["typescript", "best-practices", "type-safety", "tutorial"],
"aiSummary": "Comprehensive guide to TypeScript best practices focusing on "
"type safety and modern patterns",
"suggestions": [
"Apply type narrowing patterns to Ishvana codebase",
"Use as reference for strict TypeScript configuration",
"Share with development team"
],
"createdAt": "2024-12-20T10:30:00Z"
}object
Unique bookmark identifier
Bookmarked URL
Page title
Page content
Bookmark category
User-provided description or notes
Project context
User-defined tags
Generated tags
Usage suggestions
ISO 8601 bookmark creation timestamp
Validation Error