API & MCP reference / Getting started

Errors & rate limits

Errors return a JSON body shaped { "error": { "message": "…" } } with a conventional status code.

StatusMeaning
400Validation failed — the message names the offending field.
401Missing, malformed, or revoked credentials.
403Authenticated, but the plan or OAuth scope doesn't allow it.
404No such resource in this workspace.
429Rate limited. Retry after the current minute rolls over.

Rate limits are counted per credential per minute and scale with your plan, so heavy automation is a reason to move up a tier rather than a wall everyone shares.

PlanRequests / minute
Creator60
Growth300
Pro1,000