Skip to Content
IntegrationRate limits & quotas

Rate limits and quotas

The Nebbos platform enforces per-tier request ceilings uniformly across the REST, MCP, and CLI surfaces. Ceilings maintain predictable substrate capacity headroom and refuse unintentional runaway loads. They are not a monetisation control.

Per-tier ceilings

TierSustainedBurst (10-second window)Scope
Guest (L1 · Starter)10 req/s40 req/sReads and low-risk tool calls
Host (L2 · Team)60 req/s240 req/sWrites within the operator’s organisation
Architect (L3 · Enterprise)600 req/s2,400 req/sSubstrate mutation

Bursts up to four times the sustained ceiling are accepted for a ten-second window. Pipelines that consume the burst envelope and return below the sustained ceiling do not receive 429 responses.

Behaviour at the ceiling

When an operator identity reaches the sustained ceiling, subsequent requests return HTTP 429 with a Retry-After header. The response body carries the standard error envelope, including the specific policy identifier that refused the call and the audit-chain entry recording the refusal.

{ "code": "policy.refusal.rate_limit_exceeded", "message": "Sustained rate exceeded for Host tier.", "policy_id": "RATE-LIMIT-HOST-SUSTAINED", "audit_event_id": "evt_01H8YMK7ZQV3D4XCJ9RM8W2N5T", "retry_after_seconds": 3 }

Every rate-limit refusal is recorded as a distinct entry in the audit chain. Repeated refusals from a single operator identity are visible to the customer’s compliance function.

Quota requests

Workloads that legitimately exceed a tier ceiling — batch imports, migrations, integration test suites — are supported through the dedicated-quota path at enterprise@nebbos.ai. Quotas are issued per operator identity and per operation category; a bulk-read allowance does not extend to a bulk-write path.

Non-substrate operations

Operations that do not traverse the substrate — MCP discovery reads served from the local Cradle cache, audit-chain verification against a locally held chain segment — are not subject to rate limits. Rate limits apply exclusively to substrate-touching calls.