Miniflux App Miniflux API

Name: Miniflux API
Brand: Miniflux API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityNote Takingbasic, apiKey50 EndpointsREST

For Agents

Programmatically manage feeds, categories, and entries in a self-hosted Miniflux feed reader. Useful for automated reading queues, alerting, and content pipelines.

Install Jentic One Beta

Connect the Miniflux API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Miniflux API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Miniflux API.

Discover feeds for a website with POST /discover and create them via POST /feeds

Mark all entries in a feed or category as read with PUT /feeds/{feedId}/mark-all-as-read and PUT /categories/{categoryId}/mark-all-as-read

Bookmark or save entries individually using PUT /entries/{entryId}/bookmark and POST /entries/{entryId}/save

GET STARTED

Start building with Miniflux API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Miniflux API for, with concrete tasks.

★ Automated Feed Onboarding

Discover and subscribe to feeds in one flow. POST /discover finds the available RSS or Atom URLs for a given website, then POST /feeds creates the subscription under the chosen category. Useful for tools that turn a list of domains into a curated reader without manual copy-paste.

POST /discover with a website URL, pick the first feed_url returned, then POST /feeds with that URL and category_id

Read Inbox Cleanup

Reduce a backlogged reader by marking entries as read in bulk. Mark all entries in a single feed or an entire category as read with PUT /feeds/{feedId}/mark-all-as-read or PUT /categories/{categoryId}/mark-all-as-read. The complement endpoints flush history when required.

Iterate categories with GET /categories and call PUT /categories/{categoryId}/mark-all-as-read on every category whose name is not 'starred'

Newsletter to Bookmark Pipeline

Watch entries for keywords and bookmark matches automatically. The agent polls GET /entries with status=unread, scans titles and content for a watchlist, then calls PUT /entries/{entryId}/bookmark to flag matches. Useful for analysts tracking specific topics across many feeds.

GET /entries?status=unread, filter by title regex matching the watchlist, and call PUT /entries/{entryId}/bookmark for each match

Backup and Migration

Export the full subscription set with GET /export to download OPML, then re-import it on a new Miniflux instance with POST /import. Automation can run nightly exports for backup or migrate users between self-hosted servers without manual intervention.

GET /export to download the OPML, then POST /import to a second Miniflux base URL

Agent-Driven Reading Pipelines

An AI agent uses Jentic to power a reading assistant: it discovers new feeds, organises them by category, and flags entries that match the user's interests. The Miniflux API key sits in Jentic's vault scoped to one base URL, so the agent never holds the credential directly.

Search Jentic for 'subscribe to a new RSS feed', load the Miniflux POST /feeds schema, and add five feeds discovered for the user's interest list

Key Endpoints

50 endpoints — jentic publishes the only available openapi specification for miniflux api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/discover

Discover feed URLs for a website

POST

/feeds

Subscribe to a new feed

GET

/entries

List entries with filtering

PUT

/entries/{entryId}/bookmark

Bookmark an entry

POST

/categories

Create a category

PUT

/categories/{categoryId}/mark-all-as-read

Mark category as read

GET

/export

Export OPML

POST

/import

Import OPML

POST

/discover

Discover feed URLs for a website

POST

/feeds

Subscribe to a new feed

GET

/entries

List entries with filtering

PUT

/entries/{entryId}/bookmark

Bookmark an entry

POST

/categories

Create a category

PUT

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Miniflux API key is stored encrypted in the Jentic vault and injected as `X-Auth-Token` per call. Agents execute Miniflux operations without ever seeing the raw key, even when the deployment is self-hosted.

Intent-based discovery

Agents search Jentic for intents like 'subscribe to a feed' or 'mark a category as read' and Jentic returns the matching Miniflux operation with its input schema, regardless of the deployment's base URL.

Time to first call

Direct Miniflux integration: half a day to wire auth, the per-deployment base URL, and pagination on entries. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Miniflux API through Jentic.

Why is there no official OpenAPI spec for Miniflux API?

Miniflux does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Miniflux API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Miniflux API use?

Miniflux supports HTTP basic auth (username and password) and an API key in the `X-Auth-Token` header. The API key flow is preferred for automation. Through Jentic the key is held in the vault and injected on each call.

Can I subscribe to a new RSS feed with the Miniflux API?

Yes. First call POST /discover with the website URL to find available feed URLs, then call POST /feeds with the chosen feed_url and category_id to create the subscription.

How do I export and back up my Miniflux subscriptions?

Call GET /export to download an OPML file with every feed and category on the account. POST /import on another Miniflux deployment loads the same OPML to recreate the subscription tree.

How do I bookmark entries through Jentic?

Run `pip install jentic`, search Jentic for 'bookmark a feed entry', and Jentic returns the Miniflux PUT /entries/{entryId}/bookmark operation. Provide the entry id and execute; the bookmark flag is toggled on.

How does the API handle the self-hosted base URL?

Each Miniflux deployment runs at its own URL, e.g. `https://miniflux.example.org/v1`. Configure that as the base URL on the client. Jentic stores the base URL alongside the API key for the account so calls route correctly.

Miniflux App Miniflux API

Connect the Miniflux API to your agent

Capabilities

Start building with Miniflux API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs