Stop a stream

POST

/v1/streams/{streamSettingsId}/stop

curl --request POST \
  --url https://api.ligr.live/rest/v1/streams/1/stop \
  --header 'Authorization: Bearer <token>'

• LIGR REST API

Stops the stream. Every destination stops publishing and the infrastructure is torn down. The state moves through TRANSIT_TO_STOPPED to IDLE, and the stream is then ready for the next start.

Authorizations

• bearer
  streams:write
• api_key
  streams:write

Parameters

Path Parameters

streamSettingsId

required

Entity identifier

integer format: int32

>= 1

The stream settings identifier

Responses

200

Ok

Media typeapplication/json

object

streamSettingsId

required

Entity identifier

integer format: int32

>= 1

state

required

string

matchId

required

Entity identifier

integer format: int32

>= 1

transitioning

required

boolean

Example^generated

{
  "streamSettingsId": 1,
  "state": "example",
  "matchId": 1,
  "transitioning": true
}

400

Request is invalid

Media typeapplication/json

object

message

required

string

details

required

object

key

additional properties

Example^generated

{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Missing or invalid api key

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Api key provides insufficient access for the request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

404

Stream not found

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

429

Api key has made too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

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

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}