Apian Labs
Beta • SLAs Suspended

Limits & quotas

Apian Labs Relay enforces limits to keep delivery reliable and protect shared infrastructure. If you need higher limits, contact support and we will tune them for your workload.

Rate limits

  • Limits are enforced per workspace and API key.
  • Default: 120 requests per minute per workspace and API key in both test and production.
  • Requests over the limit return HTTP 429 with a Retry-After hint.
  • Burst behavior is governed by the per-minute window; requests above the limit are rejected.

Request size limits

  • Max JSON body size: 100 KB by default. Contact support if you need larger payloads.

Idempotency

  • Send Idempotency-Key (or x-idempotency-key) on POST /v1/messages (base URL https://api.apianlabs.com/v1) to safely retry requests.
  • You can also include idempotencyKey in the request body for compatibility.
  • When the same idempotency key is reused, Relay returns the original result rather than creating a duplicate message (24-hour window).

See the API reference for header names and examples.

Retry + failover behavior

  • By default, Relay makes up to 2 attempts per provider for retryable failures (timeouts, 5xx, or rate limiting).
  • Retries use jittered exponential backoff (base 200ms, max 2000ms) before the next attempt.
  • You can override retryPolicy.maxAttempts, retryPolicy.retryableErrors, and retryPolicy.backoff in the routing policy rules.
  • Failover follows the provider order after retries or cooldown rules are met (when failover is enabled).
  • Each decision is recorded in the trace timeline and webhook events.

Webhook delivery

  • Webhook deliveries are attempted once by default (no automatic retries).
  • If you need retries or replay tooling, contact support.

Trace retention

  • Trace timelines and receipts are retained for the duration of the workspace by default.
  • Deletion or shorter retention windows are available on request; backups may persist for a limited period.

Test mode limits

  • Test mode destinations must be allowlisted in the Relay console.
  • Production limits are enabled after verification and onboarding.

Plan-based differences

  • Default limits apply to all plans unless otherwise agreed in your contract.
  • Enterprise plans can negotiate custom limits, retention, and webhook retry policies.

Need higher limits?

Contact support to adjust limits for your account.