Contents

Content is written information such as articles, blog posts, website copy, product descriptions, social media updates, emails, and ebooks.

Key-Value Object. Where Key is Unique identifier for the Content object and Value is Content Metadata.

Dictionary of key string and value object ContentMetadata .

THE LINKS OBJECT

{
  "4pLYWyN47c076mSfpWIy": {
    "id": "4pLYWyN47c076mSfpWIy",
    "kind": "DOCUMENT",
    "name": "Options",
    "slug": "options",
    "fullSlug": "docs/schemas/options",
    "parentSlug": "docs/schemas",
    "createdAt": "2024-05-01T09:56:00.923Z",
    "updatedAt": "2024-05-01T09:57:06.445Z",
    "publishedAt": "2024-05-01T13:03:31.672Z"
  },
  "5L2ELYsmaM6C0fOBzKp0": {
    "id": "5L2ELYsmaM6C0fOBzKp0",
    "kind": "DOCUMENT",
    "name": "Translations",
    "slug": "translations",
    "fullSlug": "docs/api/translations",
    "parentSlug": "docs/api",
    "createdAt": "2024-05-04T14:03:54.100Z",
    "updatedAt": "2024-05-07T14:03:57.457Z",
    "publishedAt": "2024-05-07T11:05:46.094Z"
  },
  "7fUavXjDpFuHGdWgTFXy": {
    "id": "7fUavXjDpFuHGdWgTFXy",
    "kind": "DOCUMENT",
    "name": "Overview",
    "slug": "overview",
    "fullSlug": "docs/content/overview",
    "parentSlug": "docs/content",
    "createdAt": "2024-04-30T20:57:41.827Z",
    "updatedAt": "2024-04-30T21:31:47.344Z",
    "publishedAt": "2024-05-01T13:02:41.814Z"
  }
}

The Content Metadata Object

Content Metadata define short information about a Content for navigation reason.

Properties

  • Name
    id
    Type
    Required string of format uri
    Description

    Unique identifier for the object.

  • Name
    kind
    Type
    Required enum
    Description

    Define the type of Content, whether it is a FOLDER or DOCUMENT.

    Possible enum values:
    • FOLDER
    • DOCUMENT
  • Name
    name
    Type
    Required string
    Description

    Name of the Content

  • Name
    slug
    Type
    Required string
    Description

    SLUG of the Content

  • Name
    parentSlug
    Type
    Required string
    Description

    Parent SLUG of the Content

  • Name
    fullSlug
    Type
    Required string
    Description

    Combination of SLUG and Parent SLUG of the Content

  • Name
    createdAt
    Type
    Required string of format date-time
    Description

    Date and Time at which the Content was created.

  • Name
    updatedAt
    Type
    Required string of format date-time
    Description

    Date and Time at which the Content was updated.

  • Name
    publishedAt
    Type
    Optional string of format date-time
    Description

    Date and Time at which the Content was published.

THE CONTENT METADATA OBJECT

{
  "id": "WLWc4vOACzG1QjK9AEo9",
  "kind": "DOCUMENT",
  "name": "Privacy Policy",
  "slug": "privacy-policy",
  "parentSlug": "legal",
  "fullSlug": "legal/privacy-policy",
  "createdAt": "2023-08-23T21:08:17.551Z",
  "updatedAt": "2024-01-23T14:10:37.852Z",
  "publishedAt": "2023-08-23T21:09:15.191Z"
}

The Content Object

Content define shared object for all possible Content Types.

Properties

  • Name
    id
    Type
    Required string of format uri
    Description

    Unique identifier for the object.

  • Name
    kind
    Type
    Required enum
    Description

    Define the type of Content, whether it is a FOLDER or DOCUMENT.

    Possible enum values:
    • FOLDER
    • DOCUMENT
  • Name
    name
    Type
    Required string
    Description

    Name of the Content

  • Name
    locale
    Type
    Optional string
    Description

    Locale unique identifier (ISO 639-1).

  • Name
    slug
    Type
    Required string
    Description

    SLUG of the Content

  • Name
    parentSlug
    Type
    Required string
    Description

    Parent SLUG of the Content

  • Name
    fullSlug
    Type
    Required string
    Description

    Combination of SLUG and Parent SLUG of the Content

  • Name
    createdAt
    Type
    Required string of format date-time
    Description

    Date and Time at which the Content was created.

  • Name
    updatedAt
    Type
    Required string of format date-time
    Description

    Date and Time at which the Content was updated.

  • Name
    publishedAt
    Type
    Optional string of format date-time
    Description

    Date and Time at which the Content was published.

  • Name
    data
    Type
    Object ContentData
    Description

THE CONTENT OBJECT

{
  "id": "WLWc4vOACzG1QjK9AEo9",
  "kind": "DOCUMENT",
  "name": "Privacy Policy",
  "locale": "en",
  "slug": "privacy-policy",
  "parentSlug": "legal",
  "fullSlug": "legal/privacy-policy",
  "createdAt": "2023-08-23T21:08:17.551Z",
  "updatedAt": "2024-01-23T14:10:37.852Z",
  "publishedAt": "2023-08-23T21:09:15.191Z",
  "data": {
    "_id": "a8ca3ed3-6613-4fb6-ae4e-5b846eb5775c",
    "schema": "docArticle"
  }
}

The Content Data Object

ContentData defined Object to connect all possible root Schemas.

THE CONTENT DATA OBJECT

{}

GET /api/v1/spaces/{spaceId}/links

The endpoint allows you to retrieve all Content summery metadata mainly used to recreate content tree. In case cache version is not present, it will redirect to the latest version.

Parameters

  • Name
    spaceId
    Type
    Required string in path
    Description

    Unique identifier for the Space object.

  • Name
    kind
    Type
    Optional enum in query
    Description

    Content Kind. FOLDER or DOCUMENT. If not provided, it will return all.

    Possible enum values:
    • FOLDER
    • DOCUMENT
  • Name
    startSlug
    Type
    Optional string in query
    Description

    Content start slug.

  • Name
    cv
    Type
    Optional string in query
    Description

    Cache version.

  • Name
    token
    Type
    Required string in query
    Description

    Authentication Token.

Returns

  • Description

    Return the Links Object if the request succeeded.

Response

{
  "4pLYWyN47c076mSfpWIy": {
    "id": "4pLYWyN47c076mSfpWIy",
    "kind": "DOCUMENT",
    "name": "Options",
    "slug": "options",
    "fullSlug": "docs/schemas/options",
    "parentSlug": "docs/schemas",
    "createdAt": "2024-05-01T09:56:00.923Z",
    "updatedAt": "2024-05-01T09:57:06.445Z",
    "publishedAt": "2024-05-01T13:03:31.672Z"
  },
  "5L2ELYsmaM6C0fOBzKp0": {
    "id": "5L2ELYsmaM6C0fOBzKp0",
    "kind": "DOCUMENT",
    "name": "Translations",
    "slug": "translations",
    "fullSlug": "docs/api/translations",
    "parentSlug": "docs/api",
    "createdAt": "2024-05-04T14:03:54.100Z",
    "updatedAt": "2024-05-07T14:03:57.457Z",
    "publishedAt": "2024-05-07T11:05:46.094Z"
  },
  "7fUavXjDpFuHGdWgTFXy": {
    "id": "7fUavXjDpFuHGdWgTFXy",
    "kind": "DOCUMENT",
    "name": "Overview",
    "slug": "overview",
    "fullSlug": "docs/content/overview",
    "parentSlug": "docs/content",
    "createdAt": "2024-04-30T20:57:41.827Z",
    "updatedAt": "2024-04-30T21:31:47.344Z",
    "publishedAt": "2024-05-01T13:02:41.814Z"
  }
}

GET /api/v1/spaces/{spaceId}/contents/slugs/{contentSlug}

Retrieve Content by Slug

The endpoint allows you to retrieve a specific Content by the content full slug. In case cache version is not present, it will redirect to the latest version.

Parameters

  • Name
    spaceId
    Type
    Required string in path
    Description

    Unique identifier for the Space object.

  • Name
    contentSlug
    Type
    Required string in path
    Description

    Content full slug.

  • Name
    cv
    Type
    Optional string in query
    Description

    Cache version.

  • Name
    locale
    Type
    Optional string in query
    Description

    Locale unique identifier (ISO 639-1).

  • Name
    version
    Type
    Optional enum in query
    Description

    Content version.

    Possible enum values:
    • draft
  • Name
    token
    Type
    Required string in query
    Description

    Authentication Token.

Returns

  • Description

    Return the Content Object if the request succeeded.

Response

{
  "id": "WLWc4vOACzG1QjK9AEo9",
  "kind": "DOCUMENT",
  "name": "Privacy Policy",
  "locale": "en",
  "slug": "privacy-policy",
  "parentSlug": "legal",
  "fullSlug": "legal/privacy-policy",
  "createdAt": "2023-08-23T21:08:17.551Z",
  "updatedAt": "2024-01-23T14:10:37.852Z",
  "publishedAt": "2023-08-23T21:09:15.191Z",
  "data": {
    "_id": "a8ca3ed3-6613-4fb6-ae4e-5b846eb5775c",
    "schema": "docArticle"
  }
}

GET /api/v1/spaces/{spaceId}/contents/{contentId}

Retrieve Content By ID

The endpoint allows you to retrieve a specific Content by Unique identifier for the Content object. In case cache version is not present, it will redirect to the latest version.

Parameters

  • Name
    spaceId
    Type
    Required string in path
    Description

    Unique identifier for the Space object.

  • Name
    contentId
    Type
    Required string in path
    Description

    Unique identifier for the Content object.

  • Name
    cv
    Type
    Optional string in query
    Description

    Cache version.

  • Name
    locale
    Type
    Optional string in query
    Description

    Locale unique identifier (ISO 639-1).

  • Name
    version
    Type
    Optional enum in query
    Description

    Content version.

    Possible enum values:
    • draft
  • Name
    token
    Type
    Required string in query
    Description

    Authentication Token.

Returns

  • Description

    Return the Content Object if the request succeeded.

Response

{
  "id": "WLWc4vOACzG1QjK9AEo9",
  "kind": "DOCUMENT",
  "name": "Privacy Policy",
  "locale": "en",
  "slug": "privacy-policy",
  "parentSlug": "legal",
  "fullSlug": "legal/privacy-policy",
  "createdAt": "2023-08-23T21:08:17.551Z",
  "updatedAt": "2024-01-23T14:10:37.852Z",
  "publishedAt": "2023-08-23T21:09:15.191Z",
  "data": {
    "_id": "a8ca3ed3-6613-4fb6-ae4e-5b846eb5775c",
    "schema": "docArticle"
  }
}

© Copyright 2024 Lessify Rights Reserved. Build with Localess