Use this endpoint to fetch the current configuration for a single stream, identified by its name. The response includes the stream’s name and the full list of push targets currently associated with it. If the stream does not exist, the server returns a 404 with an error message.

Endpoint

GET /api/streams/{id}

Path parameters

id
string
required
The name of the stream to retrieve. This is the same name used when the stream was created.

Example request

curl http://your-server:6070/api/streams/my-stream
With authentication enabled:
curl -u user:pass http://your-server:6070/api/streams/my-stream

Example response

{
  "name": "my-stream",
  "targets": [
    { "name": "YouTube", "url": "rtmp://a.rtmp.youtube.com/live2/KEY" }
  ]
}

Response fields

name
string
required
The unique name of the stream.
targets
object[]
required
All push targets currently configured for this stream.

Error responses

StatusError valueCause
404stream not foundNo stream with the given name exists.