Move Project to trash
trash_projectUse for the normal, recoverable deletion of a top-level Project after reading its latest revision.
When to use it
Use for the normal, recoverable deletion of a top-level Project after reading its latest revision.
Find candidate library objects before reading full evidence.
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
Do not use for irreversible cleanup; library:purge is deliberately separate and requires explicit confirmation.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Move an entire active Prism Project to recoverable trash with optimistic concurrency. This is the normal deletion path; it retains a batch ID and purge deadline for restoration. Use when: Use for the normal, recoverable deletion of a top-level Project after reading its latest revision. Avoid when: Do not use for irreversible cleanup; library:purge is deliberately separate and requires explicit confirmation.
View JSON Schema
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"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": [
"projectId",
"expectedUpdatedAt"
],
"additionalProperties": false
}