# Miniflux

> Read your feeds in Miniflux: find, read, star and mark entries, subscribe to feeds, manage categories, and start a workflow when a new entry arrives or one is starred.

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

## Actions

### Create category

Create a category to file feeds in. One of that name already there is answered as it is.

**Inputs**

- Name (`title`, text, required): The category's name.

**Outputs**

- `already_existed` (true/false): Whether a category of that name was already there
- `feed_count` (number): How many feeds are in it
- `id` (number): The category's ID
- `link` (text): A link to it in Miniflux
- `title` (text): Its name
- `unread_count` (number): How many unread entries its feeds have

**Example output**

```json
{
  "already_existed": false,
  "feed_count": 0,
  "id": 3,
  "link": "https://reader.miniflux.app/category/3/entries",
  "title": "Tech",
  "unread_count": 0
}
```

### Delete category

Delete a category with no feeds in it. One with feeds is refused, because Miniflux would unsubscribe from them too.

**Inputs**

- Category (`category`, text, required): The category to delete: its name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The category's ID
- `title` (text): Its name

**Example output**

```json
{
  "deleted": true,
  "id": 3,
  "title": "Tech"
}
```

### Find entries

Find entries by unread or read, starred, category, feed, words or when they were published, newest first, with their content as text and HTML.

**Inputs**

- Read or unread (`status`, text): Which entries to find. One of: `unread`, `read`, `any` (Both). Default: `unread`.
- Starred only (`starred`, true/false): Only entries you've starred.
- Category (`category`, text): Only entries from feeds in this category. Leave blank for every category.
- Feed (`feed`, text): Only entries from this feed. Leave blank for every feed.
- Words (`search`, text): Only entries with these words in their title or content.
- Published after (`published_after`, date and time): Only entries published after this time.
- Order (`order`, text): Which come first. One of: `newest` (Newest first), `oldest` (Oldest first). Default: `newest`.
- How many (`limit`, number): The most to list, up to 100. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many entries are listed
- `entries` (list): The entries found
- `total` (number): How many entries match, including any past the limit

**Example output**

```json
{
  "count": 1,
  "entries": [
    {
      "author": "Jane Doe",
      "category": "Tech",
      "category_id": 3,
      "comments_url": "",
      "content": "The Kubernetes project shipped version 2.0.",
      "content_html": "<p>The <b>Kubernetes</b> project shipped version 2.0.</p>",
      "created_at": "2026-11-02T10:05:12Z",
      "feed": "Tech News",
      "feed_id": 12,
      "feed_url": "https://news.example.com/feed.xml",
      "id": 4211,
      "link": "https://reader.miniflux.app/feed/12/entry/4211",
      "media": [],
      "published_at": "2026-11-02T10:00:00Z",
      "reading_time": 1,
      "site_url": "https://news.example.com/",
      "starred": false,
      "status": "unread",
      "tags": [
        "Cloud"
      ],
      "title": "Kubernetes 2.0 released",
      "url": "https://news.example.com/kubernetes-2"
    }
  ],
  "total": 1
}
```

### Get entry

Get an entry with its content as text and HTML, or with the full original article fetched from its website, for a feed that sends only a summary.

**Inputs**

- Entry (`entry`, text, required): The entry's ID, such as one from 'Find entries' or a trigger, or its link in Miniflux (…/entry/42).
- Fetch the original article (`fetch_original`, true/false): Read the whole article from its website instead of what the feed sent. Miniflux keeps its own copy as it was.

**Outputs**

- `author` (text): Its author, when the feed names one
- `category` (text): The feed's category
- `category_id` (number): The category's ID
- `comments_url` (text): A link to its comments, when the feed has one
- `content` (text): Its content as plain text
- `content_html` (text): Its content as HTML
- `created_at` (text): When Miniflux first read it (ISO 8601)
- `feed` (text): The feed it came from
- `feed_id` (number): The feed's ID
- `feed_url` (text): The feed's address
- `fetched_original` (true/false): Whether the content is the original article, fetched from its website
- `id` (number): The entry's ID in Miniflux
- `link` (text): A link to it in Miniflux
- `media` (list): Links to attached audio, video or pictures, such as a podcast episode
- `published_at` (text): When it was published (ISO 8601)
- `reading_time` (number): Minutes it takes to read, as Miniflux estimates
- `site_url` (text): The address of the feed's website
- `starred` (true/false): Whether it's starred
- `status` (text): unread or read
- `tags` (list): Its tags, as the feed gives them
- `title` (text): Its title
- `url` (text): The link to the original article

**Example output**

```json
{
  "author": "Jane Doe",
  "category": "Tech",
  "category_id": 3,
  "comments_url": "",
  "content": "The Kubernetes project shipped version 2.0.",
  "content_html": "<p>The <b>Kubernetes</b> project shipped version 2.0.</p>",
  "created_at": "2026-11-02T10:05:12Z",
  "feed": "Tech News",
  "feed_id": 12,
  "feed_url": "https://news.example.com/feed.xml",
  "fetched_original": false,
  "id": 4211,
  "link": "https://reader.miniflux.app/feed/12/entry/4211",
  "media": [],
  "published_at": "2026-11-02T10:00:00Z",
  "reading_time": 1,
  "site_url": "https://news.example.com/",
  "starred": false,
  "status": "unread",
  "tags": [
    "Cloud"
  ],
  "title": "Kubernetes 2.0 released",
  "url": "https://news.example.com/kubernetes-2"
}
```

### List categories

List your categories, with how many feeds and unread entries each has.

**Inputs**: None.

**Outputs**

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

**Example output**

```json
{
  "categories": [
    {
      "feed_count": 4,
      "id": 3,
      "link": "https://reader.miniflux.app/category/3/entries",
      "title": "Tech",
      "unread_count": 17
    }
  ],
  "count": 1
}
```

### List feeds

List the feeds you're subscribed to, with their categories, unread counts and any error reading them.

**Inputs**

- Category (`category`, text): Only feeds in this category. Leave blank for every feed.

**Outputs**

- `count` (number): How many feeds are listed
- `feeds` (list): The feeds, by title

**Example output**

```json
{
  "count": 1,
  "feeds": [
    {
      "category": "Tech",
      "category_id": 3,
      "checked_at": "2026-11-06T08:00:00Z",
      "disabled": false,
      "error": "",
      "error_count": 0,
      "feed_url": "https://news.example.com/feed.xml",
      "fetch_full_articles": false,
      "id": 12,
      "link": "https://reader.miniflux.app/feed/12/entries",
      "read_count": 40,
      "site_url": "https://news.example.com/",
      "title": "Tech News",
      "unread_count": 8
    }
  ]
}
```

### Mark entries read or unread

Mark one or more entries read or unread, such as the ones a workflow has just posted or summarised.

**Inputs**

- Entries (`entries`, list, required): The entries' IDs, such as the IDs from 'Find entries'.
- Mark as (`status`, text): Read or unread. One of: `read`, `unread`. Default: `read`.

**Outputs**

- `count` (number): How many entries were marked
- `entry_ids` (list): The IDs of the entries marked
- `status` (text): What they were marked: read or unread

**Example output**

```json
{
  "count": 2,
  "entry_ids": [
    4211,
    4212
  ],
  "status": "read"
}
```

### Refresh feed

Have Miniflux read a feed now rather than at its next scheduled check, and get how many new unread entries it brought.

**Inputs**

- Feed (`feed`, text, required): The feed: its name, ID or address.

**Outputs**

- `category` (text): Its category
- `category_id` (number): The category's ID
- `checked_at` (text): When Miniflux last read it (ISO 8601)
- `disabled` (true/false): Whether Miniflux has stopped reading it
- `error` (text): Why Miniflux couldn't read it last time; empty when it could
- `error_count` (number): How many times in a row reading it failed
- `feed_url` (text): The feed's address
- `fetch_full_articles` (true/false): Whether Miniflux fetches each new entry's full article from its website
- `id` (number): The feed's ID
- `link` (text): A link to it in Miniflux
- `new_unread` (number): How many more unread entries it has than before
- `read_count` (number): How many of its entries are read
- `site_url` (text): The address of its website
- `title` (text): Its title
- `unread_count` (number): How many of its entries are unread

**Example output**

```json
{
  "category": "Tech",
  "category_id": 3,
  "checked_at": "2026-11-06T08:00:00Z",
  "disabled": false,
  "error": "",
  "error_count": 0,
  "feed_url": "https://news.example.com/feed.xml",
  "fetch_full_articles": false,
  "id": 12,
  "link": "https://reader.miniflux.app/feed/12/entries",
  "new_unread": 2,
  "read_count": 40,
  "site_url": "https://news.example.com/",
  "title": "Tech News",
  "unread_count": 8
}
```

### Star or unstar entry

Star an entry to keep it, or take its star off. One already as asked is left as it is.

**Inputs**

- Entry (`entry`, text, required): The entry's ID, such as one from 'Find entries' or a trigger, or its link in Miniflux (…/entry/42).
- Star or unstar (`starred`, text): Whether to star it or take its star off. One of: `star`, `unstar`. Default: `star`.

**Outputs**

- `author` (text): Its author, when the feed names one
- `category` (text): The feed's category
- `category_id` (number): The category's ID
- `comments_url` (text): A link to its comments, when the feed has one
- `content` (text): Its content as plain text
- `content_html` (text): Its content as HTML
- `created_at` (text): When Miniflux first read it (ISO 8601)
- `feed` (text): The feed it came from
- `feed_id` (number): The feed's ID
- `feed_url` (text): The feed's address
- `id` (number): The entry's ID in Miniflux
- `link` (text): A link to it in Miniflux
- `media` (list): Links to attached audio, video or pictures, such as a podcast episode
- `published_at` (text): When it was published (ISO 8601)
- `reading_time` (number): Minutes it takes to read, as Miniflux estimates
- `site_url` (text): The address of the feed's website
- `starred` (true/false): Whether it's starred
- `status` (text): unread or read
- `tags` (list): Its tags, as the feed gives them
- `title` (text): Its title
- `url` (text): The link to the original article

**Example output**

```json
{
  "author": "Jane Doe",
  "category": "Tech",
  "category_id": 3,
  "comments_url": "",
  "content": "The Kubernetes project shipped version 2.0.",
  "content_html": "<p>The <b>Kubernetes</b> project shipped version 2.0.</p>",
  "created_at": "2026-11-02T10:05:12Z",
  "feed": "Tech News",
  "feed_id": 12,
  "feed_url": "https://news.example.com/feed.xml",
  "id": 4211,
  "link": "https://reader.miniflux.app/feed/12/entry/4211",
  "media": [],
  "published_at": "2026-11-02T10:00:00Z",
  "reading_time": 1,
  "site_url": "https://news.example.com/",
  "starred": true,
  "status": "unread",
  "tags": [
    "Cloud"
  ],
  "title": "Kubernetes 2.0 released",
  "url": "https://news.example.com/kubernetes-2"
}
```

### Subscribe to feed

Subscribe to a feed by its address, or by a website's address and Miniflux finds its feed, in a category of your choice. A feed already subscribed to is left as it is.

**Inputs**

- Feed or website address (`url`, text, required): The feed's address, or the address of a website that has one, such as https://example.com/blog.
- Category (`category`, text): The category to put it in. One that doesn't exist yet is made. Leave blank for your first category.
- Fetch full articles (`fetch_full_articles`, true/false): For a feed that sends only summaries: Miniflux fetches each new entry's whole article from its website.

**Outputs**

- `already_subscribed` (true/false): Whether the feed was already there
- `category` (text): Its category
- `category_id` (number): The category's ID
- `checked_at` (text): When Miniflux last read it (ISO 8601)
- `disabled` (true/false): Whether Miniflux has stopped reading it
- `error` (text): Why Miniflux couldn't read it last time; empty when it could
- `error_count` (number): How many times in a row reading it failed
- `feed_url` (text): The feed's address
- `fetch_full_articles` (true/false): Whether Miniflux fetches each new entry's full article from its website
- `id` (number): The feed's ID
- `link` (text): A link to it in Miniflux
- `read_count` (number): How many of its entries are read
- `site_url` (text): The address of its website
- `title` (text): Its title
- `unread_count` (number): How many of its entries are unread

**Example output**

```json
{
  "already_subscribed": false,
  "category": "Tech",
  "category_id": 3,
  "checked_at": "2026-11-06T08:00:00Z",
  "disabled": false,
  "error": "",
  "error_count": 0,
  "feed_url": "https://news.example.com/feed.xml",
  "fetch_full_articles": false,
  "id": 12,
  "link": "https://reader.miniflux.app/feed/12/entries",
  "read_count": 40,
  "site_url": "https://news.example.com/",
  "title": "Tech News",
  "unread_count": 8
}
```

### Unsubscribe from feed

Unsubscribe from a feed. Miniflux deletes its entries too, starred ones included.

**Inputs**

- Feed (`feed`, text, required): The feed: its name, ID or address.

**Outputs**

- `feed_url` (text): Its address
- `id` (number): The feed's ID
- `title` (text): Its title
- `unsubscribed` (true/false): Always true

**Example output**

```json
{
  "feed_url": "https://news.example.com/feed.xml",
  "id": 12,
  "title": "Tech News",
  "unsubscribed": true
}
```
