Resources

Changelog

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

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, unauthorized, plan_required, insufficient_scope, vertical_mismatch, not_found, rate_limited, db_error).
• iGaming vertical — vertical: "igaming" streams with brand vertical locking and a +$0.10/min 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. Subscribe to this page for updates, or check API pricing and Errors & rate limits for the current contract.