Skip to content

link

snug link <COMMAND>

Link redirect & attribution management.

Subcommands

CommandWhat it does
campaignCampaign administration and sharing
accessGrant or revoke direct Link access
createCreate a link
batch-createCreate many links from a JSON file (array of link objects)
listList links
getGet link details
deleteDelete a link
updateUpdate a link
resolveResolve a link for redirect metadata
statsShow link stats
qrGenerate or rotate a QR code
passwordPassword operations
quarantineQuarantine a link
domainsList configured branded domains

Run snug link <command> --help for that command's own options. The global options apply everywhere.

Examples

snug link campaign create --name spring_launch --domain go.acme.example
snug link campaign list
snug link campaign get --campaign-id lcmp_123
snug link campaign stats --campaign-id lcmp_123
snug link create --campaign-id lcmp_123 --url https://app.acme.example/signup --vanity launch
snug link list --filter 'campaign_id[eq]=lcmp_123' --filter 'status[eq]=active'
snug link get --link-id lnk_123
snug link update --link-id lnk_123 --expires-at 2026-07-14T15:00:00Z
snug link delete --link-id lnk_123
snug link resolve --link-id lnk_123 --device-family ios --reputation neutral
snug link stats --link-id lnk_123
snug link qr --link-id lnk_123 --output ./launch-qr.png
snug link password verify --link-id lnk_123 --password hunter2
snug link quarantine --link-id lnk_123 --reason compromised_slug
snug link domains
snug link access grant --resource-id lnk_123 --user-id user_456 --role reader
snug link access revoke --resource-id lnk_123 --user-id user_456 --role reader
snug link campaign access grant --resource-id lcmp_123 --user-id user_456 --role editor

Next

Workspaces and shared access

Use --workspace-id and --visibility private|workspace when creating a campaign. A link uses its campaign's workspace; --visibility selects private or workspace sharing for that link. Omit the options for the ordinary private-resource default.

snug access workspace create --name Engineering
snug link campaign create --name Releases --domain go.example.com \
  --workspace-id WORKSPACE --visibility workspace
snug access group create --name Reviewers
snug access group add-member --id GROUP --user-id USER
snug access grant --target workspaces --id WORKSPACE \
  --subject-kind group --subject-id GROUP --role reader

The shared snug access commands also manage service accounts and their scoped, revocable keys. See Link permissions for ownership rules and the HTTP equivalents.