Skip to content
Wowza Streaming Engine
/
/Servers Configuration

Wowza Streaming Engine REST API (2.0.0)

Complete REST API for Wowza Streaming Engine. Auto-converted from Swagger 1.2 (http://localhost:8089/swagger.json) to OpenAPI 3.0.3 for public documentation.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL
https://www.wowza.com/docs/wowza-streaming-engine-rest-api
License
Wowza Media Systems
Languages
Servers
Wowza Streaming Engine Server
http://localhost:8089
Documentation Server
http://localhost:8087

Application Operations

Operations

Machine Level Current Statistics

Operations

Machine Level Historic Statistics

Operations

Server Licenses

Operations

Server Listeners

Operations

Server log4j system

Operations

Server MediaCache

Operations

Server MediaCache Version 3

Operations

Server MediaCasters

Operations

Server Monitoring

Operations

Server Publishers

Operations

Server Publishers Version 3

Operations

REST information

Operations

Servers Configuration

Operations

Retrieves the list of Servers

Request

This API is available in builds 15089 or later.

Security
basicAuth
curl -i -X GET \
  -u <username>:<password> \
  http://localhost:8089/v2/servers

Responses

Successful response

Bodyapplication/json
serversArray of objects(ServerConfig)required
servers[].​transportThreadPoolAutoValuestringrequired
servers[].​handlerThreadPoolstringrequired
servers[].​transportThreadPoolstringrequired
servers[].​ipAddressstringrequired
servers[].​serverId1stringrequired
servers[].​serverNamestringrequired
servers[].​descriptionstringrequired
servers[].​rtpDataPortSharingPortinteger(int32)required
servers[].​versionstringrequired
servers[].​serverId2stringrequired
servers[].​serverTSinteger(int64)required
servers[].​portinteger(int32)required
servers[].​serverListenersobject(ServerListenersConfig)required
servers[].​serverListeners.​serverListenersArray of objects(ServerListenerConfig)required
servers[].​serverListeners.​serverListeners[].​serverNamestringrequired
servers[].​serverListeners.​serverListeners[].​baseClassstringrequired
servers[].​serverListeners.​serverListeners[].​saveFieldListArray of strings
servers[].​serverListeners.​serverListeners[].​versionstringrequired
servers[].​serverListeners.​serverListeners[].​orderinteger(int32)required
servers[].​serverListeners.​serverNamestringrequired
servers[].​serverListeners.​saveFieldListArray of strings
servers[].​serverListeners.​versionstringrequired
servers[].​namestringrequired
servers[].​rtpDataPortSharingbooleanrequired
servers[].​handlerThreadPoolAutoValuestringrequired
servers[].​defaultStreamPrefixstringrequired
servers[].​saveFieldListArray of strings
serverNamestringrequired
saveFieldListArray of strings
versionstringrequired
Response
application/json
{
  "servers": [
    { … }
  ],
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "version": "string"
}

Retrieves the Server configuration

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}'

Responses

Successful response

Bodyapplication/json
transportThreadPoolAutoValuestringrequired
handlerThreadPoolstringrequired
transportThreadPoolstringrequired
ipAddressstringrequired
serverId1stringrequired
serverNamestringrequired
descriptionstringrequired
rtpDataPortSharingPortinteger(int32)required
versionstringrequired
serverId2stringrequired
serverTSinteger(int64)required
portinteger(int32)required
serverListenersobject(ServerListenersConfig)required
serverListeners.​serverListenersArray of objects(ServerListenerConfig)required
serverListeners.​serverListeners[].​serverNamestringrequired
serverListeners.​serverListeners[].​baseClassstringrequired
serverListeners.​serverListeners[].​saveFieldListArray of strings
serverListeners.​serverListeners[].​versionstringrequired
serverListeners.​serverListeners[].​orderinteger(int32)required
serverListeners.​serverNamestringrequired
serverListeners.​saveFieldListArray of strings
serverListeners.​versionstringrequired
namestringrequired
rtpDataPortSharingbooleanrequired
handlerThreadPoolAutoValuestringrequired
defaultStreamPrefixstringrequired
saveFieldListArray of strings
Response
application/json
{
  "transportThreadPoolAutoValue": "string",
  "handlerThreadPool": "string",
  "transportThreadPool": "string",
  "ipAddress": "string",
  "serverId1": "string",
  "serverName": "string",
  "description": "string",
  "rtpDataPortSharingPort": 0,
  "version": "string",
  "serverId2": "string",
  "serverTS": 0,
  "port": 0,
  "serverListeners": {
    "serverListeners": [ … ],
    "serverName": "string",
    "saveFieldList": [ … ],
    "version": "string"
  },
  "name": "string",
  "rtpDataPortSharing": true,
  "handlerThreadPoolAutoValue": "string",
  "defaultStreamPrefix": "string",
  "saveFieldList": [
    "string"
  ]
}

Updates the Server configuration

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
Bodyapplication/jsonrequired
transportThreadPoolAutoValuestringrequired
handlerThreadPoolstringrequired
transportThreadPoolstringrequired
ipAddressstringrequired
serverId1stringrequired
serverNamestringrequired
descriptionstringrequired
rtpDataPortSharingPortinteger(int32)required
versionstringrequired
serverId2stringrequired
serverTSinteger(int64)required
portinteger(int32)required
serverListenersobject(ServerListenersConfig)required
serverListeners.​serverListenersArray of objects(ServerListenerConfig)required
serverListeners.​serverListeners[].​serverNamestringrequired
serverListeners.​serverListeners[].​baseClassstringrequired
serverListeners.​serverListeners[].​saveFieldListArray of strings
serverListeners.​serverListeners[].​versionstringrequired
serverListeners.​serverListeners[].​orderinteger(int32)required
serverListeners.​serverNamestringrequired
serverListeners.​saveFieldListArray of strings
serverListeners.​versionstringrequired
namestringrequired
rtpDataPortSharingbooleanrequired
handlerThreadPoolAutoValuestringrequired
defaultStreamPrefixstringrequired
saveFieldListArray of strings
curl -i -X PUT \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}' \
  -H 'Content-Type: application/json' \
  -d '{
    "transportThreadPoolAutoValue": "string",
    "handlerThreadPool": "string",
    "transportThreadPool": "string",
    "ipAddress": "string",
    "serverId1": "string",
    "serverName": "string",
    "description": "string",
    "rtpDataPortSharingPort": 0,
    "version": "string",
    "serverId2": "string",
    "serverTS": 0,
    "port": 0,
    "serverListeners": {
      "serverListeners": [
        {
          "serverName": "string",
          "baseClass": "string",
          "saveFieldList": [
            "string"
          ],
          "version": "string",
          "order": 0
        }
      ],
      "serverName": "string",
      "saveFieldList": [
        "string"
      ],
      "version": "string"
    },
    "name": "string",
    "rtpDataPortSharing": true,
    "handlerThreadPoolAutoValue": "string",
    "defaultStreamPrefix": "string",
    "saveFieldList": [
      "string"
    ]
  }'

Responses

Successful response

Tells the Server to perform an action

Request

This API is available in builds 18647 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
actionstringrequired

The action which should be performed by the server

Enum"heapDump""restart""stackTrace""start""stop"
Query
filenamestring

The file location to use when creating a heap dump or stack trace. By default the installation location and file are named appropriately for a heap dump or stack trace

curl -i -X PUT \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/actions/{action}?filename=string'

Responses

Successful response

Retrieves the advanced Server configuration

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/adv'

Responses

Successful response

Bodyapplication/json
serverListenersArray of objects(ServerListenerConfig)required
serverListeners[].​serverNamestringrequired
serverListeners[].​baseClassstringrequired
serverListeners[].​saveFieldListArray of strings
serverListeners[].​versionstringrequired
serverListeners[].​orderinteger(int32)required
advancedSettingsArray of objects(AdvancedSetting)required
advancedSettings[].​sectionNamestringrequired
advancedSettings[].​canRemovebooleanrequired
advancedSettings[].​defaultValuestringrequired
advancedSettings[].​documentedbooleanrequired
advancedSettings[].​namestringrequired
advancedSettings[].​sectionstringrequired
advancedSettings[].​typestringrequired
advancedSettings[].​valuestringrequired
advancedSettings[].​initialValuestringrequired
advancedSettings[].​enabledbooleanrequired
serverNamestringrequired
saveFieldListArray of strings
versionstringrequired
Response
application/json
{
  "serverListeners": [
    { … }
  ],
  "advancedSettings": [
    { … }
  ],
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "version": "string"
}

Updates the advanced Server configuration

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
Bodyapplication/jsonrequired
serverListenersArray of objects(ServerListenerConfig)required
serverListeners[].​serverNamestringrequired
serverListeners[].​baseClassstringrequired
serverListeners[].​saveFieldListArray of strings
serverListeners[].​versionstringrequired
serverListeners[].​orderinteger(int32)required
advancedSettingsArray of objects(AdvancedSetting)required
advancedSettings[].​sectionNamestringrequired
advancedSettings[].​canRemovebooleanrequired
advancedSettings[].​defaultValuestringrequired
advancedSettings[].​documentedbooleanrequired
advancedSettings[].​namestringrequired
advancedSettings[].​sectionstringrequired
advancedSettings[].​typestringrequired
advancedSettings[].​valuestringrequired
advancedSettings[].​initialValuestringrequired
advancedSettings[].​enabledbooleanrequired
serverNamestringrequired
saveFieldListArray of strings
versionstringrequired
curl -i -X PUT \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/adv' \
  -H 'Content-Type: application/json' \
  -d '{
    "serverListeners": [
      {
        "serverName": "string",
        "baseClass": "string",
        "saveFieldList": [
          "string"
        ],
        "version": "string",
        "order": 0
      }
    ],
    "advancedSettings": [
      {
        "sectionName": "string",
        "canRemove": true,
        "defaultValue": "string",
        "documented": true,
        "name": "string",
        "section": "string",
        "type": "string",
        "value": "string",
        "initialValue": "string",
        "enabled": true
      }
    ],
    "serverName": "string",
    "saveFieldList": [
      "string"
    ],
    "version": "string"
  }'

Responses

Successful response

Retrieves the list of server log files

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
Query
orderstring

The order of files in serverLogs list

Default "newestFirst"
Enum"newestFirst""oldestFirst"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/logfiles?order=newestFirst'

Responses

Successful response

Bodyapplication/json
serverNamestringrequired
saveFieldListArray of strings
versionstringrequired
serverLogFilesArray of objects(ServerLogShortObject)required
serverLogFiles[].​fileSizeinteger(int64)required
serverLogFiles[].​startDateMSinteger(int64)required
serverLogFiles[].​idstringrequired
serverLogFiles[].​hrefstringrequired
Response
application/json
{
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "version": "string",
  "serverLogFiles": [
    { … }
  ]
}

Retrieves the contents of a Server Log with the specified log name

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
logNamestringrequired

The name of the log

Query
lineCountstring

The number of log lines requested, where a postive number indicates log lines after startOffset and a negative number indicate log lines before startOffset

Default "100"
startOffsetstring

The byte offset in the file at which to begin getting log lines

filterstring

A string containing a list of predefined search filters separated by | where valid strings are noDebug,noInfo,noWarn,noError,noHeader,noColumnHeadings

searchstring

A string containing a literal string on which to filter or a regex

regexSearchstring

Indicates if the 'search' parameter is a regex or a literal string

Default "false"
Enum"false""true"
headstring

Returns the first x lines from the requested log file, the overrides the startoffset and linecount values

tailstring

Returns the last x lines from the requested log file, the overrides the startoffset and linecount values

curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/logfiles/{logName}?lineCount=100&startOffset=string&filter=string&search=string&regexSearch=false&head=string&tail=string'

Responses

Successful response

Bodyapplication/json
endOffsetinteger(int64)required
logStartDatestringrequired
logDatestringrequired
endDatestringrequired
serverNamestringrequired
versionstringrequired
logLinesArray of stringsrequired
filterStrstringrequired
retLineCountinteger(int64)required
logFieldsstringrequired
logSoftwarestringrequired
startOffsetinteger(int64)required
searchStrstringrequired
regexSearchbooleanrequired
logVersionstringrequired
saveFieldListArray of strings
fileLengthinteger(int64)required
startDatestringrequired
Response
application/json
{
  "endOffset": 0,
  "logStartDate": "string",
  "logDate": "string",
  "endDate": "string",
  "serverName": "string",
  "version": "string",
  "logLines": [
    "string"
  ],
  "filterStr": "string",
  "retLineCount": 0,
  "logFields": "string",
  "logSoftware": "string",
  "startOffset": 0,
  "searchStr": "string",
  "regexSearch": true,
  "logVersion": "string",
  "saveFieldList": [
    "string"
  ],
  "fileLength": 0,
  "startDate": "string"
}

Retrieves the Server Log file for the specified log name, zipped

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
logNamestringrequired

The name of the log

curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/logfiles/{logName}/download'

Responses

Successful response

Bodyapplication/json
serverNamestringrequired
saveFieldListArray of strings
versionstringrequired
Response
application/json
{
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "version": "string"
}

Retrieves the list of available server Log Types

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/logs'

Responses

Successful response

Bodyapplication/json
serverNamestringrequired
serverLogTypeArray of stringsrequired
saveFieldListArray of strings
versionstringrequired
Response
application/json
{
  "serverName": "string",
  "serverLogType": [
    "string"
  ],
  "saveFieldList": [
    "string"
  ],
  "version": "string"
}

Retrieves the contents of multiple Server Logs with the specified type in the log name

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
logTypestringrequired

The type of the log

Query
lineCountstring

The number of log lines requested, where a postive number indicates log lines after startOffset and a negative number indicate log lines before startOffset

Default "100"
startOffsetstring

The byte offset in the file at which to begin getting log lines

filterstring

A string containing a list of predefined search filters separated by | where valid strings are noDebug,noInfo,noWarn,noError,noHeader,noColumnHeadings

searchstring

A string containing a literal string on which to filter or a regex

regexSearchstring

Indicates if the 'search' parameter is a regex or a literal string

Default "false"
Enum"false""true"
headstring

Returns the first x lines from the requested log file, the overrides the startoffset and linecount values

tailstring

Returns the last x lines from the requested log file, the overrides the startoffset and linecount values

startDatestring

The start date to filter on (UTC milliseconds)

endDatestring

The end date to filter on (UTC milliseconds)

curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/logs/{logType}?lineCount=100&startOffset=string&filter=string&search=string&regexSearch=false&head=string&tail=string&startDate=string&endDate=string'

Responses

Successful response

Bodyapplication/json
endOffsetinteger(int64)required
logStartDatestringrequired
logDatestringrequired
endDatestringrequired
serverNamestringrequired
versionstringrequired
logLinesArray of stringsrequired
filterStrstringrequired
retLineCountinteger(int64)required
logFieldsstringrequired
logSoftwarestringrequired
startOffsetinteger(int64)required
searchStrstringrequired
regexSearchbooleanrequired
logVersionstringrequired
saveFieldListArray of strings
fileLengthinteger(int64)required
startDatestringrequired
Response
application/json
{
  "endOffset": 0,
  "logStartDate": "string",
  "logDate": "string",
  "endDate": "string",
  "serverName": "string",
  "version": "string",
  "logLines": [
    "string"
  ],
  "filterStr": "string",
  "retLineCount": 0,
  "logFields": "string",
  "logSoftware": "string",
  "startOffset": 0,
  "searchStr": "string",
  "regexSearch": true,
  "logVersion": "string",
  "saveFieldList": [
    "string"
  ],
  "fileLength": 0,
  "startDate": "string"
}

Get the list of source control drivers

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/sourcecontrol/drivernames'

Responses

Successful response

Bodyapplication/json
serverNamestringrequired
saveFieldListArray of strings
listArray of stringsrequired
versionstringrequired
Response
application/json
{
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "list": [
    "string"
  ],
  "version": "string"
}

Retrieves the list of VHost Listeners

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
curl -i -X GET \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/vhostlisteners'

Responses

Successful response

Bodyapplication/json
serverNamestringrequired
saveFieldListArray of strings
vhostListenersArray of objects(VHostListenerConfig)required
vhostListeners[].​baseclassstringrequired
vhostListeners[].​serverNamestringrequired
vhostListeners[].​saveFieldListArray of strings
vhostListeners[].​versionstringrequired
vhostListeners[].​orderinteger(int32)required
versionstringrequired
Response
application/json
{
  "serverName": "string",
  "saveFieldList": [
    "string"
  ],
  "vhostListeners": [
    { … }
  ],
  "version": "string"
}

Updates the full list of VHost Listeners

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
Bodyapplication/jsonrequired
serverNamestringrequired
saveFieldListArray of strings
vhostListenersArray of objects(VHostListenerConfig)required
vhostListeners[].​baseclassstringrequired
vhostListeners[].​serverNamestringrequired
vhostListeners[].​saveFieldListArray of strings
vhostListeners[].​versionstringrequired
vhostListeners[].​orderinteger(int32)required
versionstringrequired
curl -i -X PUT \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/vhostlisteners' \
  -H 'Content-Type: application/json' \
  -d '{
    "serverName": "string",
    "saveFieldList": [
      "string"
    ],
    "vhostListeners": [
      {
        "baseclass": "string",
        "serverName": "string",
        "saveFieldList": [
          "string"
        ],
        "version": "string",
        "order": 0
      }
    ],
    "version": "string"
  }'

Responses

Successful response

Deletes the VHostListener with the given BaseClass

Request

This API is available in builds 15089 or later.

Security
basicAuth
Path
serverNamestringrequired

Reserved for future use

Default "_defaultServer_"
baseclassstringrequired
curl -i -X DELETE \
  -u <username>:<password> \
  'http://localhost:8089/v2/servers/{serverName}/vhostlisteners/{baseclass}'

Responses

Successful response

Server Status

Operations

Server Transcoder

Operations

Server Tuning

Operations

Server Users

Operations

VHost Operations

Operations

Full Webhooks configuration

Operations