---
title: The Link Object
description: The link object of the Content Delivery API is a concise representation of a story or folder.
url: https://storyblok.com/docs/api/content-delivery/v2/links/the-link-object
---

# The Link Object

The link object contains a limited subset of the information associated with a story or folder.

## Properties

-   `id` (number)
    
    Story or folder ID.
    
-   `uuid` (string)
    
    Story or folder UUID.
    
-   `slug` (string)
    
    Story or folder full slug.
    
-   `path` (string | null)
    
    Real path defined in the story’s entry configuration (see [Visual Editor](/docs/concepts/visual-editor)).
    
-   `parent_id` (number | null)
    
    Parent folder ID.
    
-   `name` (string)
    
    Story or folder name.
    
-   `is_folder` (boolean)
    
    `true` if the instance is a folder.
    
-   `published` (boolean)
    
    `true` if the instance is currently published.
    
-   `is_startpage` (boolean)
    
    `true` if the instance is a story and is defined as folder root.
    
-   `position` (number)
    
    Numeric representation of the story’s position in the folder. Users [can change](/docs/manuals/stories#folders) this property in the **Content** tab.
    
-   `real_path` (string)
    
    Either the full slug of the story or folder with a leading `/`, or, if existent, the value of the real path defined in the story’s entry configuration with a leading `/`.
    
-   `published_at` (string)
    
    Latest publication timestamp (Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard in UTC).
    
-   `created_at` (string)
    
    Creation timestamp (Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard in UTC).
    
-   `updated_at` (string)
    
    Latest update timestamp (Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard in UTC).
    
-   `alternates` (array)
    
    An array that contains objects correlating to the language versions defined using [field-level translation](/docs/concepts/internationalization#field-level-translation).
    
    > [!WARNING]
    > The `alternates` parameter is different from the story alternates defined in the [Dimensions app](https://www.storyblok.com/apps/locales) when using [folder-level translation](/docs/concepts/internationalization#folder-level-translation).
    
    Show **alternates object** child properties
    
    -   `path` (string)
        
        Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/apps/translatable-slugs)).
        
    -   `name` (string)
        
        Translated story name (learn more about the [Translatable Slugs app](https://www.storyblok.com/apps/translatable-slugs)).
        
    -   `lang` (string)
        
        Language code of story language version.
        
    -   `published` (boolean)
        
        `true` if story language version is currently published.
        
    -   `translated_slug` (string)
        
        Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/apps/translatable-slugs)).
        
    

Example Object

```json
{
  "id": 460947950,
  "uuid": "3ce5d163-3bb4-41ef-9e1a-709d7c4848ff",
  "slug": "website-a/home",
  "path": "the-real-path",
  "parent_id": 460950252,
  "name": "Home",
  "is_folder": false,
  "published": true,
  "is_startpage": false,
  "position": 10,
  "real_path": "/the-real-path",
  "published_at": "2024-03-07T18:32:44.919Z",
  "created_at": "2024-03-07T18:22:10.389Z",
  "updated_at": "2024-03-07T18:32:44.933Z",
  "alternates": [
    {
      "path": "website-a/startseite",
      "name": "Startseite",
      "lang": "de",
      "published": true,
      "translated_slug": "website-a/startseite"
    }
  ]
}
```

## Pagination

-   [Previous: Retrieve Multiple Links](/docs/api/content-delivery/v2/links/retrieve-multiple-links)
-   [Next: The Links Object](/docs/api/content-delivery/v2/links/the-links-object)