Changelog

Deprecation of renditions endpoints and query parameters

The following endpoint is no longer available in newer api versions anymore:

❌ GET /api/2025-09/documents/{documentId}/latestPublication/renditions/{renditionHandles}

The following endpoints don’t support the ?renditions query parameter anymore:

❌ GET /api/2025-09/documents/{documentId}/latestDraft?renditions=web
❌ GET /api/2025-09/documents/{documentId}/latestPublication?renditions

There’s no replacement for renditions in livingdocs as all transforms should be done when aggregating content for your frontends.

But all three endpoints still support the old logic in v1 to 2025-05:

✅ GET /api/2025-07/documents/{documentId}/latestPublication/renditions/{renditionHandles}
✅ GET /api/2025-07/documents/{documentId}/latestDraft?renditions=web
✅ GET /api/2025-07/documents/{documentId}/latestPublication?renditions

Deprecation of /project, /channelConfig and /channels/{channelHandle} endpoints

The following endpoints are no longer available in newer api versions anymore:

❌ GET /api/2025-07/project
❌ GET /api/2025-07/channels/{channelHandle}
❌ GET /api/2025-07/channelConfig
❌ POST /api/2025-07/channelConfig

Please use the following endpoints instead, which are available since v1:

✅ GET /api/2025-07/projectConfig
✅ POST /api/2025-07/projectConfig

All the 4 legacy endpoints are still available in v1 to 2025-05:

✅ GET /api/v1/project to /api/2025-05/project
✅ GET /api/v1/channels to /api/2025-05/channels
✅ GET /api/v1/channelConfig to /api/2025-05/channelConfig
✅ POST /api/v1/channelConfig to /api/2025-05/channelConfig

Document Command API: New Publish Control Commands

We have extended the Document Command API with new publish control commands.

setEmbargo

{
  operation: 'setEmbargo',
  reason: 'Some reason',
  until:  '2021-11-04T00:00:00Z'
}

removeEmbargo

{
  operation: 'removeEmbargo'
}

addPublishSchedule

{
  operation: 'addPublishSchedule',
  date: '2021-11-04T00:00:00Z'
}

cancelPublishSchedule

{
  operation: 'cancelPublishSchedule'
}

addUnpublishSchedule

{
  operation: 'addUnpublishSchedule',
  date: '2021-11-04T00:00:00Z'
}

cancelUnpublishSchedule

{
  operation: 'cancelUnpublishSchedule'
}

Kordiam Rebranding: Remove Desknet endpoints in newer versions

The public API endpoints of the version 2025-05 do not support desknet in the path anymore.

That means the following api prefixes should get changed:
/api/v1/desknet/ > /api/2025-05/kordiam/
/api/v1/desknet-integration/ > /api/2025-05/kordiam-integration/

The Desknet endpoints are supported in api versions v1 till 2025-03, but not in any versions after that:

❌ POST /api/2025-05/desknet/element
❌ PUT /api/2025-05/desknet/element
❌ PUT /api/2025-05/desknet/element/:documentId
❌ DELETE /api/2025-05/desknet/element/:documentId

We suggest to migrate to the new versions that use kordiam in the path:

✅ POST /api/2025-05/kordiam/element
✅ PUT /api/2025-05/kordiam/element
✅ PUT /api/2025-05/kordiam/element/:documentId
✅ DELETE /api/2025-05/kordiam/element/:documentId

The same goes for the legacy kordiam integration (not the global integration). Just change the path from /desknet-integration to /kordiam-integration:

❌ POST /api/2025-05/desknet-integration/oauth/token
❌ POST /api/2025-05/desknet-integration/statuses
❌ PUT /api/2025-05/desknet-integration/publication
❌ PUT /api/2025-05/desknet-integration/publication/:documentId
❌ DELETE /api/2025-05/desknet-integration/publication/:documentId

✅ POST /api/2025-05/kordiam-integration/oauth/token
✅ POST /api/2025-05/kordiam-integration/statuses
✅ PUT /api/2025-05/kordiam-integration/publication
✅ PUT /api/2025-05/kordiam-integration/publication/:documentId
✅ DELETE /api/2025-05/kordiam-integration/publication/:documentId

Removal of Menu Tool

The Menu Tool has been removed, along with its public API endpoint. As a result, the following endpoints no longer exist:

❌ GET /api/v1/menus/:channelHandle?
❌ GET /api/beta/menus/:channelHandle?
❌ GET /api/2025-03/menus/:channelHandle?

We suggest migrating your menus to data records. For detailed instructions on setting them up, refer to our guide.

API Versioning

We’re introducing a new API Versioning Strategy that allows us to iterate on the API without breaking existing integrations.

With the introduction of a new versioning strategy, the v1 and beta versions are now available as 2025-03 version. If you use any of those versions, you can safely change your integration to the 2025-03 version, which now contains both functionalities without any other changes.

Media Library: Serve Image

We’ve added a new public API endpoint:

/api/2025-03/mediaLibrary/serve-image/:key

This endpoint provides access to an image in its original dimensions, as long as it has not been revoked or marked as invalid. It can serve as a source for proxies or image processing services.

Please check the API reference for more details.

Brand Conditions

Conditional components provide the ability to render a component in the delivery based on a brands or dateTime condition. The conditions are stored with the component data and can be input in the Livingdocs Editor.

To support country- or brand-specific content, we are introducing a new component condition: the brands condition. This allows downstreams to configure a set of brands, from which one or more can be selected on components to define for which brands a component should be included. This condition works alongside the already existing dateTime condition.

For more information, please refer to our conditional components documentation.

The brands condition is supported by all API endpoints where the existing dateTime component condition is supported:

• GET /api/v1/documents/:documentId/latestPublication
• GET /api/v1/documents/latestPublications
• GET /api/v1/documents/:documentId/latestPublication/renditions/:renditionHandles
• GET /api/v1/publications/search
• GET /api/v1/document-lists/:id
• GET /api/beta/documents/:documentId/latestDraft
• GET /api/beta/documents/:documentId/latestPublication
• GET /api/beta/documents/latestPublications
• POST /api/beta/composition/:documentId

Deprecate Menu Tool

The Menu Tool is deprecated and will be removed in release-2025-05. Please migrate your menus to data records, using the li-tree plugin and, if needed, the li-unique-id metadata plugin. For detailed instructions on setting up menus with data records, refer to our guide. We are here to assist with the migration as needed.

Document Command API: New Commands

We have extended the Document Command API with five new commands, which are also available for Assistants. Each command supports an optional oldValue parameter. When specified, the system verifies that the value being updated matches the provided oldValue. This prevents accidental overwrites that might occur due to changes made between reading a document and issuing the command. If the oldValue does not match, a conflict error is thrown.

setComponentCondition

{
  operation: 'setComponentCondition',
  componentId: 'doc-123',
  conditionName: 'dateTime',
  value: {
    gte: '2025-01-01T10:30:00.000Z',
    lt: '2025-02-02T14:30:00.000Z'
  },
  oldValue: {
    gte: '2024-01-01T10:30:00.000Z',
    lt: '2024-02-02T14:30:00.000Z'
  }
}

setComponentStyle

{
  operation: 'setComponentStyle',
  componentId: 'doc-123',
  propertyName: 'background',
  value: '#1fc47a',
  oldValue: '#000'
}

setStyleDirective

{
  operation: 'setStyleDirective',
  componentId: 'doc-123',
  directiveName: 'appearance',
  propertyName: 'background',
  value: '#1fc47a',
  oldValue: '#000'
}

setLinkDirective

{
  operation: 'setLinkDirective',
  componentId: 'doc-123',
  directiveName: 'link',
  value: {
    href: 'https://livingdocs.io/article/123',
    target: '_blank',
    $ref: 'document',
    reference: {id: '123'}
  },
  oldValue: {
    href: 'https://livingdocs.io/'
  }
}

setIncludeDirective

The setIncludeDirective command supports updating both include params and overrides. These properties depend on each other: if only params are provided, any existing overrides are removed. Conversely, specifying overrides without params is invalid and will return a validation error. To update overrides, both the params and overrides properties must be provided.

{
  operation: 'setIncludeDirective',
  componentId: 'doc-123',
  directiveName: 'related-article',
  value: {
    params: {
      teaser: {
        $ref: 'document',
        reference: {id: '3'}
      },
    },
    overrides: [{
      id: 'teaser-normal-3',
      content: {
        link: {href: 'https://livingdocs.io'},
        title: 'Changed title',
      },
      originalSnapshot: {...},
      contentProperties: [...]
    }]
  },
  oldValue: null
}

Document Command API: New Commands

We have extended the Document Command API with two new commands, which are also available for Assistants.

removeComponent

{
  operation: 'removeComponent',
  componentId: 'doc-4a2b3g4d5'
}

unpublish

{
  operation: 'unpublish'
}