Delete all conversions

DELETE/api/cache

Clears the whole cache (admin, or anyone when sign-in is off) or, for a regular user, their own history only. With DISABLE_PUBLIC_HISTORY on, a caller who isn't signed in gets 403. With sign-in off, that means nobody can clear the cache.

Authorizations

Authorizationstringheader

Needed only when the instance has sign-in enabled (PULLMD_AUTH_MODE is single-admin or multi-user). Send Bearer pmd_<key> with an API key created at /settings. In single-admin mode, the legacy PULLMD_AUTH_TOKEN is also accepted as a bearer token. OAuth access tokens work only on /mcp. Browser sessions use the pullmd_session cookie instead.

Response

200 · application/json

The entries were removed.

okboolean

Always true.

scopestring

global: the whole cache was cleared (admin, or sign-in off). user: only your own history was cleared; cached pages stay for others.

Available options: globaluser

removedinteger

Number of entries removed.

cURLcURLPythonJavaScript

curl --request DELETE \
  --url 'http://localhost:3000/api/cache' \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "scope": "global",
  "removed": 17
}