Remove a source
DELETE
https://dash.alethman.com/api/v1/sources/{id}Stop following a feed. Its stored items go with it. Written to the workspace’s audit log under the key’s name.
Request
Section titled “Request”| Parameter | In | Type | Default | Values | What it does |
|---|---|---|---|---|---|
id required |
path | string (uuid) | The source id, from GET /sources. |
Example
Section titled “Example”curl -X DELETE "https://dash.alethman.com/api/v1/sources/34c8efbf-5e0c-4ace-bfeb-816f16bf59df" \ -H "Authorization: Bearer $ALETHMAN_KEY"import osimport requests
r = requests.delete( "https://dash.alethman.com/api/v1/sources/34c8efbf-5e0c-4ace-bfeb-816f16bf59df", headers={"Authorization": f"Bearer {os.environ['ALETHMAN_KEY']}"}, timeout=30,)r.raise_for_status()print("removed" if r.status_code == 204 else r.status_code)const url = "https://dash.alethman.com/api/v1/sources/34c8efbf-5e0c-4ace-bfeb-816f16bf59df";
const res = await fetch(url, { method: "DELETE", headers: { Authorization: `Bearer ${process.env.ALETHMAN_KEY}`, },});if (!res.ok) throw new Error((await res.json()).error.message);console.log("removed");Response
Section titled “Response”204 No Content. The source is gone; there is no body. The rate-limit headers are set as on every admitted request.
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. |
| 404 | not_found |
No source with that id in this workspace. Message: “No source with that id in this workspace.” |
| 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”- Removing a source deletes the items stored from it. Adding the same feed again starts it fresh.
- Every removal is written to the workspace’s audit log with the key’s name.
From an AI assistant
Section titled “From an AI assistant”Not offered over MCP. Every MCP tool is read-only, so an assistant can read your sources but not change them.