---
title: CLI
description: >-
  Asenna linkdash-cli npm:stä ja aja sitten `linkdash`-komento. Onnistuneet
  komennot tulostavat JSONia stdoutiin. Ohje ja virheet tulostetaan pelkkänä
  tekstinä stderriin.
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
```

npm-paketti on `linkdash-cli`. Komento on `linkdash`.

HTTP-vastine: [HTTP API](/fi/api). MCP: [MCP](/fi/mcp). Agenttitaito: [Agenttitaito](/fi/skill). Hinnoittelu: [Hinnoittelu](/fi/pricing). Pelkkä markdown: [cli.md](https://linkdash.dev/cli.md).

`--json`-lippua ei ole. Virheissä poistumiskoodi on 1.

## Tunnistautuminen

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

Eikö sinulla ole vielä tiliä? `auth create` avaa osoitteen https://linkdash.dev/sign-up ja palaa sitten osoitteeseen https://linkdash.dev/device CLI-koodin kanssa, jotta voit hyväksyä sen. Onko sinulla jo tili? `auth login` avaa sivun `/device`. Ilman selainta: aseta `LINKDASH_TOKEN`-muuttujaan istuntotunnus, jonka sait komennolla `auth create` tai `auth login`. Älä keksi tunnuksia itse.

Istuntotiedosto: `~/.config/linkdash/config.json` (oikeudet 0600).

CLI ei voi muuttaa sähköpostia, salasanaa tai laskutusta. Ohjaa käyttäjä [hallintapaneeliin](https://linkdash.dev/dashboard/billing). API-avaimet (HTTP ja MCP): [API-avaimet](https://linkdash.dev/dashboard/keys).

## Komennot

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

| Komento | Mitä se tekee |
| --- | --- |
| `auth create` | Rekisteröityminen selaimessa, sitten laitteen hyväksyntä |
| `auth login` | Laitekirjautuminen selaimessa |
| `auth logout` | Unohda tallennettu istunto |
| `auth whoami` | Kirjautuneen tilin JSON |
| `links list` | Listaa linkit ja kansiot sivu kerrallaan (`--limit`, `--cursor`) |
| `links get <id>` | Yksi linkki |
| `links create --url <url>` | Lyhytlinkki URL-osoitteesta |
| `links create --file <path>` | Lähetä tiedosto ja saat linkin |
| `links create --text <text>` | Tallenna tekstikatkelma |
| `links create --folder <name>` | Luo [kansio](/fi/folders) |
| `links create --variant <name> …` | Linkki, jossa on useita variantteja (jako / kohdennus) |
| `links update <id>` | Muuta kohdetta, tiedostoa, salasanaa, vanhenemista, verkkotunnusta, tilaa, pysyvyyttä tai välitettäviä parametreja |
| `links move <id> --in <folder-id>` | Siirrä linkki tai kansio kansioon (`--root` ylimmälle tasolle) |
| `links copy <id>` | Tee kopio uudella slugilla samaan kansioon |
| `links delete <id>` | Poista linkki (kansion kohteet siirtyvät tasoa ylemmäs; `--with-contents` poistaa ne) |
| `links share <id> --email <email>` | [Jaa](/fi/sharing) ihmisille sähköpostilla (toista `--email`; `--role editor` antaa heidän muuttaa sitä; jokainen uusi henkilö saa kutsusähköpostin) |
| `links unshare <id> --email <email>` | Poista joltakulta käyttöoikeus |
| `links shares [id]` | Ketkä voivat avata sen sinun lisäksesi, myös sen yläpuolella olevan kansion kautta. Ilman id:tä: kaikki, mihin olet kutsunut ihmisiä, sivu kerrallaan (`--limit`, `--cursor`) |
| `links shared` | Mitä muut ovat jakaneet sinulle, sivu kerrallaan (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Luovu jostakin sinulle jaetusta |
| `links role <id> --email <e> --role viewer\|editor` | Tee kutsumastasi henkilöstä katsoja tai muokkaaja |
| `links unlock <_id \| share URL>` | Syötä jaetun kohteen salasana, niin voit nähdä ja muokata sen kohdetta 30 minuutin ajan |
| `links activity <id>` | Kuka muutti kohdetta ja miten |
| `links reset-link <id>` | Uusi jako-URL; vanha `linkdash.dev/s/`-URL lakkaa toimimasta |
| `links stats <id>` | Käyntien, latausten ja toistojen kokonaismäärät, myös varianttikohtaisesti, sekä indeksointibotit |
| `links export` | Tulosta kaikki linkit CSV-muodossa (yksi rivi per variantti) |
| `links import <file>` | Tuo URL- ja tekstirivit CSV:stä |
| `links variants list <id>` | Linkin variantit |
| `links variants add <id> --name <n>` | Lisää variantti |
| `links variants update <id> <name>` | Muuta varianttia |
| `links variants remove <id> <name>` | Poista variantti |
| `webhooks list` | Listaa webhook-päätepisteet (salaisuus peitetty) |
| `webhooks get <id>` | Näytä yhden webhookin URL (salaisuus peitetty) |
| `webhooks create --url <https>` | Lisää HTTPS-päätepiste (salaisuus näytetään kerran) |
| `webhooks rotate <id>` | Luo uusi allekirjoitussalaisuus |
| `webhooks delete <id>` | Poista webhook |
| `domains list` | Listaa omat isäntänimet |
| `domains add <host>` | Lisää isäntänimi (1 Free-paketissa) |
| `domains connect <host>` | Domain Connect -käyttöönotto-URL tai null |
| `domains verify <host>` | Tarkista DNS Unkeyn avulla |
| `domains remove <host>` | Poista isäntänimi |
| `-h, --help` | Ohje (pelkkä teksti) |
| `-v, --version` | Versio |

Jos sama slug on käytössä kahdessa omistajan verkkotunnuksessa, anna `--domain`.

## Luonti- ja päivitysliput

Slug on linkin tunniste ja julkisen linkin julkinen polku. Nimi näkyy vain sinulle. Uudet linkit ovat rajattuja (katso [Käyttöoikeudet ja jakaminen](#access-and-sharing)). Luonti ottaa **täsmälleen yhden** näistä: `--url`, `--file` tai `--text` (siitä tulee variantti `main`), `--variant`-lohkot (katso [Variantit](#variants)) tai `--folder <name>` (katso [Kansiot](#folders)).

| Lippu | Huomiot |
| --- | --- |
| `--url <url>` | Kohde-URL |
| `--file <path>` | Lähetettävä tiedosto (luonnissa, tai päivityksessä tiedoston sisällön korvaamiseen) |
| `--text <text>` | Tekstikatkelma |
| `--access <restricted\|link\|public>` | Kuka voi avata sen. Oletus `restricted`. Katso [Käyttöoikeudet ja jakaminen](#access-and-sharing) |
| `--reset-share-link` | Luo uusi jako-URL (vain päivitys) |
| `--slug <id>` | Julkinen polku: `a-z0-9` ja sisäiset väliviivat, 1–64 merkkiä |
| `--name <label>` | Yksityinen nimi |
| `--tag <tag>` | Toistettava. Pienet kirjaimet, ei pilkkuja. Enintään 20 |
| `--starts <when>` | Aktivoituu ajan `7d`, `24h` tai `30m` kuluttua tai ISO-päivämääränä |
| `--password <secret>` | Vaadi tämä salasana avaamiseen |
| `--expires <when>` | Lakkaa toimimasta ajan `7d`, `24h` tai `30m` kuluttua tai ISO-päivämääränä |
| `--max-openings <n>` | Keskeytä näin monen avauksen jälkeen. Jätä pois, jos et halua rajaa |
| `--domain <host>` | Käytä tätä isäntää `lida.sh`-osoitteen sijaan |
| `--in <folder-id>` | Luo tämän kansion sisään (vain luonti; `--in-domain <host>`, jos kansion slug toistuu) |
| `--status <active\|paused>` | Keskeytä tai jatka (vain päivitys) |
| `--sticky` / `--no-sticky` | Palaava kävijä saa saman variantin (oletuksena pysyvä) |
| `--restart-split` | Arvo pysyvät osoitukset uudelleen (vain päivitys) |
| `--forward-params` / `--no-forward-params` | Lisää kävijän kyselymerkkijono URL-variantteihin (oletuksena pois päältä). Katso [Kyselyparametrien välittäminen](#forward-query-parameters) |
| `--variant <name>` | Aloita varianttilohko (vain luonti). Katso [Variantit](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Varianttikohtaisia. Katso [Variantit](#variants) ja [Kyselyparametrisäännöt](#query-parameter-rules) |
| `--preview-name <text>` | Julkisen esikatselun nimi |
| `--preview-description <text>` | Julkisen esikatselun kuvaus |
| `--preview-image <path>` | Julkisen esikatselun kuva |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Vain URL-linkit |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Vain päivitys |

`--status` hyväksyy vain arvot `active` tai `paused`. Vanhentunut tila tulee `--expires`-lipusta. Ajastettu tila tulee `--starts`-lipusta. Julkinen haku palauttaa not-found-vastauksen alkamisaikaan asti. Kun `--max-openings` täyttyy, linkki keskeytyy; nosta lukua tai käytä `--clear-max-openings`, niin linkki toimii taas. Jo käytetyt avaukset pysyvät laskettuina, kunnes muutat rajaa tai poistat sen.

`lida.sh`-slugit ovat yhteisiä. Jos sana on jo varattu, lisää [oma verkkotunnus](/fi/domains) ja yritä uudelleen `--domain`-lipulla. Oman verkkotunnuksen linkkiä ei julkaista lisäksi osoitteessa `lida.sh`.

## Listausliput

Tulostaa yhden sivun, `{items, cursor}`: `--limit` on 1-100 (oletus 50); anna `--cursor`-lipulle edellisen sivun `cursor`-arvo, kunnes se on `null`. Sivulla voi olla vähemmän kohteita kuin `--limit`, jos suodatin ohittaa osan. `--q` täsmää kokonaisiin sanoihin, ja viimeinen sana toimii etuliitteenä (`laun` löytää `example.com/launch`); tulokset järjestetään osuvuuden mukaan. `--in` listaa yhden kansion, kansiot ensin; muuten uusimmat ensin.

| Lippu | Huomiot |
| --- | --- |
| `--limit <n>` | Kohteita sivulla, 1-100 (oletus 50) |
| `--cursor <c>` | Edellisen sivun `cursor` |
| `--q <text>` | Hae sanoja nimestä, slugista, varianttien nimistä ja kohteista, tiedostonimistä, tekstikatkelmista ja tageista |
| `--tag <tag>` | Suodata tagin mukaan |
| `--kind <url\|file\|text\|folder\|group>` | Suodata tyypin mukaan (`group` = useita variantteja) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` tai `mixed` |
| `--in <folder-id\|root>` | Vain se, mikä on suoraan tässä kansiossa tai ylimmällä tasolla. Ilman tätä listataan kaikki |

## Variantit

Jokainen linkki on säiliö yhdelle tai useammalle **variantille**. Variantti on sisältö (URL, tiedosto tai teksti) sekä sen omat rajoitukset (`--password`, `--starts`, `--expires`, `--max-openings`), `--weight` ja valinnaiset kävijäehdot (`--when`). Ilman `--variant`-lippua linkillä on yksi variantti nimeltä `main`, ja jokainen yllä oleva komento on lyhennysmuoto sille. Kävijä saa yhden variantin: variantit, joiden `--when` täsmää, muodostavat valintajoukon (jos mikään ei täsmää, joukon muodostavat ehdottomat variantit), ja siitä tehdään painotettu valinta. Pysyvällä osoituksella (oletus) palaava kävijä saa saman variantin. Linkin omat rajoitukset menevät varianttien rajoitusten edelle. Varianttien nimet: pieniä kirjaimia, numeroita ja sisäisiä väliviivoja, 1–40 merkkiä, yksilöllinen linkin sisällä. Enintään 20 varianttia.

Linkin `kind` on variantin tyyppi, jos variantteja on yksi, ja `group`, jos niitä on useita. Linkin `status` on linkin rajoituksen tila, jos sellainen on asetettu (`paused`, `scheduled`, `expired`), muuten varianttien yhteinen tila ja muuten `mixed`. `variantStatuses` sisältää lukumäärät `{active, paused, expired, scheduled}`.

### Luonti varianttilohkoilla

```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>` aloittaa varianttilohkon. Sen jälkeiset liput kuuluvat kyseiseen varianttiin seuraavaan `--variant`-lippuun asti: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (toistettava), `--utm-*`. Linkin liput (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) tulevat ennen ensimmäistä `--variant`-lippua.

### Varianttien alikomennot

```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>` ottaa yhden lipuista `--url`, `--file`, `--text` sekä rajoitusliput, `--weight`, `--when` ja `--utm-*`. `variants update <id> <name>` ottaa liput `--name <new>`, sisällön, rajoitusliput, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires` ja `--clear-max-openings`. Linkillä on aina vähintään yksi variantti.

### `--when`-avaimet

| Avain | JSON-kenttä | Arvot |
| --- | --- | --- |
| `country` | `countries` | ISO-2-koodit (`DE`, `AT`) |
| `device` | `devices` | `mobile` `tablet` `desktop` |
| `os` | `os` | `windows` `macos` `android` `ios` `linux` `other` |
| `browser` | `browsers` | `edge` `chrome` `firefox` `safari` `other` |
| `language` | `languages` | etuliitetäsmäys (`de`, `en-us`) |
| `referrer` | `referrerHosts` | isäntänimen loppuosa (`twitter.com`) |

Jokaisen asetetun avaimen on täsmättävä. `--when country=DE,AT --when device=mobile` vastaa muotoa `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Kyselyparametrisäännöt

`--when` hyväksyy myös `param:`-sääntöjä kävijän kyselymerkkijonolle (`lida.sh/promo?src=newsletter`). Avaimissa kirjainkoolla on merkitystä, arvoja verrataan täsmälleen, ja variantilla voi olla enintään 10 sääntöä. Pilkut jakavat `--when`-arvon osiin, joten parametrin arvossa ei voi olla pilkkua; käytä listoissa merkkiä `|`.

| Syntaksi | JSON `op` | Täsmää, kun |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | arvo on täsmälleen `VALUE` |
| `param:KEY!=VALUE` | `notEquals` | arvo on eri, tai avain puuttuu |
| `param:KEY~=VALUE` | `includes` | arvo sisältää merkkijonon `VALUE` |
| `param:KEY^=VALUE` | `startsWith` | arvo alkaa merkkijonolla `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | arvo päättyy merkkijonoon `VALUE` |
| `param:KEY=v1\|v2` | `in` | arvo on jokin listan arvoista |
| `param:KEY?` tai `param:KEY` | `exists` | avain on olemassa |
| `param:!KEY` | `missing` | avain puuttuu |

```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-muoto: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` jätetään pois, kun op on `exists` / `missing`). Parametrien arvot tarkistetaan avaushetkellä, eikä niitä koskaan tallenneta analytiikkaan.

### Kyselyparametrien välittäminen

`--forward-params` / `--no-forward-params` komennoissa `links create` ja `links update` (linkkitasoinen, oletuksena pois päältä) lisää kävijän koko kyselymerkkijonon URL-variantteihin: `lida.sh/promo?src=nl` avaa osoitteen `https://example.com/?src=nl`. Kävijän arvot korvaavat tallennetut arvot, myös `--utm-*`-arvot. Tiedosto- ja tekstivariantit ohittavat asetuksen. Kyse on reitityksestä, ei käyttöoikeuksien hallinnasta: kuka tahansa voi lisätä parametreja. Parametrien arvoja ei tallenneta analytiikkaan. `links get` näyttää asetuksen kenttänä `forwardParams`.

### Pysyvyys ja jaon uudelleenaloitus

`links update <id> --sticky` / `--no-sticky` määrittää, saako palaava kävijä saman variantin. `links update <id> --restart-split` arpoo pysyvät osoitukset uudelleen. `links update` -komennon sisältöliput toimivat vain yhden variantin linkeissä; muuten käytä komentoa `links variants update <id> <name>`.

## Kansiot

Kansio on linkki, joka listaa siihen lisäämäsi kohteet. Katso sivulta [Kansiot](/fi/folders), miten julkinen sivu ja käyttöoikeudet toimivat.

```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>` asettaa kansion nimen (ei `--name`) ja hyväksyy liput `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` ja `--in`. Sitä ei voi yhdistää lippuihin `--url`, `--file`, `--text` tai `--variant`. `links move` tulostaa `{id, folder}`. `links copy` säilyttää käyttöoikeustason, mutta kopio saa uuden jako-URL:n; ihmisiä ei kopioida. `links delete` kansiolle siirtää sen kohteet tasoa ylemmäs; `--with-contents` poistaa myös ne. Listauksen, haun ja luonnin riveillä on `folder` (sisältävän kansion slug tai `null`); kansiorivillä on lisäksi `items`.

## Käyttöoikeudet ja jakaminen

Uudet linkit ja kansiot ovat `restricted`: niiden `url` on `https://linkdash.dev/s/<token>`, jonka voivat avata kirjautuneina vain sinä ja ne, joille jaat sen. `--access link` avaa tämän URL:n kaikille, joilla se on. `--access public` tarjoilee linkin sen lyhyessä URL-osoitteessa (`lida.sh/<slug>` tai oma verkkotunnuksesi). Käytä `--access public` -asetusta linkeille, jotka julkaiset avoimesti. Slug pysyy tunnisteena kaikissa komennoissa, ja sen lyhyt URL pysyy varattuna, vaikka linkki ei olisi julkinen. Katso koko malli sivulta [Jakaminen ja käyttöoikeudet](/fi/sharing).

```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
```

| Komento | Tulostaa |
| --- | --- |
| `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` (ilman id:tä) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, viimeksi jaetut ensin |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, uusimmat ensin |
| `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>` (tai `links update <id> --reset-share-link`) | `{id, access, url}` |

`--role editor` tekee henkilöstä muokkaajan: hän voi muuttaa kohdetta ja nähdä sen tilastot, mutta ei salasanoja, slugia, verkkotunnusta, käyttöoikeuksia tai jakamista, eikä hän voi poistaa, siirtää tai kopioida kohdetta. Salasanalla suojattu kohde vaatii lisäksi ensin `links unlock` -komennon (30 minuuttia). Muokkaajat käyttävät `_id`:tä tai jako-URL:ää komennon `links shared` tulosteesta. Kaikki komennot hyväksyvät `--domain <host>` -lipun, kun slug toistuu. `url` komentojen `create`, `get`, `list`, `update`, `copy` ja `share` tulosteessa on jako-URL, ellei linkki ole julkinen, jolloin se on lyhyt URL; riveillä on `access`. Enintään 200 henkilöä kohdetta kohden, 50 sähköpostiosoitetta per komento ja 100 kutsusähköpostia tiliä kohden päivässä. Molemmat listat tulostavat yhden sivun: `--limit` on 1-100 (oletus 50); anna `--cursor` edelliseltä sivulta, kunnes `cursor` on `null`. `links leave` ottaa `_id`:n tai `url`:n komennon `links shared` tulosteesta; käyttöoikeus yläpuolella olevan jaetun kansion kautta säilyy. Jakaminen, jaon poistaminen, käyttöoikeuden muutos ja nollaus lasketaan kukin yhdeksi tapahtumaksi; poistuminen ei.

## Tilastot

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

`--last` on kesto (`24h`, `7d`). Oletus `24h`. JSON sisältää kentät `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (varianttikohtaiset kokonaismäärät), `visitors` (jokaisella oma `variant`) ja `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: botit ja linkkiesikatselut, jotka hakivat linkin; niitä ei koskaan lasketa käynneiksi).

## CSV

Sarakkeet: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Yksi rivi per variantti. `kind`, `status`, `url`, `text`, `fileName`, `weight` ja `when` (JSON-merkkijono) ovat varianttikohtaisia; loput ovat linkkikohtaisia ja toistuvat. `folder` on sen kansion slug, jossa linkki on. `access` on `restricted`, `link` tai `public`. Mukana ei ole salasanoja, jakotunnuksia eikä ihmisiä.

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

Tuonti ryhmittelee rivit slugin ja verkkotunnuksen mukaan. Ensimmäinen rivi luo linkin ja sen variantin; seuraavat rivit lisäävät variantteja. Olemassa olevalle linkille ensimmäinen rivi päivittää linkin kentät, ja sen jälkeen jokainen rivi päivittää samannimisen variantin, jos sellainen on olemassa, tai muuten lisää sen. Tiedostorivit, joilta puuttuu tiedoston sisältö, ohitetaan rivikohtaisella virheellä. Rivit, joissa `kind` = `folder` (ja `name`), luovat kansioita; `folder`-sarake sijoittaa kunkin linkin kansioonsa, kun kaikki rivit on luotu. Tyhjä `access` tekee uusista linkeistä rajattuja ja jättää olemassa olevat linkit ennalleen.

## Esimerkkejä

```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
```

Katso myös [kansiot](/fi/folders), [jakaminen ja käyttöoikeudet](/fi/sharing), [webhookit](/fi/webhooks) ja [omat verkkotunnukset](/fi/domains).
