OverviewPlatformsAPI Reference
Feeds

Update a feed

Rename a feed (title, null clears it), or set its sign-in for a members-only forum (auth: a cookie copied from your browser, or one header such as Discourse's Api-Key). A sign-in is checked by reading the feed with it, stored encrypted, sent to the feed's own site alone and never shown again; the feed is then read for this workspace alone. auth: null removes it.

PATCH
/v1/feeds/{id}

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Path Parameters

idstring

Feed id (fd_...).

Length1 <= length

Request Body

title?string|null

Your name for the feed; null clears it.

Length1 <= length <= 200
auth?||unknown

Replaces the sign-in (checked by reading the feed with it first); null removes it and the feed is read signed out again.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.mentio.dev/v1/feeds/fd_abc123" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "url": "string",
  "title": "string",
  "connectedAt": "string",
  "readingSince": "string",
  "auth": {
    "type": "cookie"
  },
  "health": {
    "status": "ok",
    "reason": "login_required",
    "detail": "string",
    "failures": 0,
    "since": "string"
  },
  "stats": {
    "lastPolledAt": "string",
    "emptyPolls": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

List feeds GET

The RSS and Atom feeds the workspace reads (forums, communities, blogs), newest connection first, each with how its hourly poll goes. Every keyword of the workspace with readsWorkspaceFeeds (the default) reads these feeds: an item holding its term is one of its mentions, with its matching rules, billed like any mention. Each feed is read every hour; reading it is free. At most 500 a workspace.

Get the workspace filters GET

The noise rules applied to every keyword before a mention is stored: excluded terms and authors, excluded GitHub repositories, and the subreddits Reddit posts may (or may not) come from. A post they reject is never classified, delivered or billed. Keyword-level rules live on each keyword (`matching`); both apply.