# Linkwarden

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

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/linkwarden

## Actions

### 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 (`name`, text, required): The collection's name.
- Description (`description`, text): What it is for.
- Inside (`parent`, text): Make it inside this collection. Leave blank for the top.

**Outputs**

- `already_existed` (true/false): Whether a collection of that name was already there
- `description` (text): Its description
- `id` (number): The collection's ID
- `link` (text): A link to it in Linkwarden
- `link_count` (number): How many links are in it
- `name` (text): Its name
- `parent_id` (number): The ID of the collection it is in; 0 at the top
- `path` (text): Its name with the collections it is in, such as Work / Reading
- `public` (true/false): Whether anyone with its link can see it
- `shared` (true/false): Whether it is shared with other people

**Example output**

```json
{
  "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 (`collection`, text, required): The collection to delete: its name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The collection's ID
- `name` (text): Its name
- `path` (text): Its name with the collections it was in

**Example output**

```json
{
  "deleted": true,
  "id": 3,
  "name": "Reading",
  "path": "Reading"
}
```

### Delete link

Delete a link and Linkwarden's saved copies of its page.

**Inputs**

- Link (`link`, text, required): The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).

**Outputs**

- `collection` (text): The collection it was in
- `deleted` (true/false): Always true
- `id` (number): The link's ID
- `name` (text): Its name
- `url` (text): Its address

**Example output**

```json
{
  "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 (`tag`, text, required): The tag to delete: its name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The tag's ID
- `link_count` (number): How many links it was taken off
- `name` (text): Its name

**Example output**

```json
{
  "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 (`search`, text): Only links with these words in their name, address, description or tags.
- Collection (`collection`, text): Only links in this collection.
- Tag (`tag`, text): Only links with this tag.
- Pinned only (`pinned`, true/false): Only links you've pinned.
- Order (`sort`, text): 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 (`limit`, number): The most to list, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many links are listed
- `links` (list): The links found
- `more` (true/false): Whether more links match than are listed

**Example output**

```json
{
  "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 (`link`, text, required): 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_html`, true/false): Also get the readable page as HTML, for an email or a page.

**Outputs**

- `archive_status` (text): Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
- `archived_at` (text): When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
- `collection` (text): The collection it is in
- `collection_id` (number): The collection's ID
- `created_at` (text): When it was saved (ISO 8601)
- `description` (text): Its description
- `has_text` (true/false): Whether Linkwarden has the page's readable text
- `html` (text): The readable page as HTML, when asked for and Linkwarden has it
- `id` (number): The link's ID in Linkwarden
- `link` (text): A link to it in Linkwarden
- `name` (text): Its name, the page's title unless one was given
- `pinned` (true/false): Whether you've pinned it
- `readable_link` (text): A link to its readable copy in Linkwarden, once there is one
- `saved_formats` (list): The copies Linkwarden has saved: webpage, screenshot, pdf, readable
- `tags` (list): Its tags
- `text` (text): The page's readable text, as Linkwarden saved it; empty until it has
- `type` (text): url for a web page, pdf or image for a file
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page's address

**Example output**

```json
{
  "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**

- `collections` (list): The collections, by name
- `count` (number): How many collections are listed

**Example output**

```json
{
  "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**

- `count` (number): How many tags are listed
- `tags` (list): The tags, by name

**Example output**

```json
{
  "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 (`link`, text, required): 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 (`pinned`, text): Whether to pin it or unpin it. One of: `pin`, `unpin`. Default: `pin`.

**Outputs**

- `archive_status` (text): Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
- `archived_at` (text): When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
- `collection` (text): The collection it is in
- `collection_id` (number): The collection's ID
- `created_at` (text): When it was saved (ISO 8601)
- `description` (text): Its description
- `id` (number): The link's ID in Linkwarden
- `link` (text): A link to it in Linkwarden
- `name` (text): Its name, the page's title unless one was given
- `pinned` (true/false): Whether you've pinned it
- `readable_link` (text): A link to its readable copy in Linkwarden, once there is one
- `saved_formats` (list): The copies Linkwarden has saved: webpage, screenshot, pdf, readable
- `tags` (list): Its tags
- `type` (text): url for a web page, pdf or image for a file
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page's address

**Example output**

```json
{
  "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 (`url`, text, required): The page's address, such as https://example.com/article.
- Name (`name`, text): A name for it. Leave blank to use the page's own title.
- Description (`description`, text): A note about it.
- Collection (`collection`, text): Where to save it. A name that isn't there yet makes a new collection. Leave blank for Unorganized.
- Tags (`tags`, list): Tags to give it; a new name makes a new tag.

**Outputs**

- `already_saved` (true/false): Whether the page was already saved in that collection, and was left as it was
- `archive_status` (text): Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
- `archived_at` (text): When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
- `collection` (text): The collection it is in
- `collection_id` (number): The collection's ID
- `created_at` (text): When it was saved (ISO 8601)
- `description` (text): Its description
- `id` (number): The link's ID in Linkwarden
- `link` (text): A link to it in Linkwarden
- `name` (text): Its name, the page's title unless one was given
- `pinned` (true/false): Whether you've pinned it
- `readable_link` (text): A link to its readable copy in Linkwarden, once there is one
- `saved_formats` (list): The copies Linkwarden has saved: webpage, screenshot, pdf, readable
- `tags` (list): Its tags
- `type` (text): url for a web page, pdf or image for a file
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page's address

**Example output**

```json
{
  "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 (`link`, text, required): The link's ID, such as one from 'Save link', 'Find links' or a trigger, or its page in Linkwarden (…/links/42).
- Name (`name`, text): A new name for it.
- Description (`description`, text): A new description for it.
- Collection (`collection`, text): Move it to this collection.
- Add tags (`add_tags`, list): Tags to add; a new name makes a new tag. Its other tags stay.
- Remove tags (`remove_tags`, list): Tags to take off it.

**Outputs**

- `archive_status` (text): Where Linkwarden is with its copy of the page: saving, saved, or not_saved when it couldn't reach the page
- `archived_at` (text): When Linkwarden last saved its copy of the page (ISO 8601); empty while it is saving
- `collection` (text): The collection it is in
- `collection_id` (number): The collection's ID
- `created_at` (text): When it was saved (ISO 8601)
- `description` (text): Its description
- `id` (number): The link's ID in Linkwarden
- `link` (text): A link to it in Linkwarden
- `name` (text): Its name, the page's title unless one was given
- `pinned` (true/false): Whether you've pinned it
- `readable_link` (text): A link to its readable copy in Linkwarden, once there is one
- `saved_formats` (list): The copies Linkwarden has saved: webpage, screenshot, pdf, readable
- `tags` (list): Its tags
- `type` (text): url for a web page, pdf or image for a file
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page's address

**Example output**

```json
{
  "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"
}
```
