Projects

Create a project

Creates a new project with the specified configuration.

Only name is required. All other fields have sensible defaults:

  • title defaults to name
  • format defaults to 16:9_720p
  • audioQuality defaults to 128k
  • privacyStatus defaults to public on all platforms
post/projects

Request

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

Request body

namestring required

Project name (1-60 characters)

titlestring

Stream title (max 100 characters). Defaults to name if not provided.

descriptionstring

Stream description (max 5000 characters)

format'1:1' | '1:1_720p' | '1:1_1080p' | '1:1_2160p' | '9:16' | '9:16_720p' | '9:16_1080p' | '9:16_2160p' | '16:9' | '16:9_720p' | '16:9_1080p' | '16:9_2160p' | '1:2' | '1:2_720p' | '1:2_1080p' | '1:2_2160p'

Video format string. Note - responses return format as an object { aspectRatio, resolution } for clarity.

destinationIdsstring[]

Array of destination IDs from GET /destinations

audioQuality'128k' | '256k' | '320k'

Audio quality setting

autoSynchboolean

When true, changes to project are automatically synced to active live stream

Example request

{
  "name": "My New Project",
  "title": "Stream Title",
  "description": "About this stream",
  "format": "16:9_1080p",
  "destinationIds": [
    "UCe9N2dd_IxzoffgkzeYgghw"
  ],
  "audioQuality": "128k",
  "privacyStatus": {
    "youtube": "public",
    "facebook": "EVERYONE"
  },
  "duration": {
    "planned": 3600
  },
  "youtubeAdvancedSettings": {
    "tags": [
      "gaming",
      "live stream",
      "entertainment"
    ]
  }
}

Response

Project created successfully

idstring

Unique project identifier

namestring nullable

Project name

titlestring nullable

Stream title

descriptionstring nullable

Stream description

createdAtstring date-time nullable

Project creation date

audioQuality'128k' | '256k' | '320k'

Audio quality setting

autoSynchboolean

When true, changes to project are automatically synced to active live stream

maxFps30 | 60

Maximum frames per second for this project. Read-only (set via platform UI).

customBitrateinteger nullable

Custom streaming bitrate in kbps. Read-only (set via platform UI). Null when using default.

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "name": "My Project",
  "title": "Stream Title",
  "description": "About this stream",
  "format": {
    "aspectRatio": "16:9",
    "resolution": "1920x1080"
  },
  "createdAt": "2026-01-23T10:00:00Z",
  "audioQuality": "128k",
  "maxFps": 30,
  "privacyStatus": {
    "youtube": "public",
    "facebook": "EVERYONE"
  },
  "destinations": [
    {
      "provider": "youtube",
      "name": "My YouTube Channel"
    }
  ],
  "youtubeAdvancedSettings": {
    "tags": [
      "gaming",
      "live stream",
      "entertainment"
    ]
  }
}

Changes

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