Docsbook
Overview

Remove hypothesis

MCPremove_hypothesisWRITE$0.02 / call

RETIRE a hypothesis that should never have been written. Free on every plan. 🔴 THIS IS NOT HOW ONE GETS FINISHED. A claim you actually tested is closed with edit_hypothesis's verdict — including when the verdict is rejected because nothing moved. A retired hypothesis and a judged one are indistinguishable to the next run, so retiring what you measured destroys the finding and leaves the project looking like it never tested anything. Use this when the claim was a mistake, or when what it was about is gone: the page was deleted, the feature was cancelled. Archived rather than destroyed, so the key stays taken and writing it again revives the row with its original date. This answers WHAT, not what to do about it. If you have not already got the method from docsbook_expert, get it first: it names which readings answer this question, what to compare them against, and what would make the conclusion wrong. One call, changes nothing.

Arguments
workspace_idstringoptional

Workspace ID (optional when MCP endpoint is auto-scoped). Numeric workspace id — OR the project as the user names it: 'owner/repo', the repo name alone, the site's display name, its docs URL or custom domain. Text is resolved server-side; an ambiguous name returns the candidates instead of guessing, so pass what the user said rather than calling list_workspaces first.

keystringrequired

The hypothesis's handle, from list_hypotheses.

Call it#

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "remove_hypothesis",
    "arguments": {
      "key": "<key>"
    }
  }
}
curl -X POST 'https://docsbook.io/api/mcp/server' \
  -H 'Authorization: Bearer dbk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"remove_hypothesis","arguments":{"key":"<key>"}}}'

Try it over REST#

The same tool is callable as a plain HTTP request, no MCP client required. It runs on the same server, at the same price.

Your workspace is resolved from the API key, so workspace_id is decided server-side here and anything you send for it is ignored.

POST/api/v1/tools/remove_hypothesis
Authorization
Authorizationstringrequired

Your API key, sent as Authorization: Bearer dbk_YOUR_API_KEY.Sent as the Authorization header. Your key is used only by your browser for this request — it is never sent to Docsbook or stored.

Body
argsobjectrequired

The arguments above, as one JSON object.

Request
curl -X POST 'https://docsbook.io/api/v1/tools/remove_hypothesis' \
  -H 'Authorization: Bearer dbk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"args":{"key":"<key>"}}'

Updated

Was this page helpful?