Skip to content

List sources

GEThttps://dash.alethman.com/api/v1/sources
MCP tool
list_sources

The feeds the workspace follows on top of Alethman’s own coverage (a regulator’s press releases, a trade body, a local paper), with each feed’s health.

This endpoint takes no parameters.

Terminal window
curl "https://dash.alethman.com/api/v1/sources" \
-H "Authorization: Bearer $ALETHMAN_KEY"

200 OK, application/json, with the rate-limit headers. A real response, shortened: long lists are cut to a few items.

200 OK
{
"data": [
{
"id": "34c8efbf-5e0c-4ace-bfeb-816f16bf59df",
"url": "https://www.rbi.org.in/pressreleases_rss.xml",
"site_url": "http://www.rbi.org.in/",
"title": "PRESS RELEASES FROM RBI",
"kind": "rss",
"status": "active",
"last_polled_at": "2026-11-21T04:50:25.731Z",
"last_ok_at": "2026-11-21T04:50:25.731Z",
"last_error": null,
"items": 300,
"items_7d": 41,
"created_at": "2026-09-30T06:58:18.672Z"
}
]
}
Field Type Values What it is
data array of objects The workspace’s feeds.
data[].id string (uuid) The source’s id.
data[].url string (url) The feed’s address.
data[].site_url string or null The site the feed belongs to.
data[].title string The feed’s title.
data[].kind string rss, atom rss or atom.
data[].status string active, paused, failing active: polled about every 20 minutes. paused: an owner or admin paused it. failing: recent polls failed; see last_error.
data[].last_polled_at string (time) or null The last poll, successful or not.
data[].last_ok_at string (time) or null The last successful poll.
data[].last_error string or null Why the last poll failed, or null.
data[].items integer Items stored from this feed.
data[].items_7d integer Items stored in the last 7 days.
data[].created_at string (time) When the workspace started following it.

Every error has the body {"error": {"code": …, "message": …}}; branch on code. See Errors for how to handle each.

Status Code When
401 unauthenticated No Authorization header, or one that is not Bearer <key>. Answered with WWW-Authenticate: Bearer realm="alethman".
401 invalid_key The key is unknown, revoked or expired, its workspace is suspended, or the person who made it is no longer an active owner or admin. Answered with WWW-Authenticate: Bearer realm="alethman", error="invalid_token".
403 insufficient_scope The key is valid but does not carry the scope this endpoint needs. The message names the scope.
409 workspace_not_ready The workspace has not been set up yet. An owner or admin finishes the setup walkthrough in the dashboard first.
429 rate_limited More than 120 requests in a minute on one key (wait for Retry-After seconds), or more than 30 failed key attempts in a minute from one address (wait 60 seconds).
500 internal Something failed on Alethman’s side. Retry with backoff; if it persists, write to Alethman with the time of the request.
  • status: failing means the last polls failed; last_error says why, and polling continues. A feed that recovers goes back to active by itself.

The MCP tool list_sources runs this endpoint’s code and returns the same JSON.