Tools
pastepile_timeline
Show one memory's full version history plus the memories most related to it, with sizes and previews rather than whole revisions.
1 min read · Updated
Returns every version of one memory, newest first, each with a version number, a timestamp, a byte size and a short preview. It also returns the memories most related to this one, by shared tags first and text overlap second.
Bodies are deliberately not included. A memory checkpointed fifty times would be megabytes to draw a list of dates, so this stays cheap enough to call whenever a history is shown.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
slug | string | required | The memory slug (aB3xY9z) or its full Pastepile URL, as returned by pastepile_remember or pastepile_recall. |
Example
{
"slug": "aB3xY9z",
"title": "Auth refactor decisions",
"session": "acme-api/auth-refactor",
"checkpoints": 12,
"unchanged_saves": 41,
"current": { "bytes": 8214, "preview": "## Decided..." },
"versions": [{ "version_no": 11, "created_at": "2026-08-04T10:11:12Z", "bytes": 7980, "preview": "..." }],
"related": [{ "slug": "kQ7m2Lp", "title": "Edge middleware notes" }]
}Behavior notes
unchanged_savescounts the saves that changed nothing. It is surfaced rather than hidden because it is the number that says whether an autosave policy is well tuned or merely noisy.- Readable only by the API key that wrote the memory. A slug that never existed and a slug belonging to another key answer identically, so the endpoint cannot be used to discover which slugs are taken.
Related documentation
pastepile_restorePut an earlier version of a memory back as the current one, without losing what was current before the restore.pastepile_rememberSave the current state of a piece of work to durable memory, keyed by a session name the assistant chooses, so no slug ever has to be carried between calls.pastepile_recallSearch only the memory saved with the configured API key, by text, tag, and kind, so an assistant can check what it already knows before asking.Private memoryHow an API key gives your assistant a private, isolated memory namespace on Pastepile, and how scopes decide what search and list can see.