Skip to content
Pastepile

Tools

pastepile_search

Search pastes by keyword. With an API key it defaults to your private memory; without one it searches the public corpus.

1 min read · Updated

Keyword search over paste titles, filenames, and contents. This is the recall half of memory: what pastepile_save wrote, search finds again, without anyone remembering slugs.

Parameters

ParameterTypeDescription
querystringrequiredKeywords to match against titles, filenames, and content.
scopeenumoptionalmine searches pastes saved with the configured API key (default when a key is set); public searches the public corpus (default and only option without a key). See Private memory.
limitintegeroptionalMaximum results, 1 to 100. Default 20.

Example

Search my pastes for the rollback runbook.
Request
{
  "name": "pastepile_search",
  "arguments": { "query": "rollback runbook" }
}
Result
{
  "query": "rollback runbook",
  "scope": "mine",
  "total": 1,
  "results": [
    {
      "slug": "aB3xY9z",
      "title": "prod rollback runbook",
      "language": "bash",
      "preview": "kubectl rollout undo deploy/api",
      "visibility": "unlisted",
      "expires_at": null,
      "file_count": 1,
      "created_at": "2026-07-28T23:00:00Z",
      "url": "https://www.pastepile.com/p/aB3xY9z",
      "raw_url": "https://www.pastepile.com/raw/aB3xY9z"
    }
  ]
}

Behavior notes

  • Scope mine covers unlisted pastes saved with your key; no public query can reach those.
  • Previews are never returned for encrypted, password-protected, or burn-after-read pastes.
  • Empty queries are rejected locally, before any network request.

Errors

ErrorCause
scope "mine" requires an API keyNo PASTEPILE_API_KEY configured; set it and restart the client. See Authentication.
rate_limited (429)Request budget exhausted; see Limits.

Related documentation

pastepile_listList recent pastes, newest first: your saved pastes with an API key, the public feed without one.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.pastepile_getRetrieve a paste by slug or full URL and reload previously saved knowledge into the model's context.