JustOnAir docs
For AI agents llms.txt OpenAPI Dashboard
View as Markdown

Changelog

Every change to the API, newest first. The newest version here is the version of openapi.json.

Each entry is one API version. The newest one is also info.version in openapi.json: if the spec you cached has an older version, something below is new to you. New fields, endpoints and error codes bump the middle number, so write clients that ignore fields they don't know.

The Node.js SDK has its own changelog.

1.6.0 (2026-10-08)

  • Every response has an X-Request-Id header, and every error body has error.request_id. Quote it when you write to us.
  • Retry-After header on errors that go away by waiting: rate_limited, limit_creation_rate (also details.retry_after_seconds), chat_slow_mode, chat_rate_limited, chat_busy and no_capacity.
  • GET https://api.justonair.com/ answers with links to the docs, openapi.json and llms.txt.
  • openapi.json has an example for every request body and response, and x-error-codes on every error response.

1.5.0 (2026-10-08)

  • Chat moderators: active_days (1–30, default 30) when you invite one, and active_until on the moderator.

1.4.0 (2026-10-08)

  • player.allowed_domains: the sites allowed to embed the player and chat page, and to post to chat (origin_not_allowed).
  • Moderator links: POST /v1/streams/{id}/chat/moderators and the moderator endpoints under /v1/embed/{id}/mod. Messages and bans say who acted (deleted_by, created_by).
  • reaction_sampling in the public chat read.

1.3.0 (2026-10-08)

  • Viewer chat and emoji reactions (beta): chat settings on streams, the public chat endpoints under /v1/embed/{id}, and the owner's feed and moderation under /v1/streams/{id}/chat.

1.2.0 (2026-10-05)

  • Thumbnails: thumbnail on streams, poster_url in the embed read, and the public thumbnail URL.

1.1.0 (2026-09-30)

  • player.enabled: switch the public hosted player off for streams you gate yourself.
  • player.watch_minutes_limit, player.closed_at and the embed status closed.
  • Postpaid accounts: billing_mode in usage, and the balance.* webhook events.
  • Viewer beats take a viewer session token (t), so counts can't be forged.

1.0.0 (2026-09-29)

  • Streams: create, get, list, update, end; replace a lost key; the reservation countdown; cost per stream.
  • Playback tokens, recordings (download, delete), usage and balance.
  • The hosted player and its public embed read.
  • Viewer counts: viewers, viewers_now, and per minute and by country.
  • Webhooks (Standard Webhooks) with a delivery log; credit warnings by email and webhook.