linkding

App · 22 actions

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.

Actions

ActionWhat it does
Archive bookmarkMove a bookmark to the archive, out of the active list.
Check a URLCheck 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.
Create bookmarkSave a web address as a bookmark, with tags and notes.
Create bundleMake a bundle: a saved filter that groups bookmarks by search words, tags, and whether they're unread or shared.
Create tagMake a tag to file bookmarks under.
Delete bookmarkDelete a bookmark for good, with its files.
Delete bundleDelete a bundle.
Delete fileDelete one of a bookmark's files.
Delete tagDelete a tag.
Download fileGet 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.
Get bookmarkGet one bookmark with its title, description, notes, tags and whether it's unread, shared or archived.
Get bundleGet one bundle with the search words and tags it filters by.
Get tagFind one tag by its name, whatever its capitals, or its number.
Get user profileGet the settings of the linkding user the token belongs to, such as whether sharing is on, and linkding's version.
List bookmarksList or search bookmarks: by words, tags, a bundle, whether they're unread, shared or archived, and when they were saved or changed.
List bundlesList the bundles: saved filters that group bookmarks by search words, tags, and whether they're unread or shared.
List filesList the files kept with a bookmark: snapshots of the page linkding made, and files added to it.
List tagsList the tags bookmarks are filed under, A to Z.
Unarchive bookmarkMove a bookmark out of the archive, back to the active list.
Update bookmarkChange a bookmark's address, title, description, notes or tags, or mark it unread or read, shared or not.
Update bundleRename a bundle or change what it filters by.
Upload fileAdd a file to a bookmark, from a link to the file or from text, such as a PDF of the page or a summary.

Archive bookmark

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

Inputs

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

Outputs

archivedtrue/false
Whether it's in the archive
date_addedtext
When it was saved (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
descriptiontext
Its description; empty if none
favicon_urltext
A link to the site's icon; empty if linkding has none
idnumber
The bookmark's number in linkding
linktext
A link that opens the bookmark's details in linkding
notestext
Its notes, which can be Markdown; empty if none
preview_image_urltext
A link to the page's preview image; empty if linkding has none
sharedtrue/false
Whether it's shared with linkding's other users
tagslist
Its tags, by name
titletext
Its title
unreadtrue/false
Whether it's marked unread
urltext
The address it bookmarks
web_archive_snapshot_urltext
A link to the page on the Internet Archive's Wayback Machine
Example output
{
  "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

URLurltextRequired
The web address to check, such as https://example.com/article.

Outputs

auto_tagslist
The tags linkding's auto tagging rules would give a bookmark of this address
bookmarkobject
The bookmark for the address; null if it isn't bookmarked
bookmark_idnumber
The bookmark's number; 0 if it isn't bookmarked
bookmarkedtrue/false
Whether the address is already bookmarked
page_descriptiontext
The description linkding finds on the page; empty if none
page_preview_imagetext
The preview image linkding finds on the page; empty if none
page_titletext
The title linkding finds on the page; empty if none
urltext
The address checked
Example output
{
  "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

URLurltextRequired
The web address to bookmark, such as https://example.com/article.
Titletitletext
The bookmark's title. Leave empty to use the page's own title.
Descriptiondescriptiontext
A short description. Leave empty to use the page's own description.
Notesnotestext
Your own notes on the bookmark; Markdown works.
Tagstagslist
Tags to file it under, by name, such as reading-list. Ones that don't exist are made.
Mark as unreadunreadtrue/false
Mark the bookmark unread, to read later.
Sharesharedtrue/false
Share the bookmark with linkding's other users. Sharing has to be turned on in linkding's settings.
Save to the archivearchivedtrue/false
Put the bookmark straight into the archive.
Fetch the page's titlefetch_detailstrue/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 bookmarkedif_existstext
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_existedtrue/false
Whether the address was already bookmarked, so that bookmark was updated or left as it was
archivedtrue/false
Whether it's in the archive
date_addedtext
When it was saved (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
descriptiontext
Its description; empty if none
favicon_urltext
A link to the site's icon; empty if linkding has none
idnumber
The bookmark's number in linkding
linktext
A link that opens the bookmark's details in linkding
notestext
Its notes, which can be Markdown; empty if none
preview_image_urltext
A link to the page's preview image; empty if linkding has none
sharedtrue/false
Whether it's shared with linkding's other users
tagslist
Its tags, by name
titletext
Its title
unreadtrue/false
Whether it's marked unread
urltext
The address it bookmarks
web_archive_snapshot_urltext
A link to the page on the Internet Archive's Wayback Machine
Example output
{
  "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

NamenametextRequired
The bundle's name, such as Work reading.
Searchsearchtext
Words a bookmark must have in its title, description, notes or address, such as recipe.
Any of these tagsany_tagslist
A bookmark needs at least one of these tags.
All of these tagsall_tagslist
A bookmark needs every one of these tags.
None of these tagsexcluded_tagslist
A bookmark with any of these tags is left out.
Unreadunreadtext
Only unread bookmarks (Yes), only read ones (No), or both.One of: any (Either), yes, no. Default: any.
Sharedsharedtext
Only shared bookmarks (Yes), only unshared ones (No), or both.One of: any (Either), yes, no. Default: any.

Outputs

all_tagslist
Tags a bookmark needs all of
any_tagslist
Tags of which a bookmark needs at least one
date_createdtext
When it was made (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
excluded_tagslist
Tags a bookmark must have none of
idnumber
The bundle's number in linkding
nametext
The bundle's name
ordernumber
Its place in linkding's list of bundles, from 0
searchtext
The search words its bookmarks match; empty if none
sharedtext
Whether it holds only shared (yes), only unshared (no) or any
unreadtext
Whether it holds only unread (yes), only read (no) or any
Example output
{
  "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

NamenametextRequired
The tag's name, such as reading-list. A space becomes a hyphen.

Outputs

date_addedtext
When it was made (ISO 8601)
idnumber
The tag's number in linkding
nametext
The tag's name
Example output
{
  "date_added": "2026-03-02T09:15:00.123456Z",
  "id": 7,
  "name": "coffee"
}

Delete bookmark

Delete a bookmark for good, with its files.

Inputs

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

Outputs

deletedtrue/false
True: it's deleted, with its files
idnumber
The deleted bookmark's number
titletext
Its title
urltext
The address it bookmarked
Example output
{
  "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

BundlebundletextRequired
The bundle: pick one, or type its name or number.

Outputs

deletedtrue/false
True: it's deleted; its bookmarks stay
idnumber
The deleted bundle's number
nametext
Its name
Example output
{
  "deleted": true,
  "id": 3,
  "name": "Work reading"
}

Delete file

Delete one of a bookmark's files.

Inputs

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

Outputs

bookmark_idnumber
The number of the bookmark it belonged to
deletedtrue/false
True: it's deleted
file_nametext
Its name
idnumber
The deleted file's number
Example output
{
  "bookmark_id": 42,
  "deleted": true,
  "file_name": "recipe.txt",
  "id": 5
}

Delete tag

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

Inputs

TagtagtextRequired
The tag: pick one, or type its name or number.

Outputs

deletedtrue/false
True: it's deleted; its bookmarks stay, without it
idnumber
The deleted tag's number
nametext
Its name
Example output
{
  "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

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

Outputs

asset_typetext
snapshot (a copy of the page linkding made) or upload (a file added)
bookmark_idnumber
The number of the bookmark it belongs to
content_base64text
The file as base64, when it is 1 MB or smaller; empty for bigger files
content_typetext
The file's media type, such as text/html
date_createdtext
When it was added (ISO 8601)
file_nametext
The file's name
file_sizenumber
The size linkding keeps it at, in bytes
idnumber
The file's number in linkding
sizenumber
The size of the downloaded file, in bytes
statustext
complete, pending (a snapshot being made) or failure
texttext
The file's text, when it is text (a page snapshot is HTML); empty for other files
text_truncatedtrue/false
Whether the text was cut at 200,000 characters
Example output
{
  "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

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

Outputs

archivedtrue/false
Whether it's in the archive
date_addedtext
When it was saved (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
descriptiontext
Its description; empty if none
favicon_urltext
A link to the site's icon; empty if linkding has none
idnumber
The bookmark's number in linkding
linktext
A link that opens the bookmark's details in linkding
notestext
Its notes, which can be Markdown; empty if none
preview_image_urltext
A link to the page's preview image; empty if linkding has none
sharedtrue/false
Whether it's shared with linkding's other users
tagslist
Its tags, by name
titletext
Its title
unreadtrue/false
Whether it's marked unread
urltext
The address it bookmarks
web_archive_snapshot_urltext
A link to the page on the Internet Archive's Wayback Machine
Example output
{
  "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

BundlebundletextRequired
The bundle: pick one, or type its name or number.

Outputs

all_tagslist
Tags a bookmark needs all of
any_tagslist
Tags of which a bookmark needs at least one
date_createdtext
When it was made (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
excluded_tagslist
Tags a bookmark must have none of
idnumber
The bundle's number in linkding
nametext
The bundle's name
ordernumber
Its place in linkding's list of bundles, from 0
searchtext
The search words its bookmarks match; empty if none
sharedtext
Whether it holds only shared (yes), only unshared (no) or any
unreadtext
Whether it holds only unread (yes), only read (no) or any
Example output
{
  "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

TagtagtextRequired
The tag: pick one, or type its name or number.

Outputs

date_addedtext
When it was made (ISO 8601)
idnumber
The tag's number in linkding
nametext
The tag's name
Example output
{
  "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_displaytext
How bookmark dates are shown: relative, absolute or hidden
bookmark_link_targettext
Where bookmarks open: _blank (a new tab) or _self
display_urltrue/false
Whether the bookmark list shows each address
enable_faviconstrue/false
Whether linkding loads site icons for bookmarks
enable_public_sharingtrue/false
Whether the user's shared bookmarks can be seen without signing in
enable_sharingtrue/false
Whether the user can share bookmarks with other users
permanent_notestrue/false
Whether the bookmark list always shows notes
tag_searchtext
Whether a search word matches tags only with a # (strict) or not (lax)
themetext
The user's theme: auto, light or dark
versiontext
linkding's version, such as 1.47.0
web_archive_integrationtext
Whether new bookmarks are also saved on the Internet Archive: disabled or enabled
Example output
{
  "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

Searchquerytext
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.
Tagstagslist
Only bookmarks with every one of these tags.
Bundlebundletext
Only bookmarks in this bundle (a saved filter): pick one, or type its name or number.
Archivedarchivedtext
Archived bookmarks (Yes), active ones (No), or both.One of: any (Either), yes, no. Default: no.
Unreadunreadtext
Only unread bookmarks (Yes), only read ones (No), or both.One of: any (Either), yes, no. Default: any.
Sharedsharedtext
Only shared bookmarks (Yes), only unshared ones (No), or both.One of: any (Either), yes, no. Default: any.
Saved afteradded_sincedate and time
Only bookmarks saved after this date and time.
Changed aftermodified_sincedate and time
Only bookmarks saved or changed after this date and time.
Ordersorttext
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 manylimitnumber
The most bookmarks to list, 1 to 1000. Defaults to 100.From 1 to 1000.

Outputs

bookmarkslist
The bookmarks, in the order asked for
countnumber
How many bookmarks are listed
totalnumber
How many matched, before the limit
Example output
{
  "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

bundleslist
The bundles, in the order linkding shows them
countnumber
How many bundles there are
Example output
{
  "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

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

Outputs

assetslist
The bookmark's files
bookmark_idnumber
The bookmark's number
countnumber
How many files it has
Example output
{
  "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

Searchsearchtext
Only tags whose name has this text, such as read.
How manylimitnumber
The most tags to list, 1 to 5000. Defaults to 1000.From 1 to 5000.

Outputs

countnumber
How many tags are listed
tagslist
The tags, A to Z
totalnumber
How many matched, before the limit
Example output
{
  "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

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

Outputs

archivedtrue/false
Whether it's in the archive
date_addedtext
When it was saved (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
descriptiontext
Its description; empty if none
favicon_urltext
A link to the site's icon; empty if linkding has none
idnumber
The bookmark's number in linkding
linktext
A link that opens the bookmark's details in linkding
notestext
Its notes, which can be Markdown; empty if none
preview_image_urltext
A link to the page's preview image; empty if linkding has none
sharedtrue/false
Whether it's shared with linkding's other users
tagslist
Its tags, by name
titletext
Its title
unreadtrue/false
Whether it's marked unread
urltext
The address it bookmarks
web_archive_snapshot_urltext
A link to the page on the Internet Archive's Wayback Machine
Example output
{
  "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

BookmarkbookmarktextRequired
The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
URLurltext
A new web address for the bookmark. Leave empty to keep it.
Titletitletext
The bookmark's title. Leave empty to keep it.
Descriptiondescriptiontext
A short description. Leave empty to keep it.
Notesnotestext
Your own notes on the bookmark; Markdown works. Leave empty to keep it.
Tagstagslist
The bookmark's tags become exactly these. Leave empty to keep its tags.
Add tagsadd_tagslist
Tags to add to the ones it has. Ones that don't exist are made.
Remove tagsremove_tagslist
Tags to take off the bookmark.
Unreadunreadtrue/false
Mark it unread (on) or read (off). Leave unset to keep it.
Sharedsharedtrue/false
Share it (on) or stop sharing it (off). Leave unset to keep it.

Outputs

archivedtrue/false
Whether it's in the archive
date_addedtext
When it was saved (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
descriptiontext
Its description; empty if none
favicon_urltext
A link to the site's icon; empty if linkding has none
idnumber
The bookmark's number in linkding
linktext
A link that opens the bookmark's details in linkding
notestext
Its notes, which can be Markdown; empty if none
preview_image_urltext
A link to the page's preview image; empty if linkding has none
sharedtrue/false
Whether it's shared with linkding's other users
tagslist
Its tags, by name
titletext
Its title
unreadtrue/false
Whether it's marked unread
urltext
The address it bookmarks
web_archive_snapshot_urltext
A link to the page on the Internet Archive's Wayback Machine
Example output
{
  "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

BundlebundletextRequired
The bundle: pick one, or type its name or number.
New namenametext
Its new name. Leave empty to keep it.
Searchsearchtext
Words a bookmark must have in its title, description, notes or address, such as recipe. Leave empty to keep it.
Any of these tagsany_tagslist
A bookmark needs at least one of these tags. Leave empty to keep it.
All of these tagsall_tagslist
A bookmark needs every one of these tags. Leave empty to keep it.
None of these tagsexcluded_tagslist
A bookmark with any of these tags is left out. Leave empty to keep it.
Unreadunreadtext
Only unread bookmarks (Yes), only read ones (No), or both. Leave unset to keep it.One of: any (Either), yes, no.
Sharedsharedtext
Only shared bookmarks (Yes), only unshared ones (No), or both. Leave unset to keep it.One of: any (Either), yes, no.

Outputs

all_tagslist
Tags a bookmark needs all of
any_tagslist
Tags of which a bookmark needs at least one
date_createdtext
When it was made (ISO 8601)
date_modifiedtext
When it was last changed (ISO 8601)
excluded_tagslist
Tags a bookmark must have none of
idnumber
The bundle's number in linkding
nametext
The bundle's name
ordernumber
Its place in linkding's list of bundles, from 0
searchtext
The search words its bookmarks match; empty if none
sharedtext
Whether it holds only shared (yes), only unshared (no) or any
unreadtext
Whether it holds only unread (yes), only read (no) or any
Example output
{
  "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

BookmarkbookmarktextRequired
The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
File linkfile_urltext
A link anyone can download the file from, starting with https://. Leave empty to save text instead.
Texttexttext
Words to save as a text file, when you give no link.
File namefile_nametext
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_typetext
snapshot (a copy of the page linkding made) or upload (a file added)
bookmark_idnumber
The number of the bookmark it belongs to
content_typetext
The file's media type, such as text/html
date_createdtext
When it was added (ISO 8601)
file_nametext
The file's name
file_sizenumber
The size linkding keeps it at, in bytes
idnumber
The file's number in linkding
statustext
complete, pending (a snapshot being made) or failure
Example output
{
  "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"
}

On this page