NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Customjs connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Customjs actions, such as "Authenticate CustomJS API Key", "Convert HTML to PDF" and "Convert HTML to PNG". 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 Customjs, with input parameters and output schema.
CUSTOMJS_AUTHENTICATE_API_KEYAuthenticate and validate a CustomJS API key. Returns workspace details, request limits, and decoded JWT token information including user email. Use this to verify an API key is valid before making other CustomJS API calls.
Input parameters
The CustomJS API key to verify. Obtain from the CustomJS dashboard.
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
CUSTOMJS_CONVERT_HTML_TO_PDFConvert HTML content to a PDF document. Use this tool to generate PDF files from raw HTML markup. Supports: - Complete HTML documents or fragments - Inline CSS styling (colors, fonts, tables, borders, backgrounds) - Unicode characters and special symbols - Multi-page documents Returns raw PDF bytes suitable for file storage or download.
Input parameters
JavaScript code snippet to process the HTML conversion. Uses the built-in HTML2PDF utility. The default value handles standard HTML to PDF conversion - typically no changes needed.
The HTML content to convert to PDF. Can be a complete HTML document including <html>, <head>, and <body> tags, or just a fragment. Supports inline CSS styles for formatting.
Instructs the API to return binary PDF data. Must be 'true' for PDF output.
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
CUSTOMJS_CONVERT_HTML_TO_PNGTool to convert HTML string to PNG image. Use when you need a PNG from HTML after preparing your markup.
Input parameters
HTML content to convert into a PNG image
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
CUSTOMJS_MERGE_PDFSMerge multiple PDF files from URLs into a single PDF document. Use this tool when you need to combine two or more PDF documents into one. The PDFs are merged in the order provided. All input URLs must be publicly accessible. Returns a downloadable merged PDF file.
Input parameters
List of publicly accessible HTTP/HTTPS URLs pointing to the PDF files to merge. The PDFs will be merged in the order provided. Minimum 2 URLs required.
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
CUSTOMJS_RUN_PUPPETEER_SCRIPTExecute a Puppeteer script in a headless browser and capture a screenshot. Use this tool for browser automation tasks such as navigating to URLs, interacting with page elements, extracting data, or capturing visual snapshots of web pages. The script runs in a sandboxed Puppeteer environment with access to a 'page' object.
Input parameters
JavaScript wrapper code that invokes the PUPPETEER utility. In most cases, use the default value. Only modify if you need a different execution pattern.
Puppeteer script to execute in a headless browser. The script has access to a 'page' object (a Puppeteer Page instance). Common operations include: page.goto(url), page.waitForSelector(selector), page.click(selector), page.type(selector, text), page.screenshot(), and page.evaluate(). The script runs asynchronously, so use 'await' for async operations.
Whether to return a screenshot of the final page state as PNG image data. Set to true (default) to capture and return the screenshot.
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 Customjs actions on Nagent, including "Authenticate CustomJS API Key", "Convert HTML to PDF" and "Convert HTML to PNG". Authenticate CustomJS API Key: Authenticate and validate a CustomJS API key. Each action is listed on this page with its input parameters and its output.
Customjs 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.
Authenticate CustomJS API Key takes 1 required input: api_key. It returns data, error and successful.