NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Linkup connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Linkup actions, such as "Create Response", "Get Credits Balance" and "Search Linkup". 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 Linkup, with input parameters and output schema.
LINKUP_CREATE_RESPONSEProxy endpoint for OpenAI-compatible response generation. Used when the OpenAI client's base URL is set to Linkup. Supports 'linkup-standard' for faster results and 'linkup-deep' for more comprehensive results.
Input parameters
Optional custom text format configuration.
The natural language question for which you want to retrieve context. Must be a plain string, not an object or array.
The model used to generate the response. 'linkup-standard' returns results faster; 'linkup-deep' takes longer but yields more comprehensive results.
Optional instructions to guide the response generation. Similar to a system message.
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
LINKUP_FETCH_WEBPAGEFetch and retrieve a markdown representation of a webpage from a given URL. Supports optional JavaScript rendering for single-page applications, raw HTML extraction, and image extraction from the webpage content. Use this when you need to extract clean, structured content from web pages.
Input parameters
The URL of the webpage to fetch
Whether to render JavaScript on the webpage before fetching content. Set to true for single-page applications or dynamic content
Whether to extract images from the webpage and include them in the response
Whether to include the raw HTML of the webpage in the response
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
LINKUP_GET_CREDITS_BALANCETool to retrieve the current credits balance for your Linkup account. Returns the number of credits remaining that can be used for search and fetch operations.
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
LINKUP_SEARCHSearch the web and retrieve insights using Linkup's API. This action provides three output modes: natural language answers with sources (sourcedAnswer), raw search context (searchResults), or custom structured JSON (structured). Supports filtering by date range and domains, with optional image results. Standard depth uses 1 credit, deep search uses 10 credits. Only indexes publicly available web content; private repositories and internal endpoints return no results.
Input parameters
Level of search depth. 'standard' is faster and uses 1 credit, 'deep' is more comprehensive and uses 10 credits
The natural language question for which you want to retrieve context
Filter results up to this date in ISO 8601 format (YYYY-MM-DD)
Filter results from this date onwards in ISO 8601 format (YYYY-MM-DD)
Maximum number of results to return
Type of output: 'sourcedAnswer' provides a natural language answer with citations, 'searchResults' returns raw search context, 'structured' returns custom JSON format Response fields: `sourcedAnswer` returns `answer` (str) and `sources` (list); `searchResults` returns `results` array with `name`, `url`, `content` per item; `structured` returns schema-defined JSON.
Whether to include image results in the response
Exclude these domains from search results
Only search within these domains (up to 100 domains)
Adds sources to structured responses. Only applicable when output_type is 'structured'
Embeds citations directly within the answer text. Only applicable when output_type is 'sourcedAnswer'
JSON schema defining the custom response format. Required when output_type is 'structured'
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 4 Linkup actions on Nagent, including "Create Response", "Get Credits Balance" and "Search Linkup". Create Response: Proxy endpoint for OpenAI-compatible response generation. Each action is listed on this page with its input parameters and its output.
Linkup connects with an API key, 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.
Create Response takes 2 required inputs: input and model. It also takes 2 optional inputs: text and instructions. It returns data, error and successful.