unload
[solution]
Removes loaded roots and releases their indexes and watchers. Status remains available. Omission removes all roots; this operation is idempotent.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| responseDetail | string | No | compact returns results and actionable state. full returns the original envelope with timing, revision, and display annotations. Default: "compact" |
| rootIds | json | No | Loaded root IDs to remove. Omission removes all. Empty lists, duplicate IDs, and unknown IDs are rejected. Unreleased |
Examples
Replace sample paths and symbol keys with values from your workspace.
Free all resident indexes
Arguments
{}Full MCP request
Full MCP request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "unload",
"arguments": {}
}
}Response Notes
Removing all roots returns root: null and loaded: false. Selective removal retains other roots. Full mode reports meta.generation.
Unreleased multi-root support: rootIds removes selected roots; omission removes all. Empty selectors, duplicate IDs, and unknown IDs reject the whole request. Removed roots release resources after admitted requests finish. The response lists removed IDs; status retains remaining roots. An empty all-root unload is idempotent.