Call knowledge_source.remove
Remove a knowledge source for good — 'delete that source', 'remove the old pricing page from our knowledge', 'take that competitor's site out of the knowledge base entirely'. It deletes the source and expires every passage it contributed, so no agent in this workspace retrieves from it again; this cannot be undone, and adding it back reads it afresh as a new source. Calling it raises the approval card showing the source's name and what it points at, which is the operator's confirmation, so call it on the ask; it can still be refused after you call it. Never say a source was removed unless the result says so. Pass the id of the source the operator named, from knowledge_source.list. Not for switching a source off while keeping it — that is knowledge_source.disable. Over the API it answers in two calls: without confirmation_id it proposes — says what would happen, returns a confirmation_id and changes, spends and sends nothing; the same arguments again with that confirmation_id, on a member's own API key, do it.
Every result names the workspace it ran in. Say which workspace the answer is about. When the account has more than one workspace and none is selected, this tool refuses with workspace_ambiguous and lists the choices — offer them, never pick one.
Request
- Base URL: https://app.goosybear.ai
- URL: https://app.goosybear.ai/api/v1/tools/knowledge_source.remove
- Auth: HTTP bearer
Headers
Your own id for this request, echoed back and recorded on the audit trail. 1–128 characters from A–Z a–z 0–9 . _ : -, starting with a letter or digit; anything else is replaced by a generated id.
Request body
Response
The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.
Changes
No recorded changes to this operation across all 5 revisions of this API.