Edit additional audio tracks on a video

client.Stream.AudioTracks.Edit(ctx, identifier, audioIdentifier, params) (*Audio, error)

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

AccountID param.Field[string]

Path param: The account identifier tag.

maxLength32

Default param.Field[bool]optional

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

Label param.Field[string]optional

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

ReturnsExpand Collapse

type Audio struct{…}

Default booloptional

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

Label stringoptional

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

Status AudioStatusoptional

Specifies the processing status of the video.

One of the following:

const AudioStatusQueued AudioStatus = "queued"

const AudioStatusReady AudioStatus = "ready"

const AudioStatusError AudioStatus = "error"

UID stringoptional

A Cloudflare-generated unique identifier for a media item.

maxLength32

Edit additional audio tracks on a video

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/stream"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  audio, err := client.Stream.AudioTracks.Edit(
    context.TODO(),
    "ea95132c15732412d22c1476fa83f27a",
    "ea95132c15732412d22c1476fa83f27a",
    stream.AudioTrackEditParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", 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"
  }
}