Yandex DataLens Public API release notes

This section contains the DataLens Public API release notes. For more on versioning, see this guide.

Version 3Version 3

September 8, 2026: Upgrading to version 3September 8, 2026: Upgrading to version 3

1. Revised the argument/response schemas in methods for working with wizard charts:

   • getWizardChart
   • createWizardChart
   • updateWizardChart

2. Updated methods for working with dashboards and reports:

   • Added v2 versions of methods for getting, creating, and updating dashboards and reports:

     • getDashboardV2
     • createDashboardV2
     • updateDashboardV2
     • getPresentationV2
     • createPresentationV2
     • updatePresentationV2

   • Removed these fields from the schemas:

     • schemeVersion: Service version field for dashboards.
     • data.version: Service version field for reports.
     • data.description: Replaced with annotation.description.
     • background: Deprecated UI customization field.
     • textColor: Deprecated UI customization field.
     • widgetTabId: Deprecated field for dashboard insights.

   • For dataset selectors, fieldType now only accepts values from the dataset's data types, e.g., string, integer, date, and genericdatetime. For manual selectors, the fieldType field is preserved only for date selectors.

   • Added a requirement that dashboards must have at least one tab in data.tabs.

3. Migrations (when obtained via the getDashboardV2 method or when saved in the v1 entity interface):

   • Migrated dashboard description from data.description to annotation.description.
   • Migrated background colors of all widgets from the deprecated background to backgroundSettings.color: {light, dark}, and the header text color, from textColor to textSettings.color: {light, dark}. The final color format is HEX.
   • If there is no existing current widgetTabIds during migration, widgetTabId migrates as an array containing a single item (widgetTabIds).

Version 2Version 2

28.07.202628.07.2026

Non-breaking changes in the Public API version 2.

1. Added methods for working with HTML pages:

   • createHtmlPage
   • deleteHtmlPage
   • getHtmlPage
   • updateHtmlPage

2. Added methods for managing edit locks on DataLens entities, e.g., charts, dashboards, etc.:

   • createEntryLock
   • deleteEntryLock
   • extendEntryLock

3. Removed the [Experimental] tag from dashboard management methods:

   • createDashboard
   • deleteDashboard
   • getDashboard
   • updateDashboard

15.06.202615.06.2026

Non-breaking changes in the Public API version 2. Added the following methods:

• batchListMembers
• deleteFolder
• dlsSuggest
• getPermissions
• modifyPermissions
• moveFolderEntry

June 11, 2026: Upgrading to version 2June 11, 2026: Upgrading to version 2

Breaking changes to the Public API version 1. A new Public API major version is out: Public API version 2.

Introduced breaking changes to the getEntries method for retrieving Yandex DataLens entities.

1. Changed the ids field data type: string | string[] → string[].
2. Changed the createdBy field data type: string | string[] → string[].
3. Removed the page field of the number type, replacing it with pageToken of the string type.
4. Added a new ignoreSharedEntries field of the boolean type to remove shared objects from the response.

Version 1Version 1

22.01.202622.01.2026

January 22, 2026: the DataLens Public API version 1 is out.