Tools
pastepile_list
List recent pastes, newest first: your saved pastes with an API key, the public feed without one.
1 min read · Updated
Lists recent pastes, newest first. Use it for "what have I saved lately" overviews; for targeted recall, `pastepile_search` is the better tool.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
scope | enum | optional | mine lists pastes saved with the configured API key (default when a key is set); public lists the public feed (default without a key). |
limit | integer | optional | Maximum results, 1 to 100. Default 20. |
Example
What are the last five things I saved to Pastepile?
{
"name": "pastepile_list",
"arguments": { "limit": 5 }
}{
"scope": "mine",
"total": 12,
"results": [
{
"slug": "aB3xY9z",
"title": "prod rollback runbook",
"language": "bash",
"visibility": "unlisted",
"created_at": "2026-07-28T23:00:00Z",
"url": "https://www.pastepile.com/p/aB3xY9z"
}
]
}Errors
Identical to `pastepile_search`: scope mine without a key returns a clear configuration error, and exhausted budgets return rate_limited with Retry-After.