Live StreamsCreate Livestream/Recording
Live Streams

Create Livestream/Recording

curl -X POST "https://api.videograph.ai/video/services/api/v1/livestreams" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic YOUR_CREDENTIALS" \
  -d '{
  "title": "example_string",
  "description": "example_string",
  "region": "example_string",
  "record": true,
  "dvrDurationInMins": 42,
  "tags": [
    "example_string"
  ],
  "metadata": [
    {
      "key": "example_string",
      "value": "example_string"
    }
  ],
  "playback_policy": [
    "public"
  ],
  "recordings_playback_policy": [
    "public"
  ]
}'
{}
POST
/video/services/api/v1/livestreams
POST
Security Scheme
Basic Authentication
Usernamestring
Required

Username for basic authentication

Passwordpassword
Required

Password for basic authentication

Content-Typestring
Required

The media type of the request body

Options: application/json
titlestring
Required

Provide a name for your livestream.

descriptionstring

Livestream description

regionstring
Required

Region for creation ex - us-east-1

recordboolean
Required

Indicates if its liverecording (true) or streaming (false)

dvrDurationInMinsinteger

Indicates the dvr duration to be availbale during playback

Format: int64
tagsarray

Livestream tags

metadataarray

Livestream metadata as keyvalue pair

playback_policyarray

Playback policies. Allowed are public, signed or both

recordings_playback_policyarray

Playback policies for generated recordings. Allowed are public, signed or both

Request Preview
Response

Response will appear here after sending the request

Authentication

basicAuth
header
Authorizationstring
Required

Basic authentication credentials. Provide username and password encoded in Base64 format: Basic base64(username:password)

Body

application/json
titlestring
Required

Provide a name for your livestream.

descriptionstring

Livestream description

regionstring
Required

Region for creation ex - us-east-1

recordboolean
Required

Indicates if its liverecording (true) or streaming (false)

dvrDurationInMinsinteger

Indicates the dvr duration to be availbale during playback

tagsarray

Livestream tags

metadataarray

Livestream metadata as keyvalue pair

playback_policyarray

Playback policies. Allowed are public, signed or both

recordings_playback_policyarray

Playback policies for generated recordings. Allowed are public, signed or both

Responses

Successful response

Was this page helpful?
Built with Documentation.AI

Last updated Dec 29, 2025