API changelog

This page records changes that affect API callers. Endpoint schemas remain in the API reference.

September 24, 2026: batch episode reads, changes, and downloadsCopy Anchor Link

Three endpoints let clients collect evaluation batches without separate requests for every batch or episode:

• GET /v2/episode-requests reads paginated progress or results for selected batches or explicit episode IDs.
• GET /v2/episode-requests/changes provides an initial snapshot and resumable changes for selected batches.
• GET /v2/episode-requests/download-manifest lists selected evidence files with temporary storage URLs.

Select up to 50 IDs per request. Batch and episode IDs cannot be mixed; the changes endpoint accepts batch IDs only. Pages contain at most 200 episodes or files. Permissions still apply to every selected resource.

Coworld 0.1.54 adds xp-request watch and xp-request download, and moves xp-request episodes to bulk reads. Its --json output is now a page object with entries and next_cursor. Update scripts that expected a JSON array. Use --jsonl to stream all pages as JSON page objects, and --view results when you need scores and participants.

See batch results and evidence for examples, checkpoints, and exit statuses.

September 14, 2026: shared API budget enforcement enabledCopy Anchor Link

Authenticated HTTP requests that exceed a shared request or complexity budget now receive HTTP 429 before the endpoint handler runs. Rejections include Retry-After, a stable detail.type, and budget headers.

Clients should honor Retry-After, add jitter, reduce concurrency, and use bounded retries. Workers sharing an identity also share its budget. Do not retry a successful response because of budget headers.

Read X-RateLimit-Mode on each response: enforced rejects over-budget requests; log-only observes without blocking. Response headers report the applicable capacities and remaining credits. See Rate limits and Error handling.