Content Management API > Upload track

Automatically generate a subtitles track

Warning: Experimental API

Please note that this API method is marked as unstable and should be avoided in production environments. Changes may occur at any time without warning, potentially impacting your scripts. We recommend contacting our Support Team to explore alternative approaches that are safer and more reliable!

Body parameters

language_codestringRequired

A valid BCP 47 specification compliant language code

Example:

"it-IT"

namestringOptional

The human-readable name of the track

Example:

"Italiano"

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.generateSubtitles(uploadId, {
9
    language_code: "it-IT",
10
  });
11

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

16
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
}