Update an output

PUT

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

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

Updates the state of an output.

Request

Path Params

output_identifier

string

required

live_input_identifier

string

required

account_identifier

string

required

Body Params application/json

enabled

boolean

required

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

Example

{
    "enabled": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.cloudflare.com/client/v4/accounts//stream/live_inputs//outputs/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "enabled": true
}'

Responses

🟢200Update an output response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object (output)

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "enabled": true,
        "streamKey": "uzya-f19y-g2g9-a2ee-51j2",
        "uid": "baea4d9c515887b80289d5c33cf01145",
        "url": "rtmp://a.rtmp.youtube.com/live2"
    },
    "success": true
}

🟢200Update an output response failure

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

Delete an output

List downloads