Rate Limits

^{Questions or issues? Contact us at api-support@manus.ai.} The Manus API enforces per-user rate limits on every v2 endpoint. All API keys that belong to the same user share a single counter, and limits are measured in requests per minute. There is currently no tier differentiation — the same limit applies regardless of subscription plan.

Limits by endpoint

Tasks

Endpoint	Limit
`task.create`	10 / min
`task.sendMessage`	10 / min
`task.detail`	100 / min
`task.list`	100 / min
`task.listMessages`	100 / min
`task.update`	40 / min
`task.stop`	40 / min
`task.delete`	40 / min
`task.confirmAction`	40 / min

Projects

Endpoint	Limit
`project.create`	40 / min
`project.list`	100 / min

Skills

Endpoint	Limit
`skill.list`	100 / min

Agents

Endpoint	Limit
`agent.list`	100 / min
`agent.detail`	100 / min
`agent.update`	40 / min

Files

Endpoint	Limit
`file.upload`	40 / min
`file.detail`	100 / min
`file.delete`	40 / min

Webhooks

Endpoint	Limit
`webhook.create`	40 / min
`webhook.list`	100 / min
`webhook.delete`	40 / min

Usage

Endpoint	Limit
`usage.list`	600 / min
`usage.teamStatistic`	600 / min
`usage.teamLog`	600 / min

Connectors

Endpoint	Limit
`connector.list`	100 / min

Browser

Endpoint	Limit
`browser.onlineList`	100 / min

Website

Endpoint	Limit
`website.status`	100 / min
`website.listCheckpoints`	100 / min
`website.publish`	40 / min
`website.update`	40 / min

Error response

Requests that exceed the limit return HTTP 429 with the rate_limited error code:

{
  "ok": false,
  "request_id": "req_abc123",
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Please retry after a short backoff."
  }
}

Best practices

Back off on 429 with exponential delay plus jitter; don’t retry immediately in a tight loop.
Prefer webhooks over polling for task progress — see Webhooks. Each task.listMessages poll counts against the 100 / min limit for that endpoint.
Use cursor pagination (cursor + next_cursor) on list endpoints so a single logical read can span minutes without a burst.
Cache stable values such as the public key returned by webhook.publicKey — it rarely changes.

Getting Started

API Reference

Limits by endpoint

Tasks

Projects

Skills

Agents

Files

Webhooks

Usage

Connectors

Browser

Website

Error response

Best practices

​Limits by endpoint

​Tasks

​Projects

​Skills

​Agents

​Files

​Webhooks

​Usage

​Connectors

​Browser

​Website

​Error response

​Best practices

Limits by endpoint

Tasks

Projects

Skills

Agents

Files

Webhooks

Usage

Connectors

Browser

Website

Error response

Best practices