Live

Go live immediately

Start a live stream immediately for the specified project.

Prerequisites:

  • Project must have at least one streaming destination configured
  • Project cannot be in plugin mode (use web interface for plugin mode)
  • All destination tokens must be valid (re-authenticate expired tokens)
  • Project cannot have an existing active or scheduled stream
  • User must have available concurrent stream capacity

Metadata Requirements:

  • YouTube streams require a title

Notes:

  • This endpoint always starts immediately, ignoring any scheduled date on the project
  • Use the Schedule Live endpoint for scheduled streams
post/projects/{id}/live

Request

  • Base URL: https://api.livereacting.com/v1/external
  • URL: https://api.livereacting.com/v1/external/projects/{id}/live
  • Auth: HTTP bearer

Path parameters

idstring required
Example:507f1f77bcf86cd799439011

Project ID

Response

Stream started successfully

liveIdstring

Unique identifier for the created live stream

status'PREPARING' | 'SCHEDULED'

Current status of the live stream

scheduledDatestring date-time nullable

Scheduled start time (null for immediate streams)

createdAtstring date-time

When the live stream was created

Example response

{
  "liveId": "507f1f77bcf86cd799439011",
  "status": "PREPARING",
  "createdAt": "2026-01-26T12:00:00Z",
  "destinations": [
    {
      "id": "UCe9N2dd_IxzoffgkzeYgghw",
      "provider": "youtube",
      "name": "My YouTube Channel",
      "status": "PREPARING",
      "viewingUrl": "https://youtube.com/watch?v=abc123"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.