Resources

Changelog

All notable changes to the TwinTone API (v1) are documented here. Entries are dated and grouped by Added / Changed / Fixed.

2026-09-04

Fixed

• iGaming platform restrictions unified across the docs: iGaming brands may stream to kick, youtube and twitch (was stated inconsistently).
• The OpenAPI spec is now downloadable directly from the docs site (/openapi.yaml) — the spec was previously only reachable via a private GitHub link.
• Error reference now documents the two 402 responses stream creation can return: no_minutes (plan minutes exhausted) and insufficient_credits (credit wallet can't cover the stream).
• Rate-limit docs no longer promise a Retry-After header the API doesn't send.
• Clarified that crypto in the webhook signature examples is Node's standard hashing library (not cryptocurrency), and corrected the webhook testing notes.

2026-08-07

v1 — initial release

The TwinTone API launches in early access. Endpoints are stable but the surface area is intentionally small; webhook event taxonomies are versioned so additions never break existing integrations.

Added

• Streams — programmatic control of AI-hosted live streams:
  • POST /api/v1/streams — start a stream (agent dispatch, lifecycle preparing → live → ended | error).
  • GET /api/v1/streams — list your brand's streams with status / limit / offset filters.
  • GET /api/v1/streams/{id} — full stream detail including event history.
  • DELETE /api/v1/streams/{id} — end a live stream and stop billing.
• Analytics — GET /api/v1/analytics with period (24h / 7d / 30d) and per-stream filters; platform breakdown and per-stream rows included.
• Webhooks — POST / GET / DELETE /api/v1/webhooks with stream.started, stream.ended, and stream.error events, HMAC-SHA256 signature verification (X-TwinTone-Signature), 5-minute replay window, and up to 5 retries with exponential backoff.
• Scoped API keys — tt_live_… / tt_test_… keys with least-privilege scopes (streams:read, streams:write, analytics:read, webhooks:write), created in Billing → API keys.
• Test mode — tt_test_ keys simulate the full request/response lifecycle with no agent dispatch and no billing, so integrations can be built and verified for free.
• Unified error envelope — every error returns { "error": { "code", "message" } } with stable codes (missing_fields, invalid_fields, invalid_creator, unauthorized, insufficient_scope, vertical_mismatch, not_found, rate_limited, concurrency_limit, db_error, launch_failed).
• iGaming vertical — vertical: "igaming" streams with brand vertical locking and an iGaming surcharge. See the iGaming guide.

Changed

• Nothing — this is the initial release.

Fixed

• Nothing — this is the initial release.

Documentation is versioned with the API. Check this page for updates, or see API pricing and Errors & rate limits for the current contract.