Content Management API > Upload track

Create a new upload track

Body parameters

url_or_upload_request_idstringRequired

Either an URL to download, or the ID of an upload request

Example:

"/7/1455102967-image.png"

typeenumRequired

The type of track (audio or subtitles)

Example:

"subtitles"

subtitlesOptional

Subtitles

audioOptional

Audio

language_codestringRequired

A valid BCP 47 specification compliant language code

Example:

"it-IT"

namestringOptional

The human-readable name of the track

Example:

"Italiano"

closed_captionsnull, booleanOptional

Indicates if the track provides subtitles for the Deaf or Hard-of-hearing (SDH)

Returns

Returns a resource object of type upload_track

Examples

1
import { buildClient } from "@datocms/cma-client-node";
2

3
async function run() {
4
  const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
5

6
  const uploadId = "xBe7u01029ipxBLQhYzZCJ1cke01zCkuUsgnYtH0017nNzbpv2YcsoMDmw";
7

8
  const uploadTrack = await client.uploadTracks.create(uploadId, {
9
    url_or_upload_request_id: "/7/1455102967-image.png",
10
    type: "subtitles",
11
    language_code: "it-IT",
12
  });
13

14
  // Check the 'Returned output' tab for the result ☝️
15
  console.log(uploadTrack);
16
}
17

18
run();

1
{
2
  id: "xBe7u01029ipxBLQhYzZCJ1cke01zCkuUsgnYtH0017nNzbpv2YcsoMDmw",
3
  type: "subtitles",
4
  name: "Italiano",
5
  language_code: "it-IT",
6
  closed_captions: false,
7
  status: "ready",
8
  error: null,
9
  upload: { type: "upload", id: "q0VNpiNQSkG6z0lif_O1zg" },
10
}