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"
]
}'
import requests
import json
url = "https://api.videograph.ai/video/services/api/v1/livestreams"
headers = {
"Content-Type": "application/json",
"Authorization": "Basic YOUR_CREDENTIALS"
}
data = {
"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"
]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api.videograph.ai/video/services/api/v1/livestreams", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Basic YOUR_CREDENTIALS"
},
body: JSON.stringify({
"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"
]
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"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"
]
}`)
req, err := http.NewRequest("POST", "https://api.videograph.ai/video/services/api/v1/livestreams", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Basic YOUR_CREDENTIALS")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.videograph.ai/video/services/api/v1/livestreams')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Basic YOUR_CREDENTIALS'
request.body = '{
"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"
]
}'
response = http.request(request)
puts response.body
{}
/video/services/api/v1/livestreams
Username for basic authentication
Password for basic authentication
The media type of the request body
Provide a name for your livestream.
Livestream description
Region for creation ex - us-east-1
Indicates if its liverecording (true) or streaming (false)
Indicates the dvr duration to be availbale during playback
Livestream metadata as keyvalue pair
Playback policies. Allowed are public, signed or both
Playback policies for generated recordings. Allowed are public, signed or both
Request Preview
Response
Response will appear here after sending the request
Authentication
Basic authentication credentials. Provide username and password encoded in Base64 format: Basic base64(username:password)
Body
Provide a name for your livestream.
Livestream description
Region for creation ex - us-east-1
Indicates if its liverecording (true) or streaming (false)
Indicates the dvr duration to be availbale during playback
Livestream metadata as keyvalue pair
Playback policies. Allowed are public, signed or both
Playback policies for generated recordings. Allowed are public, signed or both
Responses
Successful response
Last updated Dec 29, 2025

