Skip to content

Remove a source

DELETEhttps://dash.alethman.com/api/v1/sources/{id}
MCP tool
None (writes are REST only)

Stop following a feed. Its stored items go with it. Written to the workspace’s audit log under the key’s name.

Parameter In Type Default Values What it does
id required path string (uuid) The source id, from GET /sources.
Terminal window
curl -X DELETE "https://dash.alethman.com/api/v1/sources/34c8efbf-5e0c-4ace-bfeb-816f16bf59df" \
-H "Authorization: Bearer $ALETHMAN_KEY"

204 No Content. The source is gone; there is no body. The rate-limit headers are set as on every admitted request.

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.
  • 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.

Not offered over MCP. Every MCP tool is read-only, so an assistant can read your sources but not change them.