NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Linkhut connects to a Nagent workspace with OAuth sign-in. Once it is connected, agents can call 5 Linkhut actions, such as "Add bookmark", "Get all tags" and "Get bookmarks". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Linkhut, with input parameters and output schema.
LINKHUT_ADD_BOOKMARKAdds a new bookmark to LinkHut. The bookmark can be marked as private/public and read/unread, with optional tags and notes.
Input parameters
The URL of the webpage to bookmark
Comma-separated list of tags for the bookmark
Whether the bookmark should be public (true) or private (false)
Whether to mark the bookmark as unread
Additional notes or description for the bookmark
The title or description of the bookmark
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LINKHUT_DELETE_BOOKMARKThis tool allows users to delete a bookmark from their Linkhut account by providing the bookmark URL. It operates independently and only requires the URL parameter to identify and remove the bookmark.
Input parameters
The URL of the bookmark to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LINKHUT_GET_ALL_TAGSRetrieves a list of all tags and their usage counts for the authenticated user. No additional parameters required besides authentication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LINKHUT_GET_BOOKMARKSRetrieves bookmarks from the user's Linkhut account with optional filtering. This tool fetches bookmarks from Linkhut and supports filtering by: - Tag: Filter by one or more tags (space-separated) - Date: Filter by a specific date (ISO8601 format) - URL: Get a specific bookmark by its exact URL - Meta: Request additional metadata about bookmarks Returns a list of bookmarks with details including URL, title/description, tags, extended notes, timestamp, privacy status (shared), and read status (toread).
Input parameters
Filter by date in ISO8601 format (CCYY-MM-DDThh:mm:ssZ). Returns bookmarks saved on this specific date. If not specified, returns bookmarks from the most recent date
Filter bookmarks by tag. You can filter by multiple tags by separating them with spaces (e.g., 'tech learning')
Filter by a specific URL. Returns the bookmark for this exact URL if it exists
Include additional metadata in the response. Set to 'yes' to request metadata
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LINKHUT_UPDATE_BOOKMARKThis tool allows users to update an existing bookmark in LinkHut. The tool updates the metadata of a bookmark including its title, description, and tags.
Input parameters
The URL of the bookmark to update
Comma-separated list of tags for the bookmark
Whether the bookmark should be public (true) or private (false)
Whether to mark the bookmark as unread
Additional notes or description for the bookmark
The new title or description of the bookmark
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Linkhut actions on Nagent, including "Add bookmark", "Get all tags" and "Get bookmarks". Add bookmark: Adds a new bookmark to LinkHut. Each action is listed on this page with its input parameters and its output.
Linkhut connects with OAuth sign-in, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add bookmark takes 2 required inputs: url and description. It also takes 4 optional inputs: tags, shared, toread and extended. It returns data, error and successful.