shortio_skill

Overview

This skill provides direct curl-based access to the Short.io URL shortener API so you can create, manage, and track branded short links from the command line. It focuses on pragmatic, repeatable curl patterns for creating links, customizing slugs, setting expirations, retrieving link info, listing domains, and fetching click stats. Use environment variables for your API key and domain to keep commands simple and scriptable.

How this skill works

The skill issues HTTP requests to https://api.short.io using curl with the Authorization header set to your Secret API Key. It supports creating links (with optional custom path, TTL, password, tags), expanding links by path or ID, updating or deleting links by idString, listing links/domains, and retrieving click statistics. All examples assume SHORTIO_API_KEY and SHORTIO_DOMAIN (and optionally SHORTIO_DOMAIN_ID) are exported in your shell.

When to use it

• Create concise branded links for marketing, emails, or social posts
• Generate custom slugs for campaigns or easy-to-remember URLs
• Create temporary links with TTL for promotions or limited-time content
• Bulk-manage links: list, update, or delete using scriptable curl calls
• Collect click statistics for measuring engagement and reporting

Best practices

• Store and reuse the returned idString for updates and deletes
• Set allowDuplicates:false to avoid creating duplicate short links for the same destination
• Use TTL for time-limited campaigns and set expiresAt to handle expired redirects
• Keep API key in an environment variable and never hard-code it into scripts
• Respect rate limits: implement retries with exponential backoff and paginate when listing >150 links

Example use cases

• Create a short link with an auto-generated slug and capture shortURL and idString for later use
• Create a campaign link with a custom path (path field) and tags for analytics grouping
• Issue a TTL-protected short link for a flash sale that auto-expires at a specified ISO 8601 timestamp
• Query link clicks for a given link ID to feed into reporting or a dashboard
• List all domains on the account to verify DNS and branded domain setup before creating links