Link Expiration & Discrete Snap-Points
Learn how Shortyy manages link lifecycles, TTL calculations, and plan-specific expiration limits.
Link Expiration & Discrete Snap-Points
Shortyy supports granular, plan-aware link expiration. When a link expires, it automatically stops redirecting visitors and enters the tombstone registry.
Supported Durations
When calling POST /v1/links, you can specify either the expires_in relative duration string or an absolute ISO-8601 expires_at timestamp:
| Duration String | Equivalent Seconds | Typical Use Case |
|---|---|---|
30m | 1,800 sec | Temporary OTP login links, short-lived verification codes |
1h | 3,600 sec | Customer support sessions, temporary download links |
1d | 86,400 sec | Daily marketing newsletters, ephemeral webinars |
7d | 604,800 sec | Weekly promotional campaigns, invoice links |
1mo | 2,592,000 sec | Monthly release notes, subscription renewals |
6mo | 15,552,000 sec | Semi-annual documentation versions |
100y (Permanent) | 3,153,600,000 sec | Permanent redirects, canonical documentation |
Plan Expiration Ceilings
The authenticated user's tier strictly determines the maximum allowable link lifetime:
▪
Free Tier: Maximum link lifetime is 3 hours (
10800s). Requests specifying longer durations are automatically clamped or rejected.▪
Basic Tier: Maximum link lifetime is 30 days.
▪
Pro Tier: Support for up to 100 years (virtually permanent links).