dub

1# Dub
2 
3## Purpose
4Manage Dub short links: list links, create new ones, update or delete them, read click analytics, and record lead or sale conversions against a click. Use when the user mentions Dub or short links.
5 
6## Tooling
7All commands go through `bin/dub.py`:
8 
9```bash
10bin/dub.py auth                                                  # verify the API key
11bin/dub.py links --limit 25                                      # list links
12bin/dub.py create --url "https://example.com/long" --key "launch"  # new short link
13bin/dub.py update --id "clvabc123" --url "https://example.com/new"  # edit a link
14bin/dub.py delete --id "clvabc123"                               # delete a link
15bin/dub.py analytics --link-id "clvabc123"                       # click analytics
16bin/dub.py track-lead --click-id "abc123"                        # record a lead
17bin/dub.py track-sale --click-id "abc123" --amount 4900          # record a sale
18```
19 
20Dub paths are unversioned: the base is `https://api.dub.co` with no `/v2`. The link id for `update` and `delete` is the `id` field from `links`. `--amount` on `track-sale` is in cents.
21 
22## Auth
23- Provider id: `dub` (credential is collected as `custom.dub`)
24- Collection: API key (`dub_...`) via the secure credential flow (`credentials.request_api_access`); created in the Dub dashboard under API keys
25- Allowed hosts: `api.dub.co`
26- Status check: `bin/dub.py auth` (must return `"ok": true`)
27 
28## Operating Rules
29…