Content API Limits

Every number on this page is enforced by the API. Where a value has no enforced limit, the table says so; the request body cap still applies to it.

Request size

Field lengths

Ids per request

List pages

Resource lists return the { "data", "meta" } envelope described in List responses. The page size parameter is not the same on every list:

Every list takes page, starting at 1. order is ASC or DESC. On games and simulations a field outside the listed values returns 422. On modules, courses, slides, and tests, use createdAt, updatedAt, or the title column (title, or name on tests); other values are not supported. A page size above the maximum returns 422.

These routes return a plain array with no paging: GET /v1/content/classrooms, GET /v1/content/organizations, the API key list, the webhook list, and a course's GET .../chapters.

Source JSON expansion

Rate limits

Each key has its own budget, rateLimitPerMinute (1 to 600, default 60), counted over a 60-second window. The budget is shared across every route the key calls, and a busy key never uses up another key's budget. Requests refused with 401, or with 403 for a missing scope or classroom, are not counted.

Every counted response carries:

A request over the limit returns 429:

{
  "error": {
    "code": "content_rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 12 seconds",
    "retryAfterSeconds": 12,
    "status": 429
  }
}

Wait for Retry-After, then send the same request again with the same Idempotency-Key:

// Node.js 18+
async function fetchWithRateLimit(url, init, maxAttempts = 5) {
  for (let attempt = 1; ; attempt++) {
    const response = await fetch(url, init)
 
    if (response.status !== 429 || attempt === maxAttempts) {
      return response
    }
 
    const waitSeconds = Number(response.headers.get('retry-after') ?? '1')
    await new Promise((resolve) => setTimeout(resolve, waitSeconds * 1000))
  }
}

# Python 3 with requests
import time
import requests
 
def request_with_rate_limit(method, url, max_attempts=5, **kwargs):
    for attempt in range(1, max_attempts + 1):
        response = requests.request(method, url, timeout=30, **kwargs)
 
        if response.status_code != 429 or attempt == max_attempts:
            return response
 
        time.sleep(int(response.headers.get("Retry-After", "1")))

To stay under the limit in a batch, read X-RateLimit-Remaining and pause until X-RateLimit-Reset when it reaches 0. A complete wrapper that also handles 5xx, 402, and 409 is in Examples.

Time limits and retention

No enforced limit

These have no limit in the API today. If one is added, it is announced in the Changelog first, as described in Versioning and Deprecation.

• Webhook endpoints per organization.
• Webhook payload size. Payloads are small JSON objects; they do not carry built HTML or media.
• Content API keys per organization.
• Classrooms per key allowlist.
• Resources per classroom.
• Concurrent expansion jobs per key, beyond the rate limit.