Content Management API > Upload

Referenced records

Retrieve all records that are linked to this upload

Query parameters

nested boolean

For Modular Content, Structured Text and Single Block fields, return full payload for nested blocks instead of IDs

version null, enum

Retrieve only the selected type of version that is linked to the upload; current, published or both

Example:

"current"

current

Return records that are linked to the upload in their latest version available

published

Return records that are linked to the upload in their published version

published-or-current

Return records that are linked to the upload either in their published version or in their latest version available

Returns

Returns an array of resource objects of type item

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 = "q0VNpiNQSkG6z0lif_O1zg";
7

8
  const uploads = await client.uploads.references(uploadId);
9

10
  for (const upload of uploads) {
11
    // Check the 'Returned output' tab for the result ☝️
12
    console.log(upload);
13
  }
14
}
15

16
run();

1
{
2
  id: "hWl-mnkWRYmMCSTq4z_piQ",
3
  title: "My first blog post!",
4
  content: "Lorem ipsum dolor sit amet...",
5
  category: "24",
6
  image: {
7
    alt: "Alt text",
8
    title: "Image title",
9
    custom_data: {},
10
    focal_point: null,
11
    upload_id: "20042921",
12
  },
13
  meta: {
14
    created_at: "2020-04-21T07:57:11.124Z",
15
    updated_at: "2020-04-21T07:57:11.124Z",
16
    published_at: "2020-04-21T07:57:11.124Z",
17
    first_published_at: "2020-04-21T07:57:11.124Z",
18
    publication_scheduled_at: "2020-04-21T07:57:11.124Z",
19
    unpublishing_scheduled_at: "2020-04-21T07:57:11.124Z",
20
    status: "published",
21
    is_current_version_valid: true,
22
    is_published_version_valid: true,
23
    current_version: "4234",
24
    stage: null,
25
    has_children: true,
26
  },
27
  item_type: { type: "item_type", id: "DxMaW10UQiCmZcuuA-IkkA" },
28
}