List sources
GET
https://dash.alethman.com/api/v1/sourcesThe 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.
Request
Section titled “Request”This endpoint takes no parameters.
Example
Section titled “Example”curl "https://dash.alethman.com/api/v1/sources" \ -H "Authorization: Bearer $ALETHMAN_KEY"import osimport requests
r = requests.get( "https://dash.alethman.com/api/v1/sources", headers={"Authorization": f"Bearer {os.environ['ALETHMAN_KEY']}"}, timeout=30,)r.raise_for_status()print(r.json())const url = "https://dash.alethman.com/api/v1/sources";
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.ALETHMAN_KEY}`, },});if (!res.ok) throw new Error((await res.json()).error.message);console.log(await res.json());Response
Section titled “Response”200 OK, application/json, with the rate-limit headers. A real response, shortened: long lists are cut to a few items.
{ "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" } ]}Fields
Section titled “Fields”| 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. |
Errors
Section titled “Errors”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. |
Good to know
Section titled “Good to know”status: failingmeans the last polls failed;last_errorsays why, and polling continues. A feed that recovers goes back toactiveby itself.
From an AI assistant
Section titled “From an AI assistant”The MCP tool list_sources runs this endpoint’s code and returns the same JSON.