Skip to main content

2026.10.16 — v1.2.0

Added the DJ identifier and donation history APIs and the follow event, and added subscription info to the listener list.

  • Read the DJ identifier — added GET /v1/me. It needs the me.read permission, on air or not. The userId in the response is the same value as the event stream's user.id.
  • List donations — added GET /v1/live/donations. Recover the donations that arrived while your bot was down. It uses the new donations.read permission.
  • List listeners — added subscription ({ "plan": "PLAN_1"–"PLAN_3" }, null means not a subscriber) to the response, for subscriber-only greetings and perks.
  • Follow event — added follow to the event stream. It needs the new events.follow permission and, like presence, a manager appointment. Only the first follow per listener per broadcast arrives.
  • Tokens — documented the flow of saving userId via GET /v1/me right after receiving a token, and revoking the same DJ's previous tokens.
  • Build a bot — added the DJ identifier step to the token exchange section.