openapi: 3.0.3 info: title: Wowza Streaming Engine REST advanced_token_authentication players API description: 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. version: 2.0.0 contact: name: Wowza Media Systems url: https://www.wowza.com/docs/wowza-streaming-engine-rest-api license: name: Wowza Media Systems url: https://www.wowza.com servers: - url: http://localhost:8087 description: Wowza Streaming Engine Server security: - basicAuth: [] tags: - name: players description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
Operations related to players, which are created through the ``/live_streams`` resource. Players created through Wowza Video live streams can be embedded into your own web page or played through a web page hosted by Wowza Video.' x-displayName: Players paths: /players: get: summary: Fetch all players description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation shows limited details for all of your players. For detailed information, fetch a single player.' operationId: listPlayers tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"GET\" \\\n \"${WV_HOST}/api/v2.0/players\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n var body = '';\n res.on('data', function(data){\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/per_page' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/players' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' /players/{id}: get: summary: Fetch a player description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation shows details of a specific player.' operationId: showPlayer tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"GET\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n var body = '';\n res.on('data', function(data){\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - name: id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string responses: '200': description: Success content: application/json: schema: type: object required: - player properties: player: $ref: '#/components/schemas/player' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' patch: summary: Update a player description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation updates a player.' operationId: updatePlayer tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"PATCH\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17\" \\\n -d $'{\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}'\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname',\n path: path,\n method: 'PATCH',\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nconst req = https.request(options, function(res) {\n var body = '';\n res.on('data', function(data) {\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\nreq.write(JSON.stringify({\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}));\nreq.end();\n" parameters: - name: id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/player_update_input' description: Provide the details of the player to update in the body of the request. required: true responses: '200': description: Success content: application/json: schema: type: object required: - player properties: player: $ref: '#/components/schemas/player' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error422' /players/{id}/rebuild: post: summary: Rebuild player code description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation rebuilds the player with the current configuration.' operationId: requestPlayerRebuild tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"POST\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/rebuild\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/rebuild';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n method: 'POST',\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nconst req = https.request(options, function(res) {\n var body = '';\n res.on('data', function(data) {\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\nreq.end();\n" parameters: - name: id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string responses: '200': description: Success content: application/json: schema: type: object required: - player properties: player: type: object title: player properties: state: type: string description: The state of the player. example: requested enum: - requested - already_requested - activated '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' /players/{id}/state: get: summary: Fetch the state of a player description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation shows the current state of a player.' operationId: showPlayerState tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"GET\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/state\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/state';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n var body = '';\n res.on('data', function(data){\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - name: id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string responses: '200': description: Success content: application/json: schema: type: object required: - player properties: player: type: object title: player properties: state: type: string description: The state of the player. example: activated enum: - requested - activated '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' /players/{player_id}/urls: post: summary: Create a player URL description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation creates a new player URL.' operationId: createPlayerUrl tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"POST\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/urls\" \\\n -d $'{\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}'\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/urls';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n method: 'POST',\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nconst req = https.request(options, function(res) {\n var body = '';\n res.on('data', function(data) {\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\nreq.write(JSON.stringify({\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}));\nreq.end();\n" parameters: - name: player_id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/url_create_input' description: Provide the details of the player URL to create in the body of the request. required: true responses: '200': description: Success content: application/json: schema: type: object required: - url properties: url: $ref: '#/components/schemas/url' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error422' get: summary: Fetch all player URLs description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation shows the details of all player URLs.' operationId: listPlayerUrls tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"GET\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/urls\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/urls';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n var body = '';\n res.on('data', function(data){\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - name: player_id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/urls' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' /players/{player_id}/urls/{id}: get: summary: Fetch a player URL description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation shows the details of a player URL.' operationId: showPlayerUrl tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"GET\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/urls/1acfg43d\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/urls/1acfg43d';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n var body = '';\n res.on('data', function(data){\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - name: player_id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string - name: id in: path required: true description: The unique alphanumeric string that identifies the player URL. schema: type: string responses: '200': description: Success content: application/json: schema: type: object required: - url properties: url: $ref: '#/components/schemas/url' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' patch: summary: Update a player URL description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation updates a player URL.' operationId: updatePlayerUrl tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"PATCH\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/urls/1acfg43d\" \\\n -d $'{\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}'\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/urls/1acfg43d';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname',\n path: path,\n method: 'PATCH',\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nconst req = https.request(options, function(res) {\n var body = '';\n res.on('data', function(data) {\n body += data;\n });\n res.on('end', function() {\n console.log(JSON.parse(body));\n });\n}).on('error', function(e) {\n console.log(e.message);\n});\nreq.write(JSON.stringify({\n \"player\": {\n \"property\": \"My Value\",\n \"...\": \"...\"\n }\n}));\nreq.end();\n" parameters: - name: player_id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string - name: id in: path required: true description: The unique alphanumeric string that identifies the player URL. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/url_update_input' description: Provide the details of the player URL to update in the body of the request. required: true responses: '200': description: Success content: application/json: schema: type: object required: - url properties: url: $ref: '#/components/schemas/url' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error422' delete: summary: Delete a player URL description: '
The player operations are deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player operations will be ignored.
This operation deletes a player URL.' operationId: deletePlayerUrl tags: - players x-codeSamples: - lang: Shell source: "// Using cURL\ncurl -H \"Authorization: Bearer ${WV_JWT}\" \\\n \n -H \"Content-Type: application/json\" \\\n -X \"DELETE\" \\\n \"${WV_HOST}/api/v2.0/players/2adffc17/urls/1acfg43d\"\n" - lang: JavaScript source: "// Using Node.js\nconst https = require('https');\nconst crypto = require('crypto');\nvar hostname = 'api.video.wowza.com'\nvar path = '/api/v2.0/players/2adffc17/urls/1acfg43d';\n//For security, never reveal API token in client-side code\nvar wvJWT = 'Bearer [your JWT]';\n\nconst options = {\n hostname: hostname,\n path: path,\n method: 'DELETE',\n headers: {\n 'Authorization': wvJWT,\n 'Content-Type': 'application/json'\n }\n};\nhttps.get(options, function(res) {\n // no data being returned, just: 204 NO CONTENT\n console.log(res.statusCode);\n}).on('error', function(e) {\n console.log(e.message);\n});\n" parameters: - name: player_id in: path required: true description: The unique alphanumeric string that identifies the player. schema: type: string - name: id in: path required: true description: The unique alphanumeric string that identifies the player URL. schema: type: string responses: '204': description: No Content '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error404' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/Error410' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error422' components: schemas: Error403: type: object description: '' required: - meta properties: meta: type: object title: meta description: '' properties: status: type: integer description: '' example: '' format: int32 code: type: string description: '' example: '' title: type: string description: '' example: '' message: type: string description: '' example: '' description: type: string description: '' example: '' links: type: array description: '' example: '' items: {} example: Example Response 1: meta: status: 403 code: ERR-403-RecordUnaccessible title: Record Unaccessible Error message: The requested resource isn't accessible. description: '' links: [] player: type: object description: '' properties: customizations: type: object description: Configuration of the player customizations. properties: play_icon: type: string description: 'A play icon that is displayed on the video preview. The default, **solid**, uses the standard play (solid triangle) icon. **outlined** uses an alternate (outlined triangle) play icon. **ring** uses an alternate (small solid triangle enclosed in a circle) play icon. Default: **solid**' example: solid enum: - solid - outlined - ring thin_timeline: type: boolean description: If **true**, displays a control bar on the video. The default is **false**. example: '' drag_handle: type: boolean description: If **true**, displays a drag handle on the progress bar. The default is **false**. example: '' volume: type: boolean description: If **true**, displays a volume button on the video. The default is **true**. example: '' mute: type: boolean description: If **true**, displays a mute button on the video. The default is **true**. example: '' fullscreen: type: boolean description: If **true**, displays a fullscreen button on the video. The default is **true**. example: '' show_player_title: type: boolean description: If **true**, displays a preview title on the video. The default is **false**. example: '' color: type: string description: The color of the timeline and volume bar of the player. example: '' countdown: type: boolean description: A clock that appears in the player before the event and counts down to the start of the stream. Specify **true** to display the countdown clock. The default is **false**. example: '' countdown_at: type: string description: The date and time that the event starts, used by the countdown clock. Enter **YYYY-MM-DD HH:MM:SS** where **HH** is a 24-hour clock in UTC. example: '' format: date-time created_at: type: string description: The date and time that the player was created. example: '' format: date-time embed_code: type: string description: The HTML code that can be used in an external webpage to host the Wowza Flowplayer. example: '' hls_playback_url: type: string description: The address that can be used to configure playback of the stream using the HLS protocol. example: '' hosted_page: $ref: '#/components/schemas/hosted_page_response_object' id: type: string description: The unique alphanumeric string that identifies the player. example: '' logo_image_url: type: string description: The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. example: '' logo_position: type: string description: The corner of the player in which you want the player logo to appear. The default is **top-left**. example: '' plugins: type: object description: Configuration of the plugins. properties: airplay: type: boolean description: If **true**, enables Airplay functionality in the player which allows you to cast to an Airplay device. The default is **false**. example: '' chromecast: type: boolean description: If **true**, enables Chromecast functionality in the player which allows you to cast to a Chromecast device. The default is **false**. example: '' responsive: type: boolean description: A player whose size adjusts according to the device on which it's being viewed. If **true**, creates a responsive player. If **false**, specify a **width**. example: '' transcoder_id: type: string description: The unique alphanumeric string that identifies the transcoder. example: '' type: type: string description: 'The player you want to use. **Wowza Video subscribers**
Wowza Flowplayer (wowza_flowplayer) is the only valid option. You''re a subscriber if you have access to Asset Management and Historic and Live Analytics in the user interface. The Wowza Flowplayer is an easy-to-use, commercial grade player designed for builders and developers. It provides HTML5, HLS, and MPEG-DASH playback and plays streams on any browser and device. It can be [customized](https://www.wowza.com/docs/embed-and-customize-wowza-flowplayer-in-your-site) if you embed it in your site. **Other subscribers**
original _html5 and wowza_player are the only valid options and original_html5 is the default. **original_html5** provides HTML5 playback and falls back to Flash on older browsers. **wowza_player** requires that *target_delivery_protocol* be **hls-https** and *closed_caption_type* be **none**.' example: '' updated_at: type: string description: The date and time that the player was updated. example: '' format: date-time video_poster_image_url: type: string description: The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. example: '' width: type: integer description: The width, in pixels, of a fixed-size player. The default is **640**. example: '' format: int32 example: customizations: play_icon: solid thin_timeline: false drag_handle: false volume: true mute: true fullscreen: true show_player_title: false color: 4d4d4d countdown: true countdown_at: '2020-02-01T17:00:00.000Z' created_at: '2020-01-29T17:16:21.968Z' embed_code: null hls_playback_url: https://wowzasubdomain.wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8 hosted_page: enabled: true description: My Hosted Page Description logo_image_url: https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg sharing_icons: false title: My Hosted Page url: https://embed.flowplayer.com/hosted/default/e8dk5bf6 id: e8dk5bf6 logo_image_url: https://prod.s3.amazonaws.com/uploads/player/logo_image/23424/5bad28.jpg logo_position: top-right plugins: airplay: false chromecast: false responsive: false transcoder_id: 6Qbymbbq type: wowza_flowplayer updated_at: '2020-01-31T16:08:26.990Z' video_poster_image_url: https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg width: 640 url_create_input: description: '' allOf: - $ref: '#/components/schemas/url_input' Error401: type: object description: '' required: - meta properties: meta: type: object title: meta description: '' properties: status: type: integer description: '' example: '' format: int32 code: type: string description: '' example: '' title: type: string description: '' example: '' message: type: string description: '' example: '' description: type: string description: '' example: '' links: type: array description: '' example: '' items: {} example: Example Response 1: meta: status: 401 code: ERR-401-NoApiKey title: No API Key Error message: No API key sent in header. description: '' links: [] Example Response 2: meta: status: 401 code: ERR-401-NoAccessKey title: No Access Key Error message: No access key sent in header. description: '' links: [] Example Response 3: meta: status: 401 code: ERR-401-InvalidApiKey title: Invalid Api Key Error message: Invalid API key. description: '' links: [] Example Response 4: meta: status: 401 code: ERR-401-InvalidAccessKey title: Invalid Access Key Error message: Invalid access key. description: '' links: [] Example Response 5: meta: status: 401 code: ERR-401-BadAccountStatus title: Bad Account Status Error message: Your account's status doesn't allow this action. description: '' links: [] Example Response 6: meta: status: 401 code: ERR-401-FeatureNotEnabled title: Feature Not Enabled Error message: This feature isn't enabled. description: '' links: [] Example Response 7: meta: status: 401 code: ERR-401-TrialExceeded title: Bad Billing Status Error message: Your billing status needs attention. You can't start or add live streams until your billing status is updated. description: '' links: [] Example Response 8: meta: status: 401 code: ERR-401-ExpiredToken title: JWT is expired message: Token has exired. description: '' links: [] Example Response 9: meta: status: 401 code: ERR-401-InvalidToken title: JWT is invalid message: Token is invalid. description: '' links: [] players: type: object description: '' required: - players properties: players: type: array description: '' example: '' items: $ref: '#/components/schemas/index_player' example: players: - created_at: '2020-01-29T17:16:21.968Z' id: e8dk5bf6 transcoder_id: 6Qbymbbq type: wowza_flowplayer updated_at: '2020-01-31T07:42:03.968Z' - created_at: '2020-01-29T17:16:21.968Z' id: s3jmdnbl transcoder_id: 3kbb0hvf type: wowza_flowplayer updated_at: '2020-01-31T02:22:29.968Z' url: type: object description: '' properties: bitrate: type: integer description: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: '' format: int32 created_at: type: string description: The date and time that the player URL was created. example: '' format: date-time height: type: integer description: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: '' format: int32 id: type: string description: The unique alphanumeric string that identifies the player URL. example: '' label: type: string description: A descriptive name for the player URL. Maximum 255 characters. example: '' player_id: type: string description: The unique alphanumeric string that identifies the player. example: '' updated_at: type: string description: The date and time that the player URL was updated. example: '' format: date-time url: type: string description: The URL of the player. If using a Wowza CDN target, the URL format is `http://wowzasubdomain-f.akamaihd.net/i/stream_name_angle@stream_id/master.m3u8` for HLS playback. example: '' width: type: integer description: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: '' format: int32 example: bitrate: 4138 height: 1080 id: w9vJm3BJ label: '1920' player_id: Jm1tPblTJm1t url: http://someurl.com/some/path/to/a/stream.m3u8 width: 1920 Error422: type: object description: '' required: - meta properties: meta: type: object title: meta description: '' properties: status: type: integer description: '' example: '' format: int32 code: type: string description: '' example: '' title: type: string description: '' example: '' message: type: string description: '' example: '' description: type: string description: '' example: '' links: type: array description: '' example: '' items: {} example: Example Response 1: meta: status: 422 code: ERR-422-RecordInvalid title: Record Invalid Error message: The request couldn't be processed. ... can't be blank description: '' links: [] Example Response 2: meta: status: 422 code: ERR-422-RecordInvalid title: Record Invalid Error message: The request couldn't be processed. Provider wowza_video is not allowed description: '' links: [] Example Response 3: meta: status: 422 code: ERR-422-InvalidStateChange title: Invalid State Change Error message: The request couldn't be processed. There must be at least one WebRTC output for this transcoder. description: '' links: [] Example Response 4: meta: status: 422 code: ERR-422-RecordInvalid title: Record Invalid Error message: API cannot remove the primary Output Stream Target with the ID of from the Live Stream . description: '' links: [] Example Response 5: meta: status: 422 code: ERR-422-InvalidStateChange title: Invalid State Change Error message: The request couldn't be processed. The broadcast location can't be updated when using autostart. description: '' links: [] Error410: type: object description: '' required: - meta properties: meta: type: object title: meta description: '' properties: status: type: integer description: '' example: '' format: int32 code: type: string description: '' example: '' title: type: string description: '' example: '' message: type: string description: '' example: '' description: type: string description: '' example: '' links: type: array description: '' example: '' items: {} example: Example Response 1: meta: status: 410 code: ERR-410-RecordDeleted title: Record Deleted Error message: The requested resource has been deleted. description: '' links: [] hosted_page_response_object: type: object description: Configuration of the hosted page. properties: enabled: type: boolean description: A web page hosted by Wowza Video that includes a player for the live stream. The default, **true**, creates a hosted page. Specify **false** to not create a hosted web page. example: '' description: type: string description: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. example: '' logo_image_url: type: string description: The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. sharing_icons: type: boolean description: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, **true**, includes sharing icons on the hosted page. Specify **false** to omit sharing icons. example: '' title: type: string description: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. example: '' url: type: string description: The URL of the Wowza Video-hosted webpage that viewers can visit to watch the stream. example: '' urls: type: object description: '' required: - urls properties: urls: type: array items: $ref: '#/components/schemas/url' example: urls: - bitrate: 4138 height: 1080 id: w9vJm3BJ label: '1920' player_id: Jm1tPblTJm1t url: http://someurl.com/some/path/to/a/stream.m3u8 width: 1920 - bitrate: 4138 height: 1080 id: PPqV0kcm label: iPhone player_id: Jm1tPblTJm1t transcoder_id: yjCVYf5l url: http://someurl.com/some/path/to/a/stream.m3u8 width: 1920 player_update_input: type: object description: '' required: - player properties: player: type: object title: player description: '' properties: customizations: type: object description: Configuration of the player customizations. properties: play_icon: type: string description: 'A play icon that is displayed on the video preview. The default, **solid**, uses the standard play (solid triangle) icon. **outlined** uses an alternate (outlined triangle) play icon. **ring** uses an alternate (small solid triangle enclosed in a circle) play icon. Default: **solid** **Example:** "play_icon": "solid"' example: solid enum: - solid - outlined - ring thin_timeline: type: boolean description: 'If **true**, displays a control bar on the video. The default is **false**. **Example:** "thin_timeline": false' example: '' drag_handle: type: boolean description: 'If **true**, displays a drag handle on the progress bar. The default is **false**. **Example:** "drag_handle": false' example: '' volume: type: boolean description: 'If **true**, displays a volume button on the video. The default is **true**. **Example:** "volume": true' example: '' mute: type: boolean description: 'If **true**, displays a mute button on the video. The default is **true**. **Example:** "mute": true' example: '' fullscreen: type: boolean description: 'If **true**, displays a fullscreen button on the video. The default is **true**. **Example:** "fullscreen": true' example: '' show_player_title: type: boolean description: 'If **true**, displays a preview title on the video. The default is **false**. **Example:** "show_player_title": false' example: '' color: type: string description: 'The color of the timeline and volume bar of the player. You can set the color of your choice by passing a hex code for that specific color. **Example:** "color": "4d4d4d"' example: '' countdown: type: boolean description: 'A clock that appears in the player before the event and counts down to the start of the stream. Specify **true** to display the countdown clock. The default is **false**. **Example:** "countdown": true' example: true countdown_at: type: string description: 'The date and time that the event starts, used by the countdown clock. Enter **YYYY-MM-DD HH:MM:SS** where **HH** is a 24-hour clock in UTC. **Example:** "countdown_at": "2020-02-01T17:00:00.000Z"' example: '2020-02-01T17:00:00.000Z' format: date-time hosted_page: $ref: '#/components/schemas/hosted_page_request_object' logo_image: type: string description: 'A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. **Example:** "logo_image": "[Base64-encoded string representation of an image]"' example: '[Base64-encoded string representation of an image]' logo_position: type: string description: 'The corner of the player in which you want the player logo to appear. The default is **top-left**. **Example:** "logo_position": "top-left"' example: top-left plugins: type: object description: Configuration of the plugins. properties: airplay: type: boolean description: 'If **true**, enables Airplay functionality in the player which allows you to cast to an Airplay device. The default is **false**. **Example:** "airplay": false' example: '' chromecast: type: boolean description: 'If **true**, enables Chromecast functionality in the player which allows you to cast to a Chromecast device. The default is **false**. **Example:** "chromecast": false' example: '' remove_logo_image: type: boolean description: 'If **true**, removes the logo file from the output. The default is **false**. **Example:** "remove_logo_image": true' example: true remove_video_poster_image: type: boolean description: 'If **true**, removes the poster image from the output. The default is **false**. **Example:** "remove_video_poster_image": true' example: true responsive: type: boolean description: 'A player whose size adjusts according to the device on which it''s being viewed. If **true**, creates a responsive player. If **false**, specify a **width**. **Example:** "responsive": true' example: false type: type: string description: 'The player you want to use. **Wowza Video subscribers**
Wowza Flowplayer (wowza_flowplayer) is the only valid option. You''re a subscriber if you have access to Asset Management and Historic and Live Analytics in the user interface. The Wowza Flowplayer is an easy-to-use, commercial grade player designed for builders and developers. It provides HTML5, HLS, and MPEG-DASH playback and plays streams on any browser and device. It can be [customized](https://www.wowza.com/docs/embed-and-customize-wowza-flowplayer-in-your-site) if you embed it in your site. > **Note**: If you update a live stream from **original_html5** or **wowza_player** to **wowza_flowplayer**, it cannot be changed later. **Other subscribers**
original _html5 and wowza_player are the only valid options and original_html5 is the default. **original_html5** provides HTML5 playback and falls back to Flash on older browsers. **wowza_player** requires that *target_delivery_protocol* be **hls-https** and *closed_caption_type* be **none**. **Example:** "type": "wowza_flowplayer"' example: wowza_flowplayer video_poster_image: type: string description: 'A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. **Example:** "video_poster_image": "[Base64-encoded string representation of an image]"' example: '[Base64-encoded string representation of an image]' width: type: integer description: 'The width, in pixels, of a fixed-size player. The default is **640**. **Example:** "width": 640' example: 640 format: int32 example: player: hosted_page: title: My Updated Hosted Page responsive: true url_input: type: object description: '' required: - url properties: url: type: object title: url description: '' properties: bitrate: type: integer description: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: 4128 format: int32 height: type: integer description: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: 1080 format: int32 label: type: string description: A descriptive name for the player URL. Maximum 255 characters. example: '1920' url: type: string description: The URL of the player. If using a Wowza CDN target, the URL format is `http://wowzasubdomain-f.akamaihd.net/i/stream_name_angle@stream_id/master.m3u8` for HLS playback. example: http://somedomain.com/path/to/stream.m3u8 width: type: integer description: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than **0**. example: 1920 format: int32 index_player: type: object title: players description: '' properties: created_at: type: string description: The date and time that the player was created. example: '' format: date-time id: type: string description: The unique alphanumeric string that identifies the player. example: '' transcoder_id: type: string description: The unique alphanumeric string that identifies the transcoder. example: '' type: type: string description: "The player you want to use.\n\n\n **Wowza Video subscribers**
\nWowza Flowplayer (wowza_flowplayer) is the only valid option. You're a subscriber if you have access to Asset Management and Historic and Live Analytics in the user interface.\n\nThe Wowza Flowplayer is an easy-to-use, commercial grade player designed for builders and developers. It provides HTML5, HLS, and MPEG-DASH playback and plays streams on any browser and device. It can be [customized](https://www.wowza.com/docs/embed-and-customize-wowza-flowplayer-in-your-site) if you embed it in your site.\n\n**Other subscribers**
original _html5 and wowza_player are the only valid options and original_html5 is the default. **original_html5** provides HTML5 playback and falls back to Flash on older browsers. **wowza_player** requires that *target_delivery_protocol* be **hls-https** and *closed_caption_type* be **none**." example: '' updated_at: type: string description: The date and time that the player was updated. example: '' format: date-time url_update_input: description: '' allOf: - $ref: '#/components/schemas/url_input' Error404: type: object description: '' required: - meta properties: meta: type: object title: meta description: '' properties: status: type: integer description: '' example: '' format: int32 code: type: string description: '' example: '' title: type: string description: '' example: '' message: type: string description: '' example: '' description: type: string description: '' example: '' links: type: array description: '' example: '' items: {} example: Example Response 1: meta: status: 404 code: ERR-404-RecordNotFound title: Record Not Found Error message: The requested resource couldn't be found. description: '' links: [] hosted_page_request_object: type: object description: Configuration of the hosted page. properties: enabled: type: boolean description: 'A web page hosted by Wowza Video that includes a player for the live stream. The default, **true**, creates a hosted page. Specify **false** to not create a hosted web page. **Example:** "enabled": true' example: '' description: type: string description: 'A description that appears on the hosted page below the player. Can''t include custom HTML, JavaScript, or other tags. **Example:** "description": "My Hosted Page Description"' example: '' logo_image: type: string description: 'A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. **Example:** "logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]"' example: '[Base64-encoded string representation of GIF, JPEG, or PNG file]' remove_logo_image: type: boolean description: 'If **true**, removes the logo file from the hosted page. The default is **false**. **Example:** "remove_logo_image": true' example: true sharing_icons: type: boolean description: 'Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, **true**, includes sharing icons on the hosted page. Specify **false** to omit sharing icons. **Example:** "sharing_icons": false' example: '' title: type: string description: 'A title for the page that appears above the player. Can''t include custom HTML, JavaScript, or other tags. **Example:** "title": "My Hosted Page"' example: '' parameters: page: name: page in: query description: "Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is **1**. \n\n For more information and examples, see [Get paginated query results with the Wowza Video REST API](https://www.wowza.com/docs/how-to-get-paginated-query-results-with-the-wowza-video-rest-api)." schema: type: integer per_page: name: per_page in: query description: For use with the *page* parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is **1000**. schema: type: integer securitySchemes: basicAuth: type: http scheme: basic description: HTTP Basic Authentication using Wowza Streaming Engine admin credentials digestAuth: type: http scheme: digest description: HTTP Digest Authentication