Discuss KitInstall

Overview

This node integrates with the Discuss Kit API to manage various discussion-related resources, including bookmarks. Specifically, the Bookmark Create operation allows users to add a new bookmark by providing its URL. The node fetches Open Graph metadata for the URL to enrich the bookmark's details automatically.

Common scenarios where this node is useful include:

• Automatically saving and organizing web links as bookmarks within a discussion or knowledge management system.
• Enriching bookmarks with metadata like title, description, and cover image without manual input.
• Integrating bookmark creation into automated workflows, such as capturing URLs from emails or chat messages.

Example: A user wants to save interesting articles shared in a team chat directly into their Discuss Kit workspace as bookmarks, complete with preview information.

Properties

Output

The node outputs JSON data representing the created bookmark object. This includes:

• id: Unique identifier of the bookmark.
• title: Title extracted from the URL's Open Graph or Twitter metadata.
• excerpt: Description or summary from the metadata.
• cover: URL of an image associated with the bookmark.
• originLink: The original URL provided.
• type: Always "bookmark" for this resource.
• Other metadata fields returned by the Discuss Kit API.

No binary data output is produced by this operation.

Dependencies

• Requires access to the Discuss Kit API endpoint.
• Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
• Uses an internal helper function to request Open Graph metadata from the given URL before creating the bookmark.

Troubleshooting

• Error: Invalid or missing URL
  Ensure the URL property is provided and correctly formatted. The node requires a valid URL to fetch metadata.

• Error: API authentication failed
  Verify that the API key credential is properly set up and has permissions to create bookmarks.

• Timeout or failure fetching Open Graph data
  The node attempts to retrieve metadata with a timeout of 60 seconds. Network issues or invalid URLs may cause failures. Check URL accessibility.

• Unexpected API errors
  Review the error message returned by the API. Common causes include invalid board IDs or insufficient permissions.

Links and References

• Discuss Kit Official Documentation (for API details)
• Open Graph Protocol (metadata standard used for enriching bookmarks)