Developer API Overview
The AnonPaste Developer API lets you create, read, update, and delete pastes, lightweight paste-lites, and files — all programmatically with an API key.
What you can build
Section titled “What you can build”- Backup tools – automatically save text or files to AnonPaste
- Bot integrations – post log output, alerts, or reports as pastes
- Ephemeral data stores – use PasteLite as a lightweight key/value store
- Secure file sharing – upload files with client-side encryption or burn-after-download
Resources
Section titled “Resources”| Resource | Description |
|---|---|
| Pastes | Full-featured text pastes with syntax highlighting, expiry, burn-after-view, and client-side encryption |
| PasteLite | Lightweight key/value store for small JSON/text payloads |
| Files | Binary file storage with tagging, expiry, and burn-after-download |
Base URL
Section titled “Base URL”https://api.anonpaste.comAll Developer API endpoints are prefixed with /api/dev/.
Getting an API key
Section titled “Getting an API key”- Log in to AnonPaste
- Go to Settings → Developer
- Click Generate API Key
Note: API keys are tied to your account tier. Free tier users can only access PasteLite endpoints. Upgrade to Pro or Max for full paste and file access.
Tiers & limits
Section titled “Tiers & limits”| Endpoint | Free | Pro | Max |
|---|---|---|---|
pastes.create | 0/mo | 500/mo | 10,000/mo |
pastes.get | 0/mo | 3,000/mo | 50,000/mo |
pastes.update | 0/mo | 500/mo | 10,000/mo |
pastes.delete | 10/mo | 500/mo | 5,000/mo |
files.upload | 0/mo | 100/mo | 1,000/mo |
files.get | 0/mo | 500/mo | 5,000/mo |
files.delete | 0/mo | 200/mo | 2,000/mo |
pasteLite.create | 100/mo | 5,000/mo | 20,000/mo |
pasteLite.get | 500/mo | 10,000/mo | 100,000/mo |
pasteLite.delete | 50/mo | 2,000/mo | 10,000/mo |
Requests over the monthly free quota are billed per request against your credit balance. If credits run out, further over-quota requests return 429 Too Many Requests until credits are added or the monthly quota resets.
An endpoint that is unavailable on the current account tier can also return 429 with a plan-upgrade reason. See Rate limits and Errors for response details.
SDK vs raw HTTP
Section titled “SDK vs raw HTTP”You can use the API with plain HTTP requests or with the official SDK:
- TypeScript/JavaScript SDK (
anonpaste-sdk) — recommended for most use cases - Raw HTTP — use any language with
curl,fetch,requests, etc.
This documentation covers both approaches side by side.
What is not in the Developer API
Section titled “What is not in the Developer API”Features you use in the browser while logged in — short links, themes, notifications, paste creation from the homepage — use separate session APIs. They are documented in the user help sections (for example Short links), not here. Integrations should only target /api/dev/* unless AnonPaste provides a dedicated public API for that feature.