Choose your language:
    Referenced records

    Retrieve all records that are linked to this upload

    Query parameters
    nested  string  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 a item object.


    Example code:
    const SiteClient = require('datocms-client').SiteClient;
    const client = new SiteClient('YOUR-API-TOKEN');
    const uploadId = '666';
    client.upload.references(uploadId, {
    nested: 'true',
    version: 'current'
    .then((upload) => {
    .catch((error) => {
    Returned output:
    > node example.js
    "id": "4235",
    "title": "My first blog post!",
    "content": "Lorem ipsum dolor sit amet...",
    "category": "24",
    "image": {
    "alt": "Alt text",
    "title": "Image title",
    "customData": {},
    "focalPoint": null,
    "uploadId": "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_valid": true,
    "current_version": "4234",
    "stage": ""
    "itemType": "44",
    "creator": "312"