Tinyurl connects to a Nagent workspace with an API key. Once it is connected, agents can call 2 Tinyurl actions: "Create short url" and "List TinyURLs". 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 Tinyurl, with input parameters and output schema.
TINYURL_CREATE_SHORT_URLCreates a shortened URL using TinyURL's API. This action takes a long URL and returns a shortened version, with optional parameters for customization like domain, alias, tags, and expiration date.
Input parameters
The long URL that needs to be shortened. Must be a valid URL starting with http:// or https://. Do NOT pass HTML content, placeholder strings like '{url}', or any non-URL text. The value must be the actual URL to shorten.
Tags to associate with the URL (optional)
Custom alias for the shortened URL (optional) Must be unique per domain; if already taken, choose a different alias or change the `domain` parameter.
The domain to use for the shortened URL (optional)
Expiration date for the URL in ISO 8601 format (optional)
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
TINYURL_LIST_URLSTool to retrieve a list of TinyURLs from your account. Use when you need to view available or archived shortened URLs. Supports pagination and filtering by URL type (available or archived).
Input parameters
Page number for pagination. Must be greater than or equal to 1.
The type of TinyURLs to retrieve. Use 'available' for active URLs or 'archived' for archived URLs.
Number of results per page. Must be between 1 and 100.
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 2 Tinyurl actions on Nagent: "Create short url" and "List TinyURLs". Create short url: Creates a shortened URL using TinyURL's API. Each action is listed on this page with its input parameters and its output.
Tinyurl 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 short url takes 1 required input: url. It also takes 4 optional inputs: tags, alias, domain and expires_at. It returns data, error and successful.