List all outputs associated with a specified live input

GET

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/stream/live_inputs/{live_input_identifier}/outputs

Last modified:2022-12-16 13:48:35

Retrieves all outputs associated with a specified live input.

Request

Path Params

live_input_identifier

string

required

account_identifier

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200List all outputs associated with a specified live input response

application/json

Body

result

required

Any of

allOf {2}

array[object (output) {4}]

allOf {2}

One of

array[object (output) {4}]

object

enabled

boolean

output_enabled

optional

When enabled, live video streamed to the associated live input will be sent to the output URL. When disabled, live video will not be sent to the output URL, even when streaming to the associated live input. Use this to control precisely when you start and stop simulcasting to specific destinations like YouTube and Twitch.

Default:

true

Example:

true

streamKey

string

output_streamKey

read-onlyoptional

The streamKey used to authenticate against an output's target.

Example:

uzya-f19y-g2g9-a2ee-51j2

uid

string

output_identifier

read-onlyoptional

A unique identifier for the output.

<= 32 characters

Example:

baea4d9c515887b80289d5c33cf01145

url

string

output_url

read-onlyoptional

The URL an output uses to restream.

Example:

rtmp://a.rtmp.youtube.com/live2

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

result_info

object

result_info

optional

count

number

optional

Total number of results for the requested service

Example:

page

number

optional

Current page within paginated list of results

Example:

per_page

number

optional

Number of results per page of results

Example:

total_count

number

optional

Total results available without any search parameters

Example:

2000

Example

{
    "errors": [],
    "messages": [],
    "result": [
        {
            "enabled": true,
            "streamKey": "uzya-f19y-g2g9-a2ee-51j2",
            "uid": "baea4d9c515887b80289d5c33cf01145",
            "url": "rtmp://a.rtmp.youtube.com/live2"
        }
    ],
    "success": true,
    "result_info": {
        "count": 1,
        "page": 1,
        "per_page": 20,
        "total_count": 2000
    }
}

🟢200List all outputs associated with a specified live input response failure

Modified at 2022-12-16 13:48:35

Update a live input

Create a new output, connected to a live input