Common patterns

Rate limits

Callabo API controls request volume with a Fixed Window. It counts requests for each user or workspace during a fixed time interval and resets the count when a new interval begins. If the limit is reached before the interval ends, the API returns 429 Too Many Requests until the next interval.

User request limit

Per-user request limit for public APIs without a workspace scope.

Type	Limit
User Scope API	100 requests per 60 seconds
MCP	100 requests per 60 seconds

Workspace request limit

Request limit determined by the current subscription plan.

Tier	Plans	Limit
Tier 1 · Basic Per-workspace request limit for the Free plan.	`free`	100 requests per 60 seconds
Tier 2 · Individual Per-workspace request limit for Personal and Plus plans.	`personalplus`	300 requests per 60 seconds
Tier 3 · Team and Pro Per-workspace request limit for Team and Pro plans.	`teampro`	600 requests per 60 seconds
Tier 4 · Business Per-workspace request limit for the Business plan.	`business`	3,000 requests per 60 seconds

429 responses and retries

Request limit exceeded

Response body

typestring
Error type indicating that the allowed request limit was exceeded.
dataRequiredV2RateLimitExceededErrorData
Additional error information.
scopeRequired·
"workspace" | "user" | "mcp"
Scope to which the request limit applies.
retry_after_secondsRequiredinteger
Number of seconds remaining before the request can be retried.

{
  "type": "RATE_LIMIT_EXCEEDED",
  "data": {
    "scope": "workspace",
    "retry_after_seconds": 1
  }
}

Retry after the data.retry_after_seconds value in the 429 response body.