Linkwarden
App · 11 actions
Save and find bookmarks in Linkwarden: save links into collections with tags, get a page's saved text, pin, move and delete links, manage collections, and start a workflow when a link is saved.
Actions
| Action | What it does |
|---|---|
| Create collection | Create a collection, such as for a project, at the top or inside another. |
| Delete collection | Delete an empty collection. |
| Delete link | Delete a link and Linkwarden's saved copies of its page. |
| Delete tag | Delete a tag. |
| Find links | Find saved links by words, collection or tag, or only pinned ones, newest first or in the order you choose. |
| Get link | Get a link with the page's readable text as Linkwarden saved it, such as for an AI summary, and the readable page as HTML if you ask. |
| List collections | List the collections you can reach, yours and those shared with you, with how many links each has. |
| List tags | List your tags, with how many links have each. |
| Pin or unpin link | Pin a link to your Linkwarden dashboard, or unpin it. |
| Save link | Save a page to Linkwarden, in a collection with tags and a description. |
| Update link | Rename a link, change its description, move it to another collection, or add and take off tags. |
Create collection
Create a collection, such as for a project, at the top or inside another. One of that name already there is answered as it is.
Inputs
- Name
nametextRequired - The collection's name.
- Description
descriptiontext - What it is for.
- Inside
parenttext - Make it inside this collection. Leave blank for the top.
Outputs
already_existedtrue/false- Whether a collection of that name was already there
descriptiontext- Its description
idnumber- The collection's ID
linktext- A link to it in Linkwarden
link_countnumber- How many links are in it
nametext- Its name
parent_idnumber- The ID of the collection it is in; 0 at the top
pathtext- Its name with the collections it is in, such as Work / Reading
publictrue/false- Whether anyone with its link can see it
sharedtrue/false- Whether it is shared with other people
Example output
{
"already_existed": false,
"description": "Things to read",
"id": 3,
"link": "https://cloud.linkwarden.app/collections/3",
"link_count": 0,
"name": "Reading",
"parent_id": 0,
"path": "Reading",
"public": false,
"shared": false
}Delete collection
Delete an empty collection. One with links or collections in it is refused, because Linkwarden would delete them too.
Inputs
- Collection
collectiontextRequired - The collection to delete: its name or ID.
Outputs
deletedtrue/false- Always true
idnumber- The collection's ID
nametext- Its name
pathtext- Its name with the collections it was in
Example output
{
"deleted": true,
"id": 3,
"name": "Reading",
"path": "Reading"
}Delete link
Delete a link and Linkwarden's saved copies of its page.
Inputs
- Link
linktextRequired - The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).
Outputs
collectiontext- The collection it was in
deletedtrue/false- Always true
idnumber- The link's ID
nametext- Its name
urltext- Its address
Example output
{
"collection": "Reading",
"deleted": true,
"id": 42,
"name": "Why small teams ship faster",
"url": "https://blog.example.com/small-teams"
}Delete tag
Delete a tag. It comes off every link it's on; the links stay.
Inputs
- Tag
tagtextRequired - The tag to delete: its name or ID.
Outputs
deletedtrue/false- Always true
idnumber- The tag's ID
link_countnumber- How many links it was taken off
nametext- Its name
Example output
{
"deleted": true,
"id": 7,
"link_count": 4,
"name": "teams"
}Find links
Find saved links by words, collection or tag, or only pinned ones, newest first or in the order you choose.
Inputs
- Words
searchtext - Only links with these words in their name, address, description or tags.
- Collection
collectiontext - Only links in this collection.
- Tag
tagtext - Only links with this tag.
- Pinned only
pinnedtrue/false - Only links you've pinned.
- Order
sorttext - Which come first.One of:
newest(Newest first),oldest(Oldest first),name_az(Name A to Z),name_za(Name Z to A). Default:newest. - How many
limitnumber - The most to list, up to 200. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many links are listed
linkslist- The links found
moretrue/false- Whether more links match than are listed
Example output
{
"count": 1,
"links": [
{
"archive_status": "saved",
"archived_at": "2026-11-02T10:00:31Z",
"collection": "Reading",
"collection_id": 3,
"created_at": "2026-11-02T10:00:00Z",
"description": "For the Friday reading list",
"id": 42,
"link": "https://cloud.linkwarden.app/links/42",
"name": "Why small teams ship faster",
"pinned": false,
"readable_link": "https://cloud.linkwarden.app/preserved/42?format=3",
"saved_formats": [
"webpage",
"screenshot",
"pdf",
"readable"
],
"tags": [
"teams",
"process"
],
"type": "url",
"updated_at": "2026-11-02T10:00:31Z",
"url": "https://blog.example.com/small-teams"
}
],
"more": false
}Get link
Get a link with the page's readable text as Linkwarden saved it, such as for an AI summary, and the readable page as HTML if you ask.
Inputs
- Link
linktextRequired - The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).
- Include the readable page as HTML
include_htmltrue/false - Also get the readable page as HTML, for an email or a page.
Outputs
archive_statustext- Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
archived_attext- When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
collectiontext- The collection it is in
collection_idnumber- The collection's ID
created_attext- When it was saved (ISO 8601)
descriptiontext- Its description
has_texttrue/false- Whether Linkwarden has the page's readable text
htmltext- The readable page as HTML, when asked for and Linkwarden has it
idnumber- The link's ID in Linkwarden
linktext- A link to it in Linkwarden
nametext- Its name, the page's title unless one was given
pinnedtrue/false- Whether you've pinned it
readable_linktext- A link to its readable copy in Linkwarden, once there is one
saved_formatslist- The copies Linkwarden has saved: webpage, screenshot, pdf, readable
tagslist- Its tags
texttext- The page's readable text, as Linkwarden saved it; empty until it has
typetext- url for a web page, pdf or image for a file
updated_attext- When it last changed (ISO 8601)
urltext- The page's address
Example output
{
"archive_status": "saved",
"archived_at": "2026-11-02T10:00:31Z",
"collection": "Reading",
"collection_id": 3,
"created_at": "2026-11-02T10:00:00Z",
"description": "For the Friday reading list",
"has_text": true,
"html": "",
"id": 42,
"link": "https://cloud.linkwarden.app/links/42",
"name": "Why small teams ship faster",
"pinned": false,
"readable_link": "https://cloud.linkwarden.app/preserved/42?format=3",
"saved_formats": [
"webpage",
"screenshot",
"pdf",
"readable"
],
"tags": [
"teams",
"process"
],
"text": "Small teams ship faster because they talk more and wait less.",
"type": "url",
"updated_at": "2026-11-02T10:00:31Z",
"url": "https://blog.example.com/small-teams"
}List collections
List the collections you can reach, yours and those shared with you, with how many links each has.
Inputs
None.
Outputs
collectionslist- The collections, by name
countnumber- How many collections are listed
Example output
{
"collections": [
{
"description": "Things to read",
"id": 3,
"link": "https://cloud.linkwarden.app/collections/3",
"link_count": 12,
"name": "Reading",
"parent_id": 0,
"path": "Reading",
"public": false,
"shared": false
}
],
"count": 1
}List tags
List your tags, with how many links have each.
Inputs
None.
Outputs
countnumber- How many tags are listed
tagslist- The tags, by name
Example output
{
"count": 1,
"tags": [
{
"id": 7,
"link": "https://cloud.linkwarden.app/tags/7",
"link_count": 4,
"name": "teams"
}
]
}Pin or unpin link
Pin a link to your Linkwarden dashboard, or unpin it. One already as asked is left as it is.
Inputs
- Link
linktextRequired - The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).
- Pin or unpin
pinnedtext - Whether to pin it or unpin it.One of:
pin,unpin. Default:pin.
Outputs
archive_statustext- Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
archived_attext- When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
collectiontext- The collection it is in
collection_idnumber- The collection's ID
created_attext- When it was saved (ISO 8601)
descriptiontext- Its description
idnumber- The link's ID in Linkwarden
linktext- A link to it in Linkwarden
nametext- Its name, the page's title unless one was given
pinnedtrue/false- Whether you've pinned it
readable_linktext- A link to its readable copy in Linkwarden, once there is one
saved_formatslist- The copies Linkwarden has saved: webpage, screenshot, pdf, readable
tagslist- Its tags
typetext- url for a web page, pdf or image for a file
updated_attext- When it last changed (ISO 8601)
urltext- The page's address
Example output
{
"archive_status": "saved",
"archived_at": "2026-11-02T10:00:31Z",
"collection": "Reading",
"collection_id": 3,
"created_at": "2026-11-02T10:00:00Z",
"description": "For the Friday reading list",
"id": 42,
"link": "https://cloud.linkwarden.app/links/42",
"name": "Why small teams ship faster",
"pinned": true,
"readable_link": "https://cloud.linkwarden.app/preserved/42?format=3",
"saved_formats": [
"webpage",
"screenshot",
"pdf",
"readable"
],
"tags": [
"teams",
"process"
],
"type": "url",
"updated_at": "2026-11-02T10:00:31Z",
"url": "https://blog.example.com/small-teams"
}Save link
Save a page to Linkwarden, in a collection with tags and a description. Linkwarden then saves its own copy of the page. A page already saved in that collection is left as it is.
Inputs
- Address
urltextRequired - The page's address, such as https://example.com/article.
- Name
nametext - A name for it. Leave blank to use the page's own title.
- Description
descriptiontext - A note about it.
- Collection
collectiontext - Where to save it. A name that isn't there yet makes a new collection. Leave blank for Unorganized.
- Tags
tagslist - Tags to give it; a new name makes a new tag.
Outputs
already_savedtrue/false- Whether the page was already saved in that collection, and was left as it was
archive_statustext- Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
archived_attext- When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
collectiontext- The collection it is in
collection_idnumber- The collection's ID
created_attext- When it was saved (ISO 8601)
descriptiontext- Its description
idnumber- The link's ID in Linkwarden
linktext- A link to it in Linkwarden
nametext- Its name, the page's title unless one was given
pinnedtrue/false- Whether you've pinned it
readable_linktext- A link to its readable copy in Linkwarden, once there is one
saved_formatslist- The copies Linkwarden has saved: webpage, screenshot, pdf, readable
tagslist- Its tags
typetext- url for a web page, pdf or image for a file
updated_attext- When it last changed (ISO 8601)
urltext- The page's address
Example output
{
"already_saved": false,
"archive_status": "saving",
"archived_at": "",
"collection": "Reading",
"collection_id": 3,
"created_at": "2026-11-02T10:00:00Z",
"description": "For the Friday reading list",
"id": 42,
"link": "https://cloud.linkwarden.app/links/42",
"name": "Why small teams ship faster",
"pinned": false,
"readable_link": "",
"saved_formats": [],
"tags": [
"teams",
"process"
],
"type": "url",
"updated_at": "2026-11-02T10:00:31Z",
"url": "https://blog.example.com/small-teams"
}Update link
Rename a link, change its description, move it to another collection, or add and take off tags. Blank fields keep what's there.
Inputs
- Link
linktextRequired - The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).
- Name
nametext - A new name for it.
- Description
descriptiontext - A new description for it.
- Collection
collectiontext - Move it to this collection.
- Add tags
add_tagslist - Tags to add; a new name makes a new tag. Its other tags stay.
- Remove tags
remove_tagslist - Tags to take off it.
Outputs
archive_statustext- Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
archived_attext- When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
collectiontext- The collection it is in
collection_idnumber- The collection's ID
created_attext- When it was saved (ISO 8601)
descriptiontext- Its description
idnumber- The link's ID in Linkwarden
linktext- A link to it in Linkwarden
nametext- Its name, the page's title unless one was given
pinnedtrue/false- Whether you've pinned it
readable_linktext- A link to its readable copy in Linkwarden, once there is one
saved_formatslist- The copies Linkwarden has saved: webpage, screenshot, pdf, readable
tagslist- Its tags
typetext- url for a web page, pdf or image for a file
updated_attext- When it last changed (ISO 8601)
urltext- The page's address
Example output
{
"archive_status": "saved",
"archived_at": "2026-11-02T10:00:31Z",
"collection": "Reading",
"collection_id": 3,
"created_at": "2026-11-02T10:00:00Z",
"description": "For the Friday reading list",
"id": 42,
"link": "https://cloud.linkwarden.app/links/42",
"name": "Why small teams ship faster",
"pinned": false,
"readable_link": "https://cloud.linkwarden.app/preserved/42?format=3",
"saved_formats": [
"webpage",
"screenshot",
"pdf",
"readable"
],
"tags": [
"teams",
"process"
],
"type": "url",
"updated_at": "2026-11-02T10:00:31Z",
"url": "https://blog.example.com/small-teams"
}