Delete library folder
delete_library_folderUse only when the user explicitly requests permanent deletion and confirms the target folder.
When to use it
Use only when the user explicitly requests permanent deletion and confirms the target folder.
Find candidate library objects before reading full evidence.
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
Prefer archive_library_folder when the folder might need to be restored later.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Permanently delete a private Prism Project folder and everything inside it. Requires confirm=true and cannot delete protected system folders. Use when: Use only when the user explicitly requests permanent deletion and confirms the target folder. Avoid when: Prefer archive_library_folder when the folder might need to be restored later.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"confirm": {
"type": "boolean",
"const": true
},
"expectedSubtree": {
"type": "array",
"minItems": 1,
"description": "Exact folder revision snapshot returned by this tool's preview commitBinding.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"updatedAt": {
"type": "string",
"format": "date-time"
}
},
"required": [
"id",
"updatedAt"
],
"additionalProperties": false
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for direct preview/commit calls. Reuse only for an exact retry."
},
"operationId": {
"type": "string",
"format": "uuid"
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"folderId",
"expectedUpdatedAt",
"confirm"
],
"additionalProperties": false
}