Short.io icon

Short.io

Short.io Node for shortening and managing links

Actions8

Links → Update Existing Link

AI-generated

Overview

This node operation updates an existing short link in the Short.io service. It allows users to modify the long URL associated with a short link and update various optional fields such as the link's path, folder placement, expiration settings, device-specific URLs, cloaking, redirect type, password protection, UTM parameters, and tags. This operation is useful for managing and maintaining short links dynamically, for example, updating a destination URL or changing link metadata without creating a new short link.

Use Case Examples

  1. Updating the destination URL of a short link when the original content moves to a new address.
  2. Changing the expiration date or adding password protection to an existing short link for security purposes.
  3. Modifying UTM parameters to track marketing campaigns more effectively.

Properties

Name Meaning
Existing Short Link Identifier Identifier for the short link to update, either by path or ID.
New Long URL The new destination URL that the short link will redirect to.
Additional Fields Optional fields to update additional properties of the short link such as path, folder, duplicates allowance, title, expiration, device-specific URLs, cloaking, redirect type, password, deletion time, UTM parameters, and tags.

Output

JSON

  • id - The unique identifier of the updated short link.
  • originalURL - The updated long URL the short link redirects to.
  • path - The path segment of the short link.
  • folderId - The folder ID where the link is placed.
  • allowDuplicates - Indicates if duplicates are allowed for the original URL.
  • title - The title of the link shown in the admin panel.
  • expiresAt - Expiration timestamp of the link in Unix milliseconds.
  • expiredURL - URL to redirect to when the link is expired.
  • iphoneURL - Redirect URL for iPhone users.
  • androidURL - Redirect URL for Android users.
  • cloaking - Indicates if the link is cloaked.
  • redirectType
    • type - HTTP redirect status code type.
  • password - Password protection for the link (hashed).
  • ttl - Timestamp when the link will be deleted.
  • utmSource - UTM source parameter for tracking.
  • utmMedium - UTM medium parameter for tracking.
  • utmCampaign - UTM campaign parameter for tracking.
  • utmTerm - UTM term parameter for tracking.
  • utmContent - UTM content parameter for tracking.
  • tags - Tags associated with the link.

Dependencies

  • Short.io API key credential

Troubleshooting

  • Ensure the short link identifier (path or ID) is correct and exists in your Short.io account to avoid 'link not found' errors.
  • Verify that the new long URL is a valid URL format to prevent validation errors.
  • Check that any Unix millisecond timestamps for expiration or deletion are valid and logically consistent (e.g., deletion time not earlier than one week from now).
  • Password protection requires a Personal plan on Short.io; using this feature without the correct plan may cause errors.

Links

Discussion