Skip to content

Live Events

Managed live streaming with RTMP ingest, adaptive bitrate HLS playback, three access control modes, automatic recordings, and embeddable watch pages.

Best for: board meetings, product launches, internal all-hands, webinars, and any event that needs a private or public live stream with controlled access.

Create an event | Live Events API reference


What this is

WAYSCloud Live Events is a managed streaming service. You create an event, connect OBS Studio or any RTMP encoder, and the platform handles transcoding, adaptive bitrate delivery, and viewer access control. Events have a watch page at live.wayscloud.services/{slug}. Access can be public, password-protected, or token-gated. Recordings are generated automatically and available for replay after the stream ends.

A rehearsal mode lets you test the full pipeline without making the event visible to viewers.


When to use it

Use this when:

  • You need to live-stream to a controlled audience (internal, paying, or public)
  • You want automatic recordings without additional setup
  • You need access control: password-protected or per-viewer token-gated streams
  • You want embeddable watch pages with no third-party branding

Consider something else when:

  • You need to host pre-recorded video on demand — Live Events is for live streams with optional replay
  • You need real-time video conferencing — Live Events is one-to-many broadcast, not two-way calls

What you get

  • RTMP ingest compatible with OBS Studio, Streamlabs, and any RTMP encoder
  • Adaptive HLS playback with automatic bitrate selection
  • 3 access modes: public, password-protected, token-gated
  • Watch pages at live.wayscloud.services/{slug}
  • Rehearsal mode for testing before going live
  • Automatic recordings with replay URLs
  • Real-time stats: concurrent viewers, peak viewers, stream health
  • 21 API endpoints for full event lifecycle management
  • Rotatable stream keys for security

Pricing

All prices exclude VAT.

ItemUnitEURNOKSEKDKK
Live Events Starterminute0.050.500.500.35
Live Events Startergb_month0.50553.50
Live Events Starterhour0.010.100.100.07

View all plans in dashboard


How it works

  1. Create an event via the dashboard or API. Choose a name, slug, and access type (public, password, or token).
  2. Copy the RTMP URL and stream key. Connect OBS Studio or your encoder.
  3. Start rehearsal to test the stream. Only you can see it.
  4. Go live when ready. The watch page becomes active at live.wayscloud.services/{slug}.
  5. Stop the stream when finished. The recording is processed automatically.
  6. Share the replay URL or download the recording.

What you see in the dashboard

  • Event list: name, status badge (scheduled / ready / rehearsal / live / ending / ended), viewer count
  • Ingest panel: RTMP URL, stream key (with rotate button), connection status
  • Live stats: concurrent viewers, peak viewers, stream health indicators (bitrate, dropped frames)
  • Access control: password field, token generation with count and expiry
  • Recordings: replay URL, duration, file size, download link
  • Event timeline: status transitions with timestamps

Fastest way to get started

Dashboard

  1. Open my.wayscloud.services and go to Communication then Live Events
  2. Click Create Event, enter a name and slug, choose Public access
  3. Copy the RTMP URL and stream key into OBS Studio
  4. Click Rehearsal to test, then Go Live

API

bash
curl -X POST https://api.wayscloud.services/v1/live-events/events \
  -H "X-API-Key: wayscloud_live_abc12_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Launch Q2",
    "slug": "product-launch-q2",
    "access_type": "public",
    "description": "Live product announcement"
  }'

Example request and response

Request: Create a token-gated event

bash
curl -X POST https://api.wayscloud.services/v1/live-events/events \
  -H "X-API-Key: wayscloud_live_abc12_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q2 Board Meeting",
    "slug": "q2-board-2026",
    "access_type": "token",
    "description": "Quarterly board presentation — confidential"
  }'

Response:

json
{
  "event_id": "evt-8a3f1b2c-d4e5-6789-abcd-0123456789ef",
  "name": "Q2 Board Meeting",
  "slug": "q2-board-2026",
  "access_type": "token",
  "status": "ready",
  "watch_url": "https://live.wayscloud.services/q2-board-2026",
  "ingest": {
    "rtmp_url": "rtmp://live.wayscloud.services/ingest",
    "stream_key": "sk-a1b2c3d4e5f6..."
  },
  "created_at": "2026-03-30T09:00:00Z"
}

Generate viewer tokens:

bash
curl -X POST https://api.wayscloud.services/v1/live-events/events/evt-8a3f1b2c.../tokens \
  -H "X-API-Key: wayscloud_live_abc12_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "count": 12,
    "label": "Board members",
    "max_uses": 1,
    "expires_at": "2026-04-01T23:59:59Z"
  }'

Go live:

bash
curl -X POST https://api.wayscloud.services/v1/live-events/events/evt-8a3f1b2c.../live/start \
  -H "X-API-Key: wayscloud_live_abc12_YOUR_SECRET"

Event lifecycle:

StatusMeaning
scheduledCreated, not yet configured
readyStream key assigned, encoder can connect
rehearsalTest stream active, not visible to viewers
liveBroadcasting to viewers
endingStream stopped, processing recording
endedRecording available, event closed

Common use cases

  • Board meetings — token-gated access with per-member tokens and automatic recording
  • Product launches — public watch page with embeddable player
  • Internal all-hands — password-protected for company-wide access
  • Training sessions — rehearsal mode to practice, then go live with recording for latecomers
  • Webinars — token-gated registration flow, real-time viewer stats


Open in dashboard

WAYSCloud AS