Manage live stream sources

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Use the Wowza Streaming Engine™ media server software REST API to create and manage encoders and cameras that publish live streams.

Notes:

• Wowza Streaming Engine 4.3.0 or later is required.
• PHP examples for the tasks in this article are available in the tests folder of the PHP REST Library for Wowza Streaming Engine on GitHub.

Get a list of live stream sources

View a list of the live stream sources (publishers) connected to a local instance of Wowza Streaming Engine:

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers

The command should return a response that looks like this:

{
  "serverName": "serverName",
  "publishers": [{
    "publisher": "myRTSPcamera"
  }]
}

Create a live stream source

Create a live stream source (publisher) for a local instance of Wowza Streaming Engine named myRTMPencoder:

curl -X POST \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers \
-d '{
  "password": "123",
  "publisher": "myRTMPencoder",
  "serverName": "",
  "description": "",
  "version": "3"
}'

The command should return a response that looks like this:

{
  "success": true,
  "message": "",
  "data": null
}

Update a live stream source

Update a live stream source (publisher) named myRTMPencoder for a local instance of Wowza Streaming Engine:

Note: You'll replace myRTMPencoder with the name of your live stream source (publisher).

curl -X PUT \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers/myRTMPencoder \
-d '{
  "password": "newpassword",
  "publisher": "publisher",
  "serverName": "",
  "description": "",
  "version": "3"
}'

The command should return a response that looks like this:

{
  "success": true,
  "message": "publisher updated",
  "data": null
}

Remove a live stream source

Delete a live stream source (publisher) named myRTMPencoder:

curl -X DELETE \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v3/servers/{serverName}/publishers/myRTMPencoder