Paper Personal API
Limits
How many requests, how many files and what size.
| Limit | Value | Applies to |
|---|---|---|
| Requests per minute | 60 | Each token |
| Requests per day | 5000 | Each token, resets at midnight UTC |
| File uploads per day | 30 | Each token |
| Size of one file | 10 MB | Each upload |
| Text of one page | 1 MB | markdown and append |
| Body of a JSON request | 2 MB | Each request |
| Active tokens | 20 | Each account |
| Text of a vault for a copy | 20 MB | Secure token |
| Pages in a copy | 6000 | Secure token |
| Search results | 50 | Each search |
| Events per listing | 250 | Calendar |
The limits also show in GET /me, in the limites field.
When you go over a limit
The API answers 429 with a message saying which limit was reached. The message follows Accept-Language:
{ "error": "Limit of 60 requests per minute. Wait a moment." }Wait and try again, with growing intervals: 2 seconds, then 4, 8, 16. If it's the daily limit, stop until the next day.
Normal use
Normal use, like an assistant that organizes notes or a script that creates the day's page, stays far below these numbers. Getting around limits with several tokens or several accounts violates the terms and leads to a ban. See Fair use.
If you have a real case that needs more, write to support and choose the subject API and access tokens.