All tools
ToolDestructive
Move Project items to trash
trash_project_itemsYou need matching folders, sources, notes, recent changes, or library metadata.
When to use it
You need matching folders, sources, notes, recent changes, or library metadata.
Typical workflow
Find candidate library objects before reading full evidence.
What it returns
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
You need exact quoted evidence from a long source; use chunk tools instead.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"format": "uuid"
},
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"file",
"document",
"artifact"
]
},
"id": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
}
},
"required": [
"kind",
"id",
"expectedUpdatedAt"
],
"additionalProperties": false
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for mode=preview. Reuse only to retry this exact item-trash request."
},
"operationId": {
"type": "string",
"format": "uuid",
"description": "Operation id returned by this action's preview."
},
"commitToken": {
"type": "string",
"minLength": 1,
"description": "Commit token returned by this action's preview."
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"projectId",
"items"
],
"additionalProperties": false
}