U301 connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 U301 actions: "List available domains for URL shortening", "Delete a shortened link" and "Shorten a long URL". 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 U301, with input parameters and output schema.
U301_DELETE_LINKTool to delete a shortened link by its link identifier. Use when you need to remove a shortened link from the system.
Input parameters
The shortened link identifier to delete. Format: domain/code (e.g., 'u301.co/tA82')
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
U301_LIST_SHORTEN_DOMAINSTool to list available domains for URL shortening, including public domains and custom domains. Use when you need to see what domains are available for creating short links. Supports pagination and filtering by visibility type.
Input parameters
Current page number
Results per page, range: 1-500
Enum for domain visibility types.
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
U301_SHORTEN_LINKTool to shorten a long URL into a compact short link. Use after obtaining the long URL when you need a shareable link.
Input parameters
The long URL to be shortened. Must start with a valid schema (http:// or https://)
Custom alias for the short link. Must be unique and only contain letters, numbers, underscores (_), and hyphens (-)
The title of the link
Domain to use for the short URL. You can list available domains using the list domains endpoint
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 3 U301 actions on Nagent: "List available domains for URL shortening", "Delete a shortened link" and "Shorten a long URL". List available domains for URL shortening: List available domains for URL shortening, including public domains and custom domains. Each action is listed on this page with its input parameters and its output.
U301 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.
It also takes 3 optional inputs: page, per_page and visibility. It returns data, error and successful.