Edit additional audio tracks on a video

client.stream.audioTracks.edit(, , , ?): Audio { default, label, status, uid }

PATCH/accounts/{account_id}/stream/{identifier}/audio/{audio_identifier}

Edits additional audio tracks on a video. Editing the default status of an audio track to true will mark all other audio tracks on the video default status to false.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Stream Write

ParametersExpand Collapse

identifier: string

A Cloudflare-generated unique identifier for a media item.

maxLength32

audioIdentifier: string

The unique identifier for an additional audio track.

maxLength32

params: AudioTrackEditParams { account_id, _default, label }

account_id: string

Path param: The account identifier tag.

maxLength32

_default?: boolean

Body param: Denotes whether the audio track will be played by default in a player.

label?: string

Body param: A string to uniquely identify the track amongst other audio track labels for the specified video.

ReturnsExpand Collapse

Audio { default, label, status, uid }

default?: boolean

Denotes whether the audio track will be played by default in a player.

label?: string

A string to uniquely identify the track amongst other audio track labels for the specified video.

status?: "queued" | "ready" | "error"

Specifies the processing status of the video.

One of the following:

"queued"

"ready"

"error"

uid?: string

A Cloudflare-generated unique identifier for a media item.

maxLength32

Edit additional audio tracks on a video

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const audio = await client.stream.audioTracks.edit(
  'ea95132c15732412d22c1476fa83f27a',
  'ea95132c15732412d22c1476fa83f27a',
  { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
);

console.log(audio.uid);

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "default": true,
    "label": "director commentary",
    "status": "queued",
    "uid": "ea95132c15732412d22c1476fa83f27a"
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "default": true,
    "label": "director commentary",
    "status": "queued",
    "uid": "ea95132c15732412d22c1476fa83f27a"
  }
}