# linkding

> Save and organize bookmarks in linkding: search, add, tag, archive and delete bookmarks, check whether a page is already saved, manage tags, bundles and a bookmark's files, and start a workflow when a bookmark is saved, marked unread, archived or changed.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/linkding

## Actions

### Archive bookmark

Move a bookmark to the archive, out of the active list.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.

**Outputs**

- `archived` (true/false): Whether it's in the archive
- `date_added` (text): When it was saved (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `description` (text): Its description; empty if none
- `favicon_url` (text): A link to the site's icon; empty if linkding has none
- `id` (number): The bookmark's number in linkding
- `link` (text): A link that opens the bookmark's details in linkding
- `notes` (text): Its notes, which can be Markdown; empty if none
- `preview_image_url` (text): A link to the page's preview image; empty if linkding has none
- `shared` (true/false): Whether it's shared with linkding's other users
- `tags` (list): Its tags, by name
- `title` (text): Its title
- `unread` (true/false): Whether it's marked unread
- `url` (text): The address it bookmarks
- `web_archive_snapshot_url` (text): A link to the page on the Internet Archive's Wayback Machine

**Example output**

```json
{
  "archived": true,
  "date_added": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123460Z",
  "description": "A guide to brewing coffee at home.",
  "favicon_url": "",
  "id": 42,
  "link": "https://links.example.com/bookmarks?details=42",
  "notes": "Try the pour-over recipe.",
  "preview_image_url": "",
  "shared": false,
  "tags": [
    "coffee",
    "howto"
  ],
  "title": "How to brew coffee",
  "unread": true,
  "url": "https://example.com/articles/how-to-brew-coffee",
  "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
}
```

### Check a URL

Check whether a web address is already bookmarked, and get the title and description linkding finds on the page and the tags its auto tagging rules would give it.

**Inputs**

- URL (`url`, text, required): The web address to check, such as https://example.com/article.

**Outputs**

- `auto_tags` (list): The tags linkding's auto tagging rules would give a bookmark of this address
- `bookmark` (object): The bookmark for the address; null if it isn't bookmarked
- `bookmark_id` (number): The bookmark's number; 0 if it isn't bookmarked
- `bookmarked` (true/false): Whether the address is already bookmarked
- `page_description` (text): The description linkding finds on the page; empty if none
- `page_preview_image` (text): The preview image linkding finds on the page; empty if none
- `page_title` (text): The title linkding finds on the page; empty if none
- `url` (text): The address checked

**Example output**

```json
{
  "auto_tags": [],
  "bookmark": {
    "archived": false,
    "date_added": "2026-03-02T09:15:00.123456Z",
    "date_modified": "2026-03-02T09:15:00.123460Z",
    "description": "A guide to brewing coffee at home.",
    "favicon_url": "",
    "id": 42,
    "link": "https://links.example.com/bookmarks?details=42",
    "notes": "Try the pour-over recipe.",
    "preview_image_url": "",
    "shared": false,
    "tags": [
      "coffee",
      "howto"
    ],
    "title": "How to brew coffee",
    "unread": true,
    "url": "https://example.com/articles/how-to-brew-coffee",
    "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
  },
  "bookmark_id": 42,
  "bookmarked": true,
  "page_description": "A guide to brewing coffee at home.",
  "page_preview_image": "",
  "page_title": "How to brew coffee",
  "url": "https://example.com/articles/how-to-brew-coffee"
}
```

### Create bookmark

Save a web address as a bookmark, with tags and notes. If the address is already bookmarked, that bookmark is updated, or left as it is if you choose.

**Inputs**

- URL (`url`, text, required): The web address to bookmark, such as https://example.com/article.
- Title (`title`, text): The bookmark's title. Leave empty to use the page's own title.
- Description (`description`, text): A short description. Leave empty to use the page's own description.
- Notes (`notes`, text): Your own notes on the bookmark; Markdown works.
- Tags (`tags`, list): Tags to file it under, by name, such as reading-list. Ones that don't exist are made.
- Mark as unread (`unread`, true/false): Mark the bookmark unread, to read later.
- Share (`shared`, true/false): Share the bookmark with linkding's other users. Sharing has to be turned on in linkding's settings.
- Save to the archive (`archived`, true/false): Put the bookmark straight into the archive.
- Fetch the page's title (`fetch_details`, true/false): Have linkding open the page for its title and description when you give none. On unless you turn it off.
- If it's already bookmarked (`if_exists`, text): What to do when the address is already bookmarked. One of: `update` (Update it with these details), `skip` (Leave it as it is). Default: `update`.

**Outputs**

- `already_existed` (true/false): Whether the address was already bookmarked, so that bookmark was updated or left as it was
- `archived` (true/false): Whether it's in the archive
- `date_added` (text): When it was saved (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `description` (text): Its description; empty if none
- `favicon_url` (text): A link to the site's icon; empty if linkding has none
- `id` (number): The bookmark's number in linkding
- `link` (text): A link that opens the bookmark's details in linkding
- `notes` (text): Its notes, which can be Markdown; empty if none
- `preview_image_url` (text): A link to the page's preview image; empty if linkding has none
- `shared` (true/false): Whether it's shared with linkding's other users
- `tags` (list): Its tags, by name
- `title` (text): Its title
- `unread` (true/false): Whether it's marked unread
- `url` (text): The address it bookmarks
- `web_archive_snapshot_url` (text): A link to the page on the Internet Archive's Wayback Machine

**Example output**

```json
{
  "already_existed": false,
  "archived": false,
  "date_added": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123460Z",
  "description": "A guide to brewing coffee at home.",
  "favicon_url": "",
  "id": 42,
  "link": "https://links.example.com/bookmarks?details=42",
  "notes": "Try the pour-over recipe.",
  "preview_image_url": "",
  "shared": false,
  "tags": [
    "coffee",
    "howto"
  ],
  "title": "How to brew coffee",
  "unread": true,
  "url": "https://example.com/articles/how-to-brew-coffee",
  "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
}
```

### Create bundle

Make a bundle: a saved filter that groups bookmarks by search words, tags, and whether they're unread or shared.

**Inputs**

- Name (`name`, text, required): The bundle's name, such as Work reading.
- Search (`search`, text): Words a bookmark must have in its title, description, notes or address, such as recipe.
- Any of these tags (`any_tags`, list): A bookmark needs at least one of these tags.
- All of these tags (`all_tags`, list): A bookmark needs every one of these tags.
- None of these tags (`excluded_tags`, list): A bookmark with any of these tags is left out.
- Unread (`unread`, text): Only unread bookmarks (Yes), only read ones (No), or both. One of: `any` (Either), `yes`, `no`. Default: `any`.
- Shared (`shared`, text): Only shared bookmarks (Yes), only unshared ones (No), or both. One of: `any` (Either), `yes`, `no`. Default: `any`.

**Outputs**

- `all_tags` (list): Tags a bookmark needs all of
- `any_tags` (list): Tags of which a bookmark needs at least one
- `date_created` (text): When it was made (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `excluded_tags` (list): Tags a bookmark must have none of
- `id` (number): The bundle's number in linkding
- `name` (text): The bundle's name
- `order` (number): Its place in linkding's list of bundles, from 0
- `search` (text): The search words its bookmarks match; empty if none
- `shared` (text): Whether it holds only shared (yes), only unshared (no) or any
- `unread` (text): Whether it holds only unread (yes), only read (no) or any

**Example output**

```json
{
  "all_tags": [],
  "any_tags": [
    "work",
    "research"
  ],
  "date_created": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123456Z",
  "excluded_tags": [
    "done"
  ],
  "id": 3,
  "name": "Work reading",
  "order": 0,
  "search": "",
  "shared": "any",
  "unread": "yes"
}
```

### Create tag

Make a tag to file bookmarks under. One with the name already is returned as it is.

**Inputs**

- Name (`name`, text, required): The tag's name, such as reading-list. A space becomes a hyphen.

**Outputs**

- `date_added` (text): When it was made (ISO 8601)
- `id` (number): The tag's number in linkding
- `name` (text): The tag's name

**Example output**

```json
{
  "date_added": "2026-03-02T09:15:00.123456Z",
  "id": 7,
  "name": "coffee"
}
```

### Delete bookmark

Delete a bookmark for good, with its files.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.

**Outputs**

- `deleted` (true/false): True: it's deleted, with its files
- `id` (number): The deleted bookmark's number
- `title` (text): Its title
- `url` (text): The address it bookmarked

**Example output**

```json
{
  "deleted": true,
  "id": 42,
  "title": "How to brew coffee",
  "url": "https://example.com/articles/how-to-brew-coffee"
}
```

### Delete bundle

Delete a bundle. Its bookmarks stay.

**Inputs**

- Bundle (`bundle`, text, required): The bundle: pick one, or type its name or number.

**Outputs**

- `deleted` (true/false): True: it's deleted; its bookmarks stay
- `id` (number): The deleted bundle's number
- `name` (text): Its name

**Example output**

```json
{
  "deleted": true,
  "id": 3,
  "name": "Work reading"
}
```

### Delete file

Delete one of a bookmark's files.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- File (`asset`, number, required): The file's number, from List files or Upload file. At least 1.

**Outputs**

- `bookmark_id` (number): The number of the bookmark it belonged to
- `deleted` (true/false): True: it's deleted
- `file_name` (text): Its name
- `id` (number): The deleted file's number

**Example output**

```json
{
  "bookmark_id": 42,
  "deleted": true,
  "file_name": "recipe.txt",
  "id": 5
}
```

### Delete tag

Delete a tag. Its bookmarks stay, without the tag.

**Inputs**

- Tag (`tag`, text, required): The tag: pick one, or type its name or number.

**Outputs**

- `deleted` (true/false): True: it's deleted; its bookmarks stay, without it
- `id` (number): The deleted tag's number
- `name` (text): Its name

**Example output**

```json
{
  "deleted": true,
  "id": 7,
  "name": "coffee"
}
```

### Download file

Get one of a bookmark's files: its text when it is text, such as a snapshot of the page, and its contents as base64 when it is 1 MB or smaller. Files over 10 MB are refused.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- File (`asset`, number, required): The file's number, from List files or Upload file. At least 1.

**Outputs**

- `asset_type` (text): snapshot (a copy of the page linkding made) or upload (a file added)
- `bookmark_id` (number): The number of the bookmark it belongs to
- `content_base64` (text): The file as base64, when it is 1 MB or smaller; empty for bigger files
- `content_type` (text): The file's media type, such as text/html
- `date_created` (text): When it was added (ISO 8601)
- `file_name` (text): The file's name
- `file_size` (number): The size linkding keeps it at, in bytes
- `id` (number): The file's number in linkding
- `size` (number): The size of the downloaded file, in bytes
- `status` (text): complete, pending (a snapshot being made) or failure
- `text` (text): The file's text, when it is text (a page snapshot is HTML); empty for other files
- `text_truncated` (true/false): Whether the text was cut at 200,000 characters

**Example output**

```json
{
  "asset_type": "upload",
  "bookmark_id": 42,
  "content_base64": "UG91ci1vdmVyOiAxNSBnIGNvZmZlZSwgMjUwIGcgd2F0ZXIuCg==",
  "content_type": "text/plain",
  "date_created": "2026-03-02T09:20:00.123456Z",
  "file_name": "recipe.txt",
  "file_size": 58,
  "id": 5,
  "size": 38,
  "status": "complete",
  "text": "Pour-over: 15 g coffee, 250 g water.\n",
  "text_truncated": false
}
```

### Get bookmark

Get one bookmark with its title, description, notes, tags and whether it's unread, shared or archived.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.

**Outputs**

- `archived` (true/false): Whether it's in the archive
- `date_added` (text): When it was saved (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `description` (text): Its description; empty if none
- `favicon_url` (text): A link to the site's icon; empty if linkding has none
- `id` (number): The bookmark's number in linkding
- `link` (text): A link that opens the bookmark's details in linkding
- `notes` (text): Its notes, which can be Markdown; empty if none
- `preview_image_url` (text): A link to the page's preview image; empty if linkding has none
- `shared` (true/false): Whether it's shared with linkding's other users
- `tags` (list): Its tags, by name
- `title` (text): Its title
- `unread` (true/false): Whether it's marked unread
- `url` (text): The address it bookmarks
- `web_archive_snapshot_url` (text): A link to the page on the Internet Archive's Wayback Machine

**Example output**

```json
{
  "archived": false,
  "date_added": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123460Z",
  "description": "A guide to brewing coffee at home.",
  "favicon_url": "",
  "id": 42,
  "link": "https://links.example.com/bookmarks?details=42",
  "notes": "Try the pour-over recipe.",
  "preview_image_url": "",
  "shared": false,
  "tags": [
    "coffee",
    "howto"
  ],
  "title": "How to brew coffee",
  "unread": true,
  "url": "https://example.com/articles/how-to-brew-coffee",
  "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
}
```

### Get bundle

Get one bundle with the search words and tags it filters by.

**Inputs**

- Bundle (`bundle`, text, required): The bundle: pick one, or type its name or number.

**Outputs**

- `all_tags` (list): Tags a bookmark needs all of
- `any_tags` (list): Tags of which a bookmark needs at least one
- `date_created` (text): When it was made (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `excluded_tags` (list): Tags a bookmark must have none of
- `id` (number): The bundle's number in linkding
- `name` (text): The bundle's name
- `order` (number): Its place in linkding's list of bundles, from 0
- `search` (text): The search words its bookmarks match; empty if none
- `shared` (text): Whether it holds only shared (yes), only unshared (no) or any
- `unread` (text): Whether it holds only unread (yes), only read (no) or any

**Example output**

```json
{
  "all_tags": [],
  "any_tags": [
    "work",
    "research"
  ],
  "date_created": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123456Z",
  "excluded_tags": [
    "done"
  ],
  "id": 3,
  "name": "Work reading",
  "order": 0,
  "search": "",
  "shared": "any",
  "unread": "yes"
}
```

### Get tag

Find one tag by its name, whatever its capitals, or its number.

**Inputs**

- Tag (`tag`, text, required): The tag: pick one, or type its name or number.

**Outputs**

- `date_added` (text): When it was made (ISO 8601)
- `id` (number): The tag's number in linkding
- `name` (text): The tag's name

**Example output**

```json
{
  "date_added": "2026-03-02T09:15:00.123456Z",
  "id": 7,
  "name": "coffee"
}
```

### Get user profile

Get the settings of the linkding user the token belongs to, such as whether sharing is on, and linkding's version.

**Inputs**: None.

**Outputs**

- `bookmark_date_display` (text): How bookmark dates are shown: relative, absolute or hidden
- `bookmark_link_target` (text): Where bookmarks open: _blank (a new tab) or _self
- `display_url` (true/false): Whether the bookmark list shows each address
- `enable_favicons` (true/false): Whether linkding loads site icons for bookmarks
- `enable_public_sharing` (true/false): Whether the user's shared bookmarks can be seen without signing in
- `enable_sharing` (true/false): Whether the user can share bookmarks with other users
- `permanent_notes` (true/false): Whether the bookmark list always shows notes
- `tag_search` (text): Whether a search word matches tags only with a # (strict) or not (lax)
- `theme` (text): The user's theme: auto, light or dark
- `version` (text): linkding's version, such as 1.47.0
- `web_archive_integration` (text): Whether new bookmarks are also saved on the Internet Archive: disabled or enabled

**Example output**

```json
{
  "bookmark_date_display": "relative",
  "bookmark_link_target": "_blank",
  "display_url": false,
  "enable_favicons": false,
  "enable_public_sharing": false,
  "enable_sharing": true,
  "permanent_notes": false,
  "tag_search": "strict",
  "theme": "auto",
  "version": "1.47.0",
  "web_archive_integration": "disabled"
}
```

### List bookmarks

List or search bookmarks: by words, tags, a bundle, whether they're unread, shared or archived, and when they were saved or changed.

**Inputs**

- Search (`query`, text): Words to search for in the title, description, notes and address, as in linkding's own search box, such as recipe or #coffee. Leave empty for every bookmark.
- Tags (`tags`, list): Only bookmarks with every one of these tags.
- Bundle (`bundle`, text): Only bookmarks in this bundle (a saved filter): pick one, or type its name or number.
- Archived (`archived`, text): Archived bookmarks (Yes), active ones (No), or both. One of: `any` (Either), `yes`, `no`. Default: `no`.
- Unread (`unread`, text): Only unread bookmarks (Yes), only read ones (No), or both. One of: `any` (Either), `yes`, `no`. Default: `any`.
- Shared (`shared`, text): Only shared bookmarks (Yes), only unshared ones (No), or both. One of: `any` (Either), `yes`, `no`. Default: `any`.
- Saved after (`added_since`, date and time): Only bookmarks saved after this date and time.
- Changed after (`modified_since`, date and time): Only bookmarks saved or changed after this date and time.
- Order (`sort`, text): The order to list them in. One of: `added_desc` (Newest first), `added_asc` (Oldest first), `modified_desc` (Most recently changed first), `modified_asc` (Least recently changed first), `title_asc` (Title, A to Z), `title_desc` (Title, Z to A). Default: `added_desc`.
- How many (`limit`, number): The most bookmarks to list, 1 to 1000. Defaults to 100. From 1 to 1000.

**Outputs**

- `bookmarks` (list): The bookmarks, in the order asked for
- `count` (number): How many bookmarks are listed
- `total` (number): How many matched, before the limit

**Example output**

```json
{
  "bookmarks": [
    {
      "archived": false,
      "date_added": "2026-03-02T09:15:00.123456Z",
      "date_modified": "2026-03-02T09:15:00.123460Z",
      "description": "A guide to brewing coffee at home.",
      "favicon_url": "",
      "id": 42,
      "link": "https://links.example.com/bookmarks?details=42",
      "notes": "Try the pour-over recipe.",
      "preview_image_url": "",
      "shared": false,
      "tags": [
        "coffee",
        "howto"
      ],
      "title": "How to brew coffee",
      "unread": true,
      "url": "https://example.com/articles/how-to-brew-coffee",
      "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
    }
  ],
  "count": 1,
  "total": 1
}
```

### List bundles

List the bundles: saved filters that group bookmarks by search words, tags, and whether they're unread or shared.

**Inputs**: None.

**Outputs**

- `bundles` (list): The bundles, in the order linkding shows them
- `count` (number): How many bundles there are

**Example output**

```json
{
  "bundles": [
    {
      "all_tags": [],
      "any_tags": [
        "work",
        "research"
      ],
      "date_created": "2026-03-02T09:15:00.123456Z",
      "date_modified": "2026-03-02T09:15:00.123456Z",
      "excluded_tags": [
        "done"
      ],
      "id": 3,
      "name": "Work reading",
      "order": 0,
      "search": "",
      "shared": "any",
      "unread": "yes"
    }
  ],
  "count": 1
}
```

### List files

List the files kept with a bookmark: snapshots of the page linkding made, and files added to it.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.

**Outputs**

- `assets` (list): The bookmark's files
- `bookmark_id` (number): The bookmark's number
- `count` (number): How many files it has

**Example output**

```json
{
  "assets": [
    {
      "asset_type": "upload",
      "bookmark_id": 42,
      "content_type": "text/plain",
      "date_created": "2026-03-02T09:20:00.123456Z",
      "file_name": "recipe.txt",
      "file_size": 58,
      "id": 5,
      "status": "complete"
    }
  ],
  "bookmark_id": 42,
  "count": 1
}
```

### List tags

List the tags bookmarks are filed under, A to Z.

**Inputs**

- Search (`search`, text): Only tags whose name has this text, such as read.
- How many (`limit`, number): The most tags to list, 1 to 5000. Defaults to 1000. From 1 to 5000.

**Outputs**

- `count` (number): How many tags are listed
- `tags` (list): The tags, A to Z
- `total` (number): How many matched, before the limit

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "date_added": "2026-03-02T09:15:00.123456Z",
      "id": 7,
      "name": "coffee"
    }
  ],
  "total": 1
}
```

### Unarchive bookmark

Move a bookmark out of the archive, back to the active list.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.

**Outputs**

- `archived` (true/false): Whether it's in the archive
- `date_added` (text): When it was saved (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `description` (text): Its description; empty if none
- `favicon_url` (text): A link to the site's icon; empty if linkding has none
- `id` (number): The bookmark's number in linkding
- `link` (text): A link that opens the bookmark's details in linkding
- `notes` (text): Its notes, which can be Markdown; empty if none
- `preview_image_url` (text): A link to the page's preview image; empty if linkding has none
- `shared` (true/false): Whether it's shared with linkding's other users
- `tags` (list): Its tags, by name
- `title` (text): Its title
- `unread` (true/false): Whether it's marked unread
- `url` (text): The address it bookmarks
- `web_archive_snapshot_url` (text): A link to the page on the Internet Archive's Wayback Machine

**Example output**

```json
{
  "archived": false,
  "date_added": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123460Z",
  "description": "A guide to brewing coffee at home.",
  "favicon_url": "",
  "id": 42,
  "link": "https://links.example.com/bookmarks?details=42",
  "notes": "Try the pour-over recipe.",
  "preview_image_url": "",
  "shared": false,
  "tags": [
    "coffee",
    "howto"
  ],
  "title": "How to brew coffee",
  "unread": true,
  "url": "https://example.com/articles/how-to-brew-coffee",
  "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
}
```

### Update bookmark

Change a bookmark's address, title, description, notes or tags, or mark it unread or read, shared or not. What you leave empty stays as it is.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- URL (`url`, text): A new web address for the bookmark. Leave empty to keep it.
- Title (`title`, text): The bookmark's title. Leave empty to keep it.
- Description (`description`, text): A short description. Leave empty to keep it.
- Notes (`notes`, text): Your own notes on the bookmark; Markdown works. Leave empty to keep it.
- Tags (`tags`, list): The bookmark's tags become exactly these. Leave empty to keep its tags.
- Add tags (`add_tags`, list): Tags to add to the ones it has. Ones that don't exist are made.
- Remove tags (`remove_tags`, list): Tags to take off the bookmark.
- Unread (`unread`, true/false): Mark it unread (on) or read (off). Leave unset to keep it.
- Shared (`shared`, true/false): Share it (on) or stop sharing it (off). Leave unset to keep it.

**Outputs**

- `archived` (true/false): Whether it's in the archive
- `date_added` (text): When it was saved (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `description` (text): Its description; empty if none
- `favicon_url` (text): A link to the site's icon; empty if linkding has none
- `id` (number): The bookmark's number in linkding
- `link` (text): A link that opens the bookmark's details in linkding
- `notes` (text): Its notes, which can be Markdown; empty if none
- `preview_image_url` (text): A link to the page's preview image; empty if linkding has none
- `shared` (true/false): Whether it's shared with linkding's other users
- `tags` (list): Its tags, by name
- `title` (text): Its title
- `unread` (true/false): Whether it's marked unread
- `url` (text): The address it bookmarks
- `web_archive_snapshot_url` (text): A link to the page on the Internet Archive's Wayback Machine

**Example output**

```json
{
  "archived": false,
  "date_added": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123460Z",
  "description": "A guide to brewing coffee at home.",
  "favicon_url": "",
  "id": 42,
  "link": "https://links.example.com/bookmarks?details=42",
  "notes": "Try the pour-over recipe.",
  "preview_image_url": "",
  "shared": false,
  "tags": [
    "coffee",
    "howto"
  ],
  "title": "How to brew coffee",
  "unread": true,
  "url": "https://example.com/articles/how-to-brew-coffee",
  "web_archive_snapshot_url": "https://web.archive.org/web/20260302091500/https://example.com/articles/how-to-brew-coffee"
}
```

### Update bundle

Rename a bundle or change what it filters by. What you leave empty stays as it is.

**Inputs**

- Bundle (`bundle`, text, required): The bundle: pick one, or type its name or number.
- New name (`name`, text): Its new name. Leave empty to keep it.
- Search (`search`, text): Words a bookmark must have in its title, description, notes or address, such as recipe. Leave empty to keep it.
- Any of these tags (`any_tags`, list): A bookmark needs at least one of these tags. Leave empty to keep it.
- All of these tags (`all_tags`, list): A bookmark needs every one of these tags. Leave empty to keep it.
- None of these tags (`excluded_tags`, list): A bookmark with any of these tags is left out. Leave empty to keep it.
- Unread (`unread`, text): Only unread bookmarks (Yes), only read ones (No), or both. Leave unset to keep it. One of: `any` (Either), `yes`, `no`.
- Shared (`shared`, text): Only shared bookmarks (Yes), only unshared ones (No), or both. Leave unset to keep it. One of: `any` (Either), `yes`, `no`.

**Outputs**

- `all_tags` (list): Tags a bookmark needs all of
- `any_tags` (list): Tags of which a bookmark needs at least one
- `date_created` (text): When it was made (ISO 8601)
- `date_modified` (text): When it was last changed (ISO 8601)
- `excluded_tags` (list): Tags a bookmark must have none of
- `id` (number): The bundle's number in linkding
- `name` (text): The bundle's name
- `order` (number): Its place in linkding's list of bundles, from 0
- `search` (text): The search words its bookmarks match; empty if none
- `shared` (text): Whether it holds only shared (yes), only unshared (no) or any
- `unread` (text): Whether it holds only unread (yes), only read (no) or any

**Example output**

```json
{
  "all_tags": [],
  "any_tags": [
    "work",
    "research"
  ],
  "date_created": "2026-03-02T09:15:00.123456Z",
  "date_modified": "2026-03-02T09:15:00.123456Z",
  "excluded_tags": [
    "done"
  ],
  "id": 3,
  "name": "Work reading",
  "order": 0,
  "search": "",
  "shared": "any",
  "unread": "yes"
}
```

### Upload file

Add a file to a bookmark, from a link to the file or from text, such as a PDF of the page or a summary.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- File link (`file_url`, text): A link anyone can download the file from, starting with https://. Leave empty to save text instead.
- Text (`text`, text): Words to save as a text file, when you give no link.
- File name (`file_name`, text): The name to give the file, with its extension, such as summary.txt. Leave empty to use the link's own name, or note.txt for text.

**Outputs**

- `asset_type` (text): snapshot (a copy of the page linkding made) or upload (a file added)
- `bookmark_id` (number): The number of the bookmark it belongs to
- `content_type` (text): The file's media type, such as text/html
- `date_created` (text): When it was added (ISO 8601)
- `file_name` (text): The file's name
- `file_size` (number): The size linkding keeps it at, in bytes
- `id` (number): The file's number in linkding
- `status` (text): complete, pending (a snapshot being made) or failure

**Example output**

```json
{
  "asset_type": "upload",
  "bookmark_id": 42,
  "content_type": "text/plain",
  "date_created": "2026-03-02T09:20:00.123456Z",
  "file_name": "recipe.txt",
  "file_size": 58,
  "id": 5,
  "status": "complete"
}
```
