L2s connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 L2s actions, such as "Get URL Details", "Get User Settings" and "List Shortened URLs". 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 L2s, with input parameters and output schema.
L2S_GET_URL_DETAILSTool to retrieve details of a shortened URL. Use when you need metadata about a specific shortened link. Use after obtaining a valid URL ID.
Input parameters
Unique identifier of the shortened URL
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
L2S_L2_S_GET_USER_SETTINGSTool to retrieve current user's settings. Use after authentication to fetch email, notification, and appearance preferences.
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
L2S_L2_S_LIST_URLSTool to list all shortened URLs. Use after user authentication to retrieve the user's URLs with pagination details.
Input parameters
Page number to retrieve (1-based). Defaults to the first page if not specified.
Number of results per page. Defaults to the API's default page size if not specified.
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
L2S_L2_S_SHORTEN_URLTool to shorten a given long URL. Use when you need a concise link representation.
Input parameters
The long URL to be shortened.
Tags associated with the shortened URL.
Title for the shortened URL.
UTM term parameter.
Custom alias for the shortened URL.
UTM medium parameter.
UTM source parameter.
UTM content parameter.
UTM campaign parameter.
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 L2s actions on Nagent, including "Get URL Details", "Get User Settings" and "List Shortened URLs". Get URL Details: Retrieve details of a shortened URL. Each action is listed on this page with its input parameters and its output.
L2s 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.
Get URL Details takes 1 required input: id. It returns data, error and successful.