rate_limited

HTTP 429 · Too many requests with this token.

Why it happens

Each token (key or agent) can make up to 600 requests per minute, counting the API and MCP together. It happens, for example, when you import hundreds of entries without a pause.

How to fix it

Wait the number of seconds in the Retry-After header (they also come in details.retry_after) and retry. For large imports, check X-RateLimit-Remaining on each response and slow down before it reaches zero.

Example

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests with this token.",
    "fix": "Wait the number of seconds in Retry-After and retry. The limit is 600 requests per minute per token.",
    "doc_url": "https://pluma.so/docs/errors/rate_limited",
    "details": { "retry_after": 23 }
  }
}