Content Management API > Upload

1
import {
2
  buildClient,
3
  uploadLocalFileAndReturnPath,
4
} from "@datocms/cma-client-node";
5

6
async function run() {
7
  // Make sure the API token has access to the CMA, and is stored securely
8
  const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
9

10
  const uploadId = 4124;
11

12
  // we can either update regular attributes:
13
  await client.uploads.update(uploadId, {
14
    author: "New author!",
15
    copyright: "New copyright",
16
    default_field_metadata: {
17
      en: {
18
        alt: "new default alt",
19
        title: "new default title",
20
        focal_point: {
21
          x: 0.3,
22
          y: 0.6,
23
        },
24
        custom_data: {},
25
      },
26
    },
27
  });
28

29
  // associate a new file with the existing upload object:
30
  await client.uploads.update(uploadId, {
31
    path: await uploadLocalFileAndReturnPath(client, "./image.jpg", {
32
      // if you want, you can specify a different base name for the uploaded file
33
      filename: "different-image-name.png",
34
    }),
35
  });
36

37
  // or rename the uploaded file in the CDN (for SEO purposes):
38
  const updatedUpload = await client.uploads.update(uploadId, {
39
    basename: "this-will-be-the-new-file-basename",
40
  });
41

42
  console.log(updatedUpload);
43
}
44

45
run();

1
{
2
  id: "q0VNpiNQSkG6z0lif_O1zg",
3
  size: 444,
4
  width: 30,
5
  height: 30,
6
  path: "/45/1496845848-digital-cats.jpg",
7
  basename: "digital-cats",
8
  filename: "digital-cats.jpg",
9
  url: "https://www.datocms-assets.com/45/1496845848-digital-cats.jpg",
10
  format: "jpg",
11
  author: "Mark Smith",
12
  copyright: "2020 DatoCMS",
13
  notes: "Nyan the cat",
14
  md5: "873c296d0f2b7ee569f2d7ddaebc0d33",
15
  duration: 62,
16
  frame_rate: 30,
17
  blurhash: "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
18
  thumbhash: "UhqCDQIkrHOfVG8wBa2v39z7CXeqZWFLdg==",
19
  mux_playback_id: "a1B2c3D4e5F6g7H8i9",
20
  mux_mp4_highest_res: "high",
21
  default_field_metadata: {
22
    en: {
23
      title: "this is the default title",
24
      alt: "this is the default alternate text",
25
      custom_data: { foo: "bar" },
26
      focal_point: { x: 0.5, y: 0.5 },
27
    },
28
  },
29
  is_image: true,
30
  created_at: "2020-04-21T07:57:11.124Z",
31
  updated_at: "2020-04-21T07:57:11.124Z",
32
  mime_type: "image/jpeg",
33
  tags: ["cats"],
34
  smart_tags: ["robot-cats"],
35
  exif_info: {
36
    iso: 10000,
37
    model: "ILCE-7",
38
    flash_mode: 16,
39
    focal_length: 35,
40
    exposure_time: 0.0166667,
41
  },
42
  colors: [
43
    { red: 206, green: 203, blue: 167, alpha: 255 },
44
    { red: 158, green: 163, blue: 93, alpha: 255 },
45
  ],
46
  creator: { type: "account", id: "312" },
47
  upload_collection: {
48
    type: "upload_collection",
49
    id: "uinr2zfqQLeCo_1O0-ao-Q",
50
  },
51
}