API Reference

The Rebel Audio API allows you to receive event notifications via webhooks and embed a read-only player in your show notes pages.

Authentication

All API requests use bearer token authentication. Find your token in Account → Developer Settings.

Authorization: Bearer rba_live_xxxxxxxxxxxxxxxxxxxxx

Rate limits

Plan	Rate limit
Creator	`100 requests / min`
Studio	`500 requests / min`

Webhook events

Configure webhook URLs in Account → Developer Settings → Webhooks. We send a POST request to your URL for each event.

session.started

Fired when a host clicks Record in a session.

{
  "event": "session.started",
  "session_id": "ses_abc123",
  "episode_name": "Episode 42",
  "timestamp": "2026-03-15T14:32:00Z"
}

session.ended

Fired when a host clicks End Session.

{
  "event": "session.ended",
  "session_id": "ses_abc123",
  "duration_seconds": 3742,
  "track_count": 2,
  "timestamp": "2026-03-15T15:36:22Z"
}

export.ready

Fired when a project export completes and a download URL is available.

{
  "event": "export.ready",
  "project_id": "prj_xyz789",
  "export_type": "mixed-down",
  "format": "mp3",
  "lufs_target": -16,
  "download_url": "https://cdn.rebelaudio.org/exports/...",
  "expires_at": "2026-03-22T15:36:22Z"
}

clip.created

Fired when a vertical clip export completes.

{
  "event": "clip.created",
  "clip_id": "clp_mno456",
  "project_id": "prj_xyz789",
  "duration_seconds": 47,
  "format": "mp4",
  "resolution": "1080x1920",
  "download_url": "https://cdn.rebelaudio.org/clips/..."
}

Embed API

The embed API provides a read-only player for your show notes pages. Embed using an <iframe>:

<iframe
  src="https://rebelaudio.org/embed/player?project=prj_xyz789&token=rba_embed_xxx"
  width="100%"
  height="80"
  frameborder="0"
  allow="autoplay">
</iframe>

Embed tokens are read-only and can be generated separately from API tokens in Account → Developer Settings → Embed Tokens.