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
| Action | What it does |
|---|---|
| Archive bookmark | Move a bookmark to the archive, out of the active list. |
| 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. |
| Create bookmark | Save a web address as a bookmark, with tags and notes. |
| Create bundle | Make a bundle: a saved filter that groups bookmarks by search words, tags, and whether they're unread or shared. |
| Create tag | Make a tag to file bookmarks under. |
| Delete bookmark | Delete a bookmark for good, with its files. |
| Delete bundle | Delete a bundle. |
| Delete file | Delete one of a bookmark's files. |
| Delete tag | Delete a tag. |
| 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. |
| Get bookmark | Get one bookmark with its title, description, notes, tags and whether it's unread, shared or archived. |
| Get bundle | Get one bundle with the search words and tags it filters by. |
| Get tag | Find one tag by its name, whatever its capitals, or its number. |
| Get user profile | Get the settings of the linkding user the token belongs to, such as whether sharing is on, and linkding's version. |
| 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. |
| List bundles | List the bundles: saved filters that group bookmarks by search words, tags, and whether they're unread or shared. |
| List files | List the files kept with a bookmark: snapshots of the page linkding made, and files added to it. |
| List tags | List the tags bookmarks are filed under, A to Z. |
| Unarchive bookmark | Move a bookmark out of the archive, back to the active list. |
| Update bookmark | Change a bookmark's address, title, description, notes or tags, or mark it unread or read, shared or not. |
| Update bundle | Rename a bundle or change what it filters by. |
| 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. |
Archive bookmark
Move a bookmark to the archive, out of the active list.
Inputs
- Bookmark
bookmarktextRequired - 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
- URL
urltextRequired - 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
- URL
urltextRequired - The web address to bookmark, such as https://example.com/article.
- Title
titletext - The bookmark's title. Leave empty to use the page's own title.
- Description
descriptiontext - A short description. Leave empty to use the page's own description.
- Notes
notestext - Your own notes on the bookmark; Markdown works.
- Tags
tagslist - Tags to file it under, by name, such as reading-list. Ones that don't exist are made.
- Mark as unread
unreadtrue/false - Mark the bookmark unread, to read later.
- Share
sharedtrue/false - Share the bookmark with linkding's other users. Sharing has to be turned on in linkding's settings.
- Save to the archive
archivedtrue/false - Put the bookmark straight into the archive.
- Fetch the page's title
fetch_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 bookmarked
if_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
- Name
nametextRequired - The bundle's name, such as Work reading.
- Search
searchtext - Words a bookmark must have in its title, description, notes or address, such as recipe.
- Any of these tags
any_tagslist - A bookmark needs at least one of these tags.
- All of these tags
all_tagslist - A bookmark needs every one of these tags.
- None of these tags
excluded_tagslist - A bookmark with any of these tags is left out.
- Unread
unreadtext - Only unread bookmarks (Yes), only read ones (No), or both.One of:
any(Either),yes,no. Default:any. - Shared
sharedtext - 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
- Name
nametextRequired - 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
- Bookmark
bookmarktextRequired - 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
- Bundle
bundletextRequired - 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
- Bookmark
bookmarktextRequired - The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- File
assetnumberRequired - 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
- Tag
tagtextRequired - 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
- Bookmark
bookmarktextRequired - The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- File
assetnumberRequired - 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
- Bookmark
bookmarktextRequired - 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
- Bundle
bundletextRequired - 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
- Tag
tagtextRequired - 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
- Search
querytext - 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
tagslist - Only bookmarks with every one of these tags.
- Bundle
bundletext - Only bookmarks in this bundle (a saved filter): pick one, or type its name or number.
- Archived
archivedtext - Archived bookmarks (Yes), active ones (No), or both.One of:
any(Either),yes,no. Default:no. - Unread
unreadtext - Only unread bookmarks (Yes), only read ones (No), or both.One of:
any(Either),yes,no. Default:any. - Shared
sharedtext - Only shared bookmarks (Yes), only unshared ones (No), or both.One of:
any(Either),yes,no. Default:any. - Saved after
added_sincedate and time - Only bookmarks saved after this date and time.
- Changed after
modified_sincedate and time - Only bookmarks saved or changed after this date and time.
- Order
sorttext - 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
limitnumber - 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
- Bookmark
bookmarktextRequired - 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
- Search
searchtext - Only tags whose name has this text, such as read.
- How many
limitnumber - 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
- Bookmark
bookmarktextRequired - 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
- Bookmark
bookmarktextRequired - The bookmark: its number (from an earlier step or a trigger) or the address it bookmarks, such as https://example.com/article.
- URL
urltext - A new web address for the bookmark. Leave empty to keep it.
- Title
titletext - The bookmark's title. Leave empty to keep it.
- Description
descriptiontext - A short description. Leave empty to keep it.
- Notes
notestext - Your own notes on the bookmark; Markdown works. Leave empty to keep it.
- Tags
tagslist - The bookmark's tags become exactly these. Leave empty to keep its tags.
- Add tags
add_tagslist - Tags to add to the ones it has. Ones that don't exist are made.
- Remove tags
remove_tagslist - Tags to take off the bookmark.
- Unread
unreadtrue/false - Mark it unread (on) or read (off). Leave unset to keep it.
- Shared
sharedtrue/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
- Bundle
bundletextRequired - The bundle: pick one, or type its name or number.
- New name
nametext - Its new name. Leave empty to keep it.
- Search
searchtext - 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_tagslist - A bookmark needs at least one of these tags. Leave empty to keep it.
- All of these tags
all_tagslist - A bookmark needs every one of these tags. Leave empty to keep it.
- None of these tags
excluded_tagslist - A bookmark with any of these tags is left out. Leave empty to keep it.
- Unread
unreadtext - Only unread bookmarks (Yes), only read ones (No), or both. Leave unset to keep it.One of:
any(Either),yes,no. - Shared
sharedtext - 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
- Bookmark
bookmarktextRequired - 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_urltext - A link anyone can download the file from, starting with https://. Leave empty to save text instead.
- Text
texttext - Words to save as a text file, when you give no link.
- File name
file_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"
}