---
title: "Error: rate_limited"
status: current
phase: 7
---

# `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

```json
{
  "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 }
  }
}
```