pastepile_forget

Deletes a paste permanently. This is the tool an assistant reaches for when you say "forget that", and it exists because the credential a session actually still has is the API key, not the one-time edit_key.

An API key can delete a paste that the same key created, and nothing else. Pastes saved with no key, saved by someone else, or made in the browser are not touched by it; those still need their edit_key, which you can pass explicitly.

Parameters

Example

Forget that rollback runbook you saved, we moved it into the wiki.

{
  "name": "pastepile_forget",
  "arguments": { "slug": "aB3xY9z" }
}

{
  "forgotten": true,
  "slug": "aB3xY9z",
  "credential": "api_key",
  "note": "The paste is permanently deleted..."
}

Behavior notes

• Deletion is immediate and permanent. There is no trash, no undo, and no grace period: the row is removed, not flagged.
• A deleted paste that belonged to a Pile leaves the Pile entry reading as gone, which is how an expired or burned paste already reads there.
• The row goes at once, and listing and search stop returning it immediately, so the next scope: "mine" call reflects the deletion.
• A read that a CDN already cached can still be served for up to 60 seconds after the delete, which is the ordinary read cache every paste gets rather than anything specific to forgetting. The paste is gone from storage regardless.
• The tool is not idempotent by protocol annotation: a second call on the same slug reports a failure rather than a second success.

Errors