specification: API Commons Rate Limits
specificationVersion: '0.1'
provider: Koala
providerId: koala
name: Koala API Rate Limits
description: >
  Koala's server-side batch API and Edge API use API key-based authentication
  with rate limiting applied per project (public API key). The platform uses
  Cloudflare infrastructure. Specific numeric rate limit values are not
  publicly documented; teams encountering limits should implement exponential
  backoff and retry logic. The platform plan tier governs monthly credit
  consumption rather than per-second request rates.
created: '2026-06-12'
modified: '2026-06-12'
headers:
  retryAfter: Retry-After
responseCodes:
  throttled: 429
  unauthorized: 401
  badRequest: 400
limits:
  - scope: project
    metric: server_side_batch_requests
    description: >
      Rate limit applied per Koala project (identified by public API key)
      for server-side batch event ingestion requests to api2.getkoala.com.
    limit: null
    timeFrame: minute
    note: >
      Koala does not publish a specific numeric rate limit for the batch
      ingest API. Clients should implement exponential backoff on 429
      responses and batch events to reduce request frequency.
  - scope: project
    metric: edge_api_requests
    description: >
      Rate limit for the Koala Edge API client used in Cloudflare Workers
      and Vercel Edge Functions.
    limit: null
    timeFrame: minute
    note: >
      Edge API rate limits follow the same project-level enforcement as
      the server-side API. Edge deployments should buffer and batch
      events where possible.
  - scope: account
    metric: webhook_deliveries
    description: >
      Monthly limit on outbound webhook deliveries from Koala automation
      workflows.
    limit: 1000
    timeFrame: month
    note: Applies to Growth plan. Business plan has custom limits.
  - scope: account
    metric: slack_alerts
    description: >
      Monthly limit on Slack alert notifications sent from Koala intent
      signal triggers.
    limit: 250
    timeFrame: month
    note: >
      Applies to Starter plan. Growth plan has unlimited Slack alerts.
      Free plan has no Slack alerts.
authentication:
  type: apiKey
  description: >
    Koala APIs authenticate using the project's Public API Key, which is
    available in the Koala app settings. For server-side and Edge API calls,
    the public API key is embedded in the request URL path or passed as a
    configuration parameter during SDK initialization.
  location: path
  parameterName: public_api_key
retryGuidance:
  strategy: exponential_backoff
  initialDelayMs: 1000
  maxDelayMs: 30000
  jitter: true