Shorten.REST is a link shortening and management app that allows you to generate unique, branded URLs with advanced tracking capabilities.
Shorten.REST is a link shortening and management app that allows you to generate unique, branded URLs with advanced tracking capabilities. On Nagent, Shorten.REST is exposed as a fully-configurable url shortener integration that any agent can call — 6 actions, and API key authentication. No code is required to wire Shorten.REST into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Shorten.REST to automate the kinds of tasks url shortener teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Shorten.REST into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Shorten.REST, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SHORTEN_REST_CREATE_ALIASTool to create a new alias (short URL) under a specified domain. Use when you need to shorten a URL. If no domain is specified, the alias will be attached to the default domain Short.fyi. You can override domain-level Meta Tags and Tracking Snippets by specifying them for each URL.
Input parameters
List of metatags for the alias. Use to override domain-level meta tags
List of tracking snippets for the alias. Use to override domain-level tracking snippets
Alias name (without `/` at the beginning). If not specified, a random alias will be generated
Domain which alias will belong to (string without `http/https` or `/`). If not specified, defaults to 'short.fyi'
List of destination URLs with optional geo-targeting. At least one destination is 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
SHORTEN_REST_DELETE_ALIASTool to delete a single alias by providing alias and domain. Use when you need to remove an existing shortened URL. If no domain is provided, the API searches for the matching alias within the Short.fyi domain.
Input parameters
Alias to delete (without `/` at the beginning). This is the short code identifier for the URL.
Domain which alias belongs to (string without `http/https` or `/`). If not provided, defaults to short.fyi.
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
SHORTEN_REST_GET_ALIASESTool to retrieve all URL aliases of the authenticated user. Use when you need to list existing aliases (supports pagination).
Input parameters
Maximum number of aliases to return per page (must be ≥ 1)
Cursor token for pagination to fetch the next set of aliases
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
SHORTEN_REST_GET_CLICKSTool to retrieve click data for shortened URLs. Use to check click analytics for your aliases. Returns a list of click records which may be empty if no clicks have occurred yet. Returned records may represent a limited window or subset of historical clicks rather than complete per-click logs.
Input parameters
The alias (short code) to retrieve click information for. If not provided, returns clicks for all aliases.
Maximum number of click records to return (must be >= 1)
Cursor token for pagination to fetch the next set of clicks
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
SHORTEN_REST_LIST_ALIASES_BY_DOMAINTool to retrieve all alias names associated with your account and a given domain. Results are in descending order by creation date. Use when you need to list alias names (not full details) for a specific domain with pagination support.
Input parameters
Number of results to return per request (must be >= 1). Defaults to 1000 if not specified.
The domain name to get the aliases for (string without `http/https` or `/`). If not provided, defaults to 'short.fyi'.
An ID returned by a previous query to continue aliases retrieval (see last_id in response). Used for pagination.
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
SHORTEN_REST_UPDATE_ALIASTool to update an existing short URL alias by providing its alias name and domain. Use when you need to modify destinations, metatags, or snippets for an existing alias. IMPORTANT: When updating array properties (like destinations), the entire array is replaced, so you must include all existing records you want to keep.
Input parameters
List of metatags to update. IMPORTANT: When updating array properties, the entire block is replaced, so include all old records you want to keep.
List of snippets to update. IMPORTANT: When updating array properties, the entire block is replaced, so include all old records you want to keep.
The alias name to update (without leading slash, e.g., 'aBcDe012')
Domain which the alias belongs to (without http/https or trailing slash). Defaults to 'short.fyi'.
List of destination URLs to update. IMPORTANT: When updating array properties, the entire block is replaced, so include all old records you want to keep to avoid deleting them.
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
No publicly available marketplace agent is found using this tool yet. There are 92 agents privately built on Nagent that already use Shorten.REST.
Build on Nagent
Connect Shorten.REST to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Shorten.REST, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Shorten.REST is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Shorten.REST is connected, you configure its 6 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Shorten.REST steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Shorten.REST event fires, the agent kicks off automatically.
Every Shorten.REST action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Shorten.REST ships with 6 pre-built url shortener actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Shorten.REST together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Shorten.REST-based workflows tailored to your business.