---
title: CLI
description: >-
  Installeer linkdash-cli via npm en voer daarna het `linkdash`-commando uit.
  Geslaagde commando's printen JSON op stdout. Help en fouten zijn platte tekst
  op stderr.
sidebar:
  label: CLI
  order: 3
---
```bash
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
```

Het npm-pakket heet `linkdash-cli`. Het commando is `linkdash`.

HTTP-equivalent: [HTTP API](/nl/api). MCP: [MCP](/nl/mcp). Agent-skill: [Agent-skill](/nl/skill). Prijzen: [Prijzen](/nl/pricing). Platte markdown: [cli.md](https://linkdash.dev/cli.md).

Er is geen `--json`-flag. Bij fouten is de exitcode 1.

## Auth

```bash
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
```

Nog geen account? `auth create` opent https://linkdash.dev/sign-up en brengt je daarna terug naar https://linkdash.dev/device met de CLI-code, zodat je kunt goedkeuren. Heb je al een account? `auth login` opent `/device`. Headless: zet `LINKDASH_TOKEN` op een sessietoken uit `auth create` of `auth login`. Verzin geen tokens.

Sessiebestand: `~/.config/linkdash/config.json` (mode 0600).

De CLI kan geen e-mailadres, wachtwoord of facturering wijzigen. Stuur de gebruiker daarvoor naar het [dashboard](https://linkdash.dev/dashboard/billing). API-sleutels (HTTP en MCP): [API-sleutels](https://linkdash.dev/dashboard/keys).

## Commando's

```
linkdash <command> [options]
```

| Commando | Wat het doet |
| --- | --- |
| `auth create` | Registratie in de browser, daarna goedkeuring van het apparaat |
| `auth login` | Apparaatlogin via de browser |
| `auth logout` | De opgeslagen sessie vergeten |
| `auth whoami` | JSON van het ingelogde account |
| `links list` | Links en mappen weergeven, één pagina per keer (`--limit`, `--cursor`) |
| `links get <id>` | Eén link |
| `links create --url <url>` | Korte link van een URL |
| `links create --file <path>` | Een bestand uploaden en een link krijgen |
| `links create --text <text>` | Een snippet opslaan |
| `links create --folder <name>` | Een [map](/nl/folders) maken |
| `links create --variant <name> …` | Link met meerdere varianten (split / targeting) |
| `links update <id>` | Bestemming, bestand, wachtwoord, verloopdatum, domein, status, sticky of doorgestuurde parameters wijzigen |
| `links move <id> --in <folder-id>` | Een link of map in een map plaatsen (`--root` voor het hoogste niveau) |
| `links copy <id>` | Een kopie maken met een nieuwe slug, in dezelfde map |
| `links delete <id>` | Een link verwijderen (de items van een map gaan een niveau omhoog; `--with-contents` verwijdert ze) |
| `links share <id> --email <email>` | Met mensen [delen](/nl/sharing) via e-mail (herhaal `--email`; met `--role editor` kunnen ze het wijzigen; elke nieuwe persoon krijgt een uitnodigingsmail) |
| `links unshare <id> --email <email>` | Iemands toegang intrekken |
| `links shares [id]` | Wie het naast jou kan openen, ook via een bovenliggende map. Zonder id: alles waarvoor je mensen hebt uitgenodigd, één pagina per keer (`--limit`, `--cursor`) |
| `links shared` | Wat anderen met je hebben gedeeld, één pagina per keer (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Afstand doen van iets dat met je is gedeeld |
| `links role <id> --email <e> --role viewer\|editor` | Iemand die je hebt uitgenodigd viewer of editor maken |
| `links unlock <_id \| share URL>` | Het wachtwoord van een gedeeld item invoeren om het doel 30 minuten te kunnen zien en bewerken |
| `links activity <id>` | Wie een item heeft gewijzigd en hoe |
| `links reset-link <id>` | Nieuwe deel-URL; de oude `linkdash.dev/s/`-URL werkt niet meer |
| `links stats <id>` | Totalen voor bezoeken, downloads en keren afgespeeld, ook per variant, plus crawlers |
| `links export` | Alle links als CSV printen (één rij per variant) |
| `links import <file>` | URL- en tekstrijen uit CSV importeren |
| `links variants list <id>` | Varianten van een link |
| `links variants add <id> --name <n>` | Een variant toevoegen |
| `links variants update <id> <name>` | Een variant wijzigen |
| `links variants remove <id> <name>` | Een variant verwijderen |
| `webhooks list` | Webhook-endpoints weergeven (secret gemaskeerd) |
| `webhooks get <id>` | Eén webhook-URL tonen (secret gemaskeerd) |
| `webhooks create --url <https>` | Een HTTPS-endpoint toevoegen (secret wordt één keer getoond) |
| `webhooks rotate <id>` | Een nieuw signing secret uitgeven |
| `webhooks delete <id>` | Een webhook verwijderen |
| `domains list` | Eigen hostnamen weergeven |
| `domains add <host>` | Een hostnaam toevoegen (1 op Free) |
| `domains connect <host>` | Domain Connect-apply-URL, of null |
| `domains verify <host>` | DNS controleren met Unkey |
| `domains remove <host>` | Een hostnaam verwijderen |
| `-h, --help` | Help (platte tekst) |
| `-v, --version` | Versie |

Bestaat dezelfde slug op twee domeinen van de eigenaar, geef dan `--domain` mee.

## Flags voor create en update

De slug is de id van de link, en het openbare pad als de link openbaar is. De naam is alleen voor jou zichtbaar. Nieuwe links zijn beperkt (zie [Toegang en delen](#access-and-sharing)). Create accepteert **precies één** van `--url`, `--file` of `--text` (dat wordt de variant `main`), `--variant`-blokken (zie [Varianten](#variants)) of `--folder <name>` (zie [Mappen](#folders)).

| Flag | Opmerkingen |
| --- | --- |
| `--url <url>` | Bestemmings-URL |
| `--file <path>` | Te uploaden bestand (bij create, of vervangt de bytes bij update) |
| `--text <text>` | Snippet |
| `--access <restricted\|link\|public>` | Wie het kan openen. Standaard `restricted`. Zie [Toegang en delen](#access-and-sharing) |
| `--reset-share-link` | Een nieuwe deel-URL uitgeven (alleen update) |
| `--slug <id>` | Openbaar pad: `a-z0-9` en koppeltekens binnenin, 1–64 |
| `--name <label>` | Privélabel |
| `--tag <tag>` | Herhaalbaar. Kleine letters, geen komma's. Max. 20 |
| `--starts <when>` | Live gaan na `7d`, `24h`, `30m` of op een ISO-datum |
| `--password <secret>` | Dit wachtwoord vereisen om te openen |
| `--expires <when>` | Stoppen met serveren na `7d`, `24h`, `30m` of op een ISO-datum |
| `--max-openings <n>` | Pauzeren na zoveel keer openen. Laat weg voor onbeperkt |
| `--domain <host>` | Op deze host serveren in plaats van `lida.sh` |
| `--in <folder-id>` | In deze map aanmaken (alleen create; `--in-domain <host>` als de map-slug vaker voorkomt) |
| `--status <active\|paused>` | Pauzeren of hervatten (alleen update) |
| `--sticky` / `--no-sticky` | Terugkerende bezoeker houdt dezelfde variant (standaard sticky) |
| `--restart-split` | Sticky toewijzingen opnieuw verdelen (alleen update) |
| `--forward-params` / `--no-forward-params` | De querystring van de bezoeker toevoegen aan URL-varianten (standaard uit). Zie [Queryparameters doorsturen](#forward-query-parameters) |
| `--variant <name>` | Een variantblok starten (alleen create). Zie [Varianten](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Per variant. Zie [Varianten](#variants) en [Regels voor queryparameters](#query-parameter-rules) |
| `--preview-name <text>` | Openbare naam voor de linkpreview |
| `--preview-description <text>` | Openbare beschrijving voor de linkpreview |
| `--preview-image <path>` | Openbare afbeelding voor de linkpreview |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Alleen URL-links |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Alleen update |

`--status` accepteert alleen `active` of `paused`. Verlopen volgt uit `--expires`. Gepland volgt uit `--starts`. Openbaar resolven geeft not-found tot de starttijd. Zodra `--max-openings` is bereikt, pauzeert de link; verhoog het aantal, of gebruik `--clear-max-openings`, om hem weer te serveren. Openingen die al gebruikt zijn, blijven meetellen totdat je de limiet wijzigt of verwijdert.

`lida.sh`-slugs worden gedeeld. Is een woord al bezet, voeg dan een [eigen domein](/nl/domains) toe en probeer het opnieuw met `--domain`. Een link op een eigen domein wordt niet ook op `lida.sh` gepubliceerd.

## Flags voor list

Print één pagina, `{items, cursor}`: `--limit` is 1-100 (standaard 50); geef `--cursor` mee met de `cursor` van de vorige pagina, totdat die `null` is. Een pagina kan minder items bevatten dan `--limit` als een filter er een paar overslaat. `--q` matcht hele woorden, waarbij het laatste woord als prefix telt (`laun` vindt `example.com/launch`), gerangschikt op relevantie; `--in` toont één map, met mappen eerst; anders staat het nieuwste bovenaan.

| Flag | Opmerkingen |
| --- | --- |
| `--limit <n>` | Items per pagina, 1-100 (standaard 50) |
| `--cursor <c>` | De `cursor` van de vorige pagina |
| `--q <text>` | Zoekt woorden in de naam, slug, variantnamen en -doelen, bestandsnamen, snippettekst en tags |
| `--tag <tag>` | Filteren op tag |
| `--kind <url\|file\|text\|folder\|group>` | Filteren op soort (`group` = meerdere varianten) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` of `mixed` |
| `--in <folder-id\|root>` | Alleen wat direct in deze map staat, of op het hoogste niveau. Zonder deze flag wordt alles weergegeven |

## Varianten

Elke link is een container met een of meer **varianten**. Een variant is de content (URL, bestand of tekst) plus een eigen gate (`--password`, `--starts`, `--expires`, `--max-openings`), een `--weight` en optionele voorwaarden voor bezoekers (`--when`). Zonder `--variant` heeft een link één variant met de naam `main`, en elk commando hierboven is daar een afkorting voor. Een bezoeker krijgt één variant: de varianten waarvan `--when` matcht vormen de pool (matcht er geen, dan vormen de onvoorwaardelijke varianten de pool), en daaruit volgt een gewogen keuze. Met sticky toewijzing (standaard) houdt een terugkerende bezoeker dezelfde variant. De gate van de link zelf gaat voor op de gates van varianten. Variantnamen: kleine letters, cijfers, koppeltekens binnenin, 1–40 tekens, uniek per link. Max. 20 varianten.

De `kind` van een link is bij één variant de soort van die variant, en bij meerdere varianten `group`. De `status` van een link is de linkgate als die is ingesteld (`paused`, `scheduled`, `expired`), anders de gezamenlijke status van de varianten, anders `mixed`. `variantStatuses` telt `{active, paused, expired, scheduled}`.

### Aanmaken met variantblokken

```bash
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links create --slug hi --variant de --url https://example.de --when country=DE,AT --variant rest --url https://example.com
```

`--variant <name>` start een variantblok. Flags daarna horen bij die variant tot de volgende `--variant`: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (herhaalbaar), `--utm-*`. Linkflags (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) komen vóór de eerste `--variant`.

### Variant-subcommando's

```bash
linkdash links variants list promo
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links variants update promo mobile --when country=DE,AT --when device=mobile --weight 2
linkdash links variants update promo b --status paused
linkdash links variants remove promo b
```

`variants add <id> --name <n>` accepteert één van `--url`, `--file` of `--text`, plus gateflags, `--weight`, `--when` en `--utm-*`. `variants update <id> <name>` accepteert `--name <new>`, content, gateflags, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires` en `--clear-max-openings`. Een link houdt altijd minstens één variant.

### `--when`-keys

| Key | JSON-veld | Waarden |
| --- | --- | --- |
| `country` | `countries` | ISO-2-codes (`DE`, `AT`) |
| `device` | `devices` | `mobile` `tablet` `desktop` |
| `os` | `os` | `windows` `macos` `android` `ios` `linux` `other` |
| `browser` | `browsers` | `edge` `chrome` `firefox` `safari` `other` |
| `language` | `languages` | prefix-match (`de`, `en-us`) |
| `referrer` | `referrerHosts` | host-suffix (`twitter.com`) |

Elke ingestelde key moet matchen. `--when country=DE,AT --when device=mobile` wordt `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Regels voor queryparameters

`--when` accepteert ook `param:`-regels op de querystring van de bezoeker (`lida.sh/promo?src=newsletter`). Keys zijn hoofdlettergevoelig, waarden worden exact vergeleken, en je kunt max. 10 regels per variant gebruiken. Komma's splitsen `--when`, dus een parameterwaarde kan geen komma bevatten; gebruik `|` voor lijsten.

| Syntaxis | JSON-`op` | Matcht als |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | de waarde precies `VALUE` is |
| `param:KEY!=VALUE` | `notEquals` | de waarde afwijkt, of de key ontbreekt |
| `param:KEY~=VALUE` | `includes` | de waarde `VALUE` bevat |
| `param:KEY^=VALUE` | `startsWith` | de waarde begint met `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | de waarde eindigt op `VALUE` |
| `param:KEY=v1\|v2` | `in` | de waarde in de lijst staat |
| `param:KEY?` of `param:KEY` | `exists` | de key aanwezig is |
| `param:!KEY` | `missing` | de key ontbreekt |

```bash
linkdash links variants add promo --name news --url https://example.com/news --when param:src=newsletter
linkdash links variants add promo --name pro --url https://example.com/pro --when "param:plan~=pro"
linkdash links variants add promo --name ref --url https://example.com/ref --when "param:ref?"
```

JSON-vorm: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` wordt weggelaten bij `exists` / `missing`). Parameterwaarden worden gematcht op het moment van openen en nooit opgeslagen in analytics.

### Queryparameters doorsturen

`--forward-params` / `--no-forward-params` op `links create` en `links update` (op linkniveau, standaard uit) voegt de volledige querystring van de bezoeker toe aan URL-varianten: `lida.sh/promo?src=nl` opent `https://example.com/?src=nl`. Waarden van de bezoeker overschrijven opgeslagen waarden, ook die van `--utm-*`. Bestands- en tekstvarianten negeren deze instelling. Dit is routing, geen toegangscontrole: iedereen kan parameters toevoegen. Parameterwaarden worden niet opgeslagen in analytics. `links get` toont dit als `forwardParams`.

### Sticky en split herstarten

`links update <id> --sticky` / `--no-sticky` bepaalt of een terugkerende bezoeker dezelfde variant houdt. `links update <id> --restart-split` verdeelt de sticky toewijzingen opnieuw. Contentflags op `links update` werken alleen voor links met één variant; gebruik anders `links variants update <id> <name>`.

## Mappen

Een map is een link die de items toont die je erin zet. Zie [Mappen](/nl/folders) voor hoe de openbare pagina en de toegang werken.

```bash
linkdash links create --folder "Q4 launch" --slug q4
linkdash links create --file ./deck.pdf --in q4
linkdash links move k3m9xq --in q4
linkdash links move k3m9xq --root
linkdash links list --in q4
linkdash links copy k3m9xq
linkdash links delete q4 --with-contents
```

`--folder <name>` stelt de mapnaam in (niet `--name`) en accepteert `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` en `--in`. Je kunt het niet combineren met `--url`, `--file`, `--text` of `--variant`. `links move` print `{id, folder}`. `links copy` behoudt het toegangsniveau maar krijgt een nieuwe deel-URL; mensen worden niet meegekopieerd. `links delete` op een map verplaatst de items een niveau omhoog; met `--with-contents` worden ze ook verwijderd. Rijen van list, get en create bevatten `folder` (de slug van de map waarin het item staat, of `null`); maprijen bevatten ook `items`.

## Toegang en delen

Nieuwe links en mappen zijn `restricted`: hun `url` is `https://linkdash.dev/s/<token>`, die alleen jij en de mensen met wie je deelt kunnen openen, mits ingelogd. Met `--access link` kan iedereen die de URL heeft hem openen. `--access public` serveert de link op zijn korte URL (`lida.sh/<slug>` of je eigen domein). Gebruik `--access public` voor links die je openbaar post. De slug blijft voor elk commando de id, en de korte URL blijft gereserveerd zolang de link niet openbaar is. Zie [Delen en toegang](/nl/sharing) voor het volledige model.

```bash
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com --email ben@example.com
linkdash links shares q4
linkdash links unshare q4 --email ben@example.com
linkdash links shared
linkdash links leave https://linkdash.dev/s/<token>
linkdash links share q4 --email cara@example.com --role editor
linkdash links role q4 --email cara@example.com --role viewer
linkdash links unlock https://linkdash.dev/s/<token>
linkdash links activity q4
linkdash links shares
linkdash links update q4 --access link
linkdash links reset-link q4
```

| Commando | Print |
| --- | --- |
| `links share <id> --email <e> [--email <e> …]` | `{id, url, access, invited, alreadyShared}` |
| `links unshare <id> --email <e>` | `{id, email, removed: true}` |
| `links shares <id>` | `{id, access, url, people: [{email, role: "viewer", accepted, invitedAt, viaFolder?}]}` |
| `links shares` (zonder id) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, meest recent gedeeld eerst |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, nieuwste eerst |
| `links leave <_id \| share URL>` | `{_id, left: true}` |
| `links role <id> --email <e> --role <r>` | `{id, email, role}` |
| `links unlock <_id \| share URL>` | `{_id, variant, unlocked: true, minutes: 30, kind, destinationUrl? \| textContent? \| fileName?}` |
| `links activity <id>` | `{items: [{_id, _creationTime, action, detail?, actor}], cursor}` |
| `links reset-link <id>` (of `links update <id> --reset-share-link`) | `{id, access, url}` |

`--role editor` maakt iemand editor: die kan het item wijzigen en de statistieken zien, maar niet aan wachtwoorden, slug, domein, toegang of delen komen, en ook niet verwijderen, verplaatsen of kopiëren. Voor een doel met een wachtwoord is eerst `links unlock` nodig (30 minuten). Editors gebruiken de `_id` of de deel-URL uit `links shared`. Al deze commando's accepteren `--domain <host>` als de slug vaker voorkomt. `url` in de output van `create`, `get`, `list`, `update`, `copy` en `share` is de deel-URL, tenzij de link openbaar is; dan is het de korte URL. Rijen bevatten `access`. Maximaal 200 mensen per item, 50 e-mailadressen per aanroep en 100 uitnodigingsmails per account per dag. De twee lijsten printen één pagina: `--limit` is 1-100 (standaard 50); geef `--cursor` van de vorige pagina mee totdat `cursor` `null` is. `links leave` accepteert de `_id` of `url` uit `links shared`; toegang via een bovenliggende gedeelde map blijft bestaan. Delen, delen intrekken, een toegangswijziging en een reset tellen elk als één event; een item verlaten telt niet.

## Statistieken

```bash
linkdash links stats <id> --last 24h
```

`--last` is een tijdsduur (`24h`, `7d`). Standaard `24h`. De JSON bevat `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (totalen per variant), `visitors` (elk met `variant`) en `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: bots en linkpreviews die de link hebben opgehaald; die tellen nooit als bezoek).

## CSV

Kolommen: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Eén rij per variant. `kind`, `status`, `url`, `text`, `fileName`, `weight` en `when` (JSON-string) gelden per variant; de rest geldt per link en wordt herhaald. `folder` is de slug van de map waarin de link staat. `access` is `restricted`, `link` of `public`. Geen wachtwoorden, deeltokens of mensen.

```bash
linkdash links export > links.csv
linkdash links import links.csv
```

Import groepeert rijen op slug + domein. De eerste rij maakt de link aan met zijn variant; volgende rijen voegen varianten toe. Bij een bestaande link werkt de eerste rij de linkvelden bij; daarna werkt elke rij de variant met die naam bij als die bestaat, en voegt hem anders toe. Bestandsrijen zonder bytes worden overgeslagen met een foutmelding per rij. Rijen met `kind` = `folder` (en een `name`) maken mappen aan; de kolom `folder` plaatst elke link in zijn map zodra alle rijen bestaan. Een lege `access` maakt nieuwe links beperkt en laat bestaande links ongewijzigd.

## Voorbeelden

```bash
linkdash links create --url https://example.com/q4/deck.pdf --slug deck --name "Q4 deck"
linkdash links create --file ./deck.pdf --expires 7d --starts 1d
linkdash links create --url https://example.com --max-openings 1
linkdash links update k3m9xq --max-openings 5
linkdash links update k3m9xq --clear-max-openings
linkdash links create --text "release checklist" --tag launch --tag q4
linkdash links list --q deck --tag launch --kind file --status paused
linkdash links get welcome --domain go.example.com
linkdash links update deck --file ./new.pdf
linkdash links update k3m9xq --status paused
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links update promo --no-sticky --restart-split
linkdash links create --folder "Q4 launch" --slug q4
linkdash links move k3m9xq --in q4
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com
```

Zie ook [mappen](/nl/folders), [delen en toegang](/nl/sharing), [webhooks](/nl/webhooks) en [eigen domeinen](/nl/domains).
