# Giới hạn và phân trang

> Tần suất yêu cầu theo khoá, kích thước trang và con trỏ keyset.

## Giới hạn tần suất

Mỗi khoá API được gọi **120 yêu cầu mỗi 60 giây**. Phản hồi có `RateLimit-Limit`, `RateLimit-Remaining` và `RateLimit-Reset`; khi chạm giới hạn, phản hồi là `429 RATE_LIMITED` kèm `Retry-After` tính bằng giây. Lệnh gọi tool MCP tính chung vào khoá đó.

## Phân trang

Danh sách có thể lớn dùng phân trang keyset:

- `limit` — kích thước trang, mặc định 50, tối đa 100.
- `cursor` — giá trị `page.next_cursor` của trang trước.

```json
{ "data": [ … ], "page": { "limit": 50, "next_cursor": "eyJ…" }, "correlation_id": "…" }
```

Đi theo `next_cursor` tới khi là `null`. Không dòng nào lặp giữa các trang, kể cả khi đang có dữ liệu mới được thêm. `paginate()` của SDK và `--all` của CLI làm việc này giúp bạn.

## Thao tác hàng loạt

`profiles.trash` và `profiles.restore` nhận tối đa 1.000 id, `proxies.delete` tối đa 500, `flows.run` tối đa 1.000 hồ sơ. Kết quả trả về theo từng mục, nên một mục bị từ chối không che các mục khác.

## Giới hạn của workspace

Các giới hạn như số phiên đồng thời được đặt theo workspace. `usage.get` cho thấy mức dùng hiện tại so với giới hạn đã đặt; `limit: null` nghĩa là chưa đặt giới hạn.