Show examples in:
    Referenced records

    Retrieve all records that are linked to this upload

    Query parameters

    nested  boolean  Optional

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

    version  null, enum  Optional

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


    Returns an array of item resource objects.


    Example code:
    import { buildClient } from '@datocms/cma-client-node';
    async function run() {
    const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
    const uploadId = '666';
    const uploads = await client.uploads.references(uploadId, {
    nested: true,
    version: 'current'
    uploads.forEach((upload) => {
    Returned output:
    id: '4235',
    title: 'My first blog post!',
    content: 'Lorem ipsum dolor sit amet...',
    category: '24',
    image: {
    alt: 'Alt text',
    title: 'Image title',
    custom_data: {},
    focal_point: null,
    upload_id: '20042921'
    meta: {
    created_at: '2020-04-21T07:57:11.124Z',
    updated_at: '2020-04-21T07:57:11.124Z',
    published_at: '2020-04-21T07:57:11.124Z',
    first_published_at: '2020-04-21T07:57:11.124Z',
    publication_scheduled_at: '2020-04-21T07:57:11.124Z',
    unpublishing_scheduled_at: '2020-04-21T07:57:11.124Z',
    status: 'draft',
    is_current_version_valid: true,
    is_published_version_valid: true,
    current_version: '4234',
    stage: ''
    item_type: {
    type: 'item_type',
    id: '44'
    creator: {
    type: 'account',
    id: '312'