Skip to content

Set input latency

POST/v1/streams/{streamSettingsId}/input/latency

POST
/v1/streams/{streamSettingsId}/input/latency
curl --request POST \
--url https://api.ligr.live/rest/v1/streams/1/input/latency \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "latencyMs": 1 }'

Sets the receive latency of the input of a stream. The value is saved on the input, so it applies to the next start too. A running input restarts with the new value, which drops the output for a few seconds.

streamSettingsId
required

Entity identifier

integer format: int32
>= 1

The stream settings identifier

Media typeapplication/json
object
latencyMs
required

Receive latency of the input in milliseconds. A higher value absorbs more network jitter and adds the same delay to the picture.

integer format: int32
<= 60000
Examplegenerated
{
"latencyMs": 1
}

Ok

Media typeapplication/json
object
inputId
required

Entity identifier

integer format: int32
>= 1
latencyMs
required

The latency now saved on the input, in milliseconds.

integer format: int32
Examplegenerated
{
"inputId": 1,
"latencyMs": 1
}

Request is invalid

Media typeapplication/json
object
message
required
string
details
required
object
key
additional properties
Examplegenerated
{
"message": "example",
"details": {
"additionalProperty": "example"
}
}

Missing or invalid api key

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

Api key provides insufficient access for the request

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

Stream not found

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

Api key has made too many requests

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

An unexpected error has occured. If problems persist please contact support

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}