DataLens API: 🚧 [Experimental] Get Editor chart

Статья создана

Обновлена 16 января 2026 г.

HTTP request
Body parameters
Response
Permissions
EditorTableNode
Data
EditorGravityChartsNode
EditorMarkdownNode
Data
EditorSelectorNode
Data
EditorAdvancedChartNode
EditorHighchartsNode
Data
EditorYagrNode
EditorMetricNode
Data
EditorMarkupNode
EditorYaMapsNode
Data
EditorModule
Data
EditorLegacyGraph
EditorLegacyTable
EditorLegacyMap
EditorLegacyManager
EditorLegacyText
EditorLegacyMetric

HTTP request

Returns the specified Editor chart.

POST https://api.datalens.yandex.net/rpc/getEditorChart

Body parameters

Request schema: application/json

{
  "chartId": "string",
  "workbookId": "string | null",
  "revId": "string",
  "includePermissions": "boolean",
  "includeLinks": "boolean",
  "includeFavorite": "boolean",
  "branch": "string"
}

Field	Description
chartId	string Required field. Required field. ID of the Editor chart to return. You can find it in the chart settings in DataLens interface.
workbookId	string \| null ID of the workbook the Editor chart belongs to. If navigation across folders is enabled and the Editor chart belongs to a folder, the value must be `null`.
revId	string Version ID for the Editor chart. For details, see documentation.
includePermissions	boolean Include information on configured permissions in the response.
includeLinks	boolean Include information on configured links in the response.
includeFavorite	boolean Include favorite status in the response.
branch	enum `saved`

Response

HTTP Code: 200

Response

Response schema: application/json

{
  "isFavorite": "boolean",
  "permissions": {
    "execute": "boolean",
    "read": "boolean",
    "edit": "boolean",
    "admin": "boolean"
  },
  "entry": "unknown"
}

Field	Description
isFavorite	boolean Indicates if the chart is marked as favorite.
permissions	Permissions Required field. Permissions for the chart.
entry	Type of the chart. One of EditorTableNode \| EditorGravityChartsNode \| EditorMarkdownNode \| EditorSelectorNode \| EditorAdvancedChartNode \| EditorHighchartsNode \| EditorYagrNode \| EditorMetricNode \| EditorMarkupNode \| EditorYaMapsNode \| EditorModule \| EditorLegacyGraph \| EditorLegacyTable \| EditorLegacyMap \| EditorLegacyManager \| EditorLegacyText \| EditorLegacyMetric

Permissions

Field	Description
execute	boolean Required field. Permission to execute.
read	boolean Required field. Permission to read.
edit	boolean Required field. Permission to edit.
admin	boolean Required field. Permission to administer.

EditorTableNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Table Editor charts takes value: `table_node`
data	Data Required field. Chart data.

Data

Field	Description
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
secrets	string Secrets configuration.
controls	string Required field. Configuration from the Controls tab.
prepare	string Required field. Configuration from the Prepare tab.
config	string Required field. Configuration from the Config tab.

EditorGravityChartsNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For D3 Editor charts takes value: `d3_node`
data	Data Required field. Chart data.

EditorMarkdownNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Markdown Editor charts takes value: `markdown_node`
data	Data Required field. Chart data.

Data

Field	Description
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
secrets	string Secrets configuration.
controls	string Required field. Configuration from the Controls tab.
prepare	string Required field. Configuration from the Prepare tab.

EditorSelectorNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor JS selectors takes value: `control_node`
data	Data Required field. Chart data.

Data

Field	Description
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
secrets	string Secrets configuration.
controls	string Required field. Configuration from the Controls tab.

EditorAdvancedChartNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Advanced Editor charts takes value: `advanced-chart_node`
data	Data Required field. Chart data.

EditorHighchartsNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Highcharts takes value: `graph_node`
data	Data Required field. Chart data.

Data

Field	Description
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
secrets	string Secrets configuration.
controls	string Required field. Configuration from the Controls tab.
prepare	string Required field. Configuration from the Prepare tab.
config	string Required field. Configuration from the Config tab.
graph	string Required field. Configuration from the library tab (e.g. Highcharts, Yagr, Gravity UI).

EditorYagrNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Yagr charts takes value: `timeseries_node`
data	Data Required field. Chart data.

EditorMetricNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Metric charts takes value: `metric_node`
data	Data Required field. Chart data.

Data

Field	Description
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
secrets	string Secrets configuration.
prepare	string Required field. Configuration from the Prepare tab.
config	string Required field. Configuration from the Config tab.

EditorMarkupNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Markup charts takes value: `markup_node`
data	Data Required field. Chart data.

EditorYaMapsNode

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Yandex Map charts takes value: `ymap_node`
data	Data Required field. Chart data.

Data

Field	Description
ymap	string Required field. Configuration from the Ymap tab.
shared	string Required field. Configuration from the Shared tab.
params	string Required field. Configuration from the Params tab.
sources	string Required field. Configuration from the Sources tab.
prepare	string Required field. Configuration from the Prepare tab.
secrets	string Secrets configuration.

EditorModule

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. For Editor Modules takes value: `module`
data	Data Required field. Chart data.

Data

Field	Description
documentation_en	string Documentation from the Doc En tab.
documentation_ru	string Documentation from the Doc Ru tab.
prepare	string Required field. Configuration from the Prepare tab.

EditorLegacyGraph

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `graph`
data	object (map<string, string>) Required field. Chart data.

EditorLegacyTable

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `table`
data	object (map<string, string>) Required field. Chart data.

EditorLegacyMap

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `map`
data	object (map<string, string>) Required field. Chart data.

EditorLegacyManager

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `manager`
data	object (map<string, string>) Required field. Chart data.

EditorLegacyText

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `text`
data	object (map<string, string>) Required field. Chart data.

EditorLegacyMetric

Field	Description
version	enum Required field. Editor version. Аvailable values: `1`
entryId	string Required field. Unique identifier of the entry.
key	Any of null \| string \| null Key identifier of the entry.
createdAt	string Required field. Creation timestamp.
createdBy	string Required field. Creator of the entry.
updatedAt	string Required field. Last update timestamp.
updatedBy	string Required field. Last updater of the entry.
revId	string Required field. Version ID for the Editor chart.
savedId	string Required field. Saved version ID.
publishedId	string \| null Required field. Published version ID.
tenantId	string Required field. Tenant ID.
hidden	boolean Required field. Indicates if the entry is hidden.
public	boolean Required field. Indicates if the entry is public.
workbookId	Any of null \| string \| null ID of the workbook the Editor chart belongs to.
scope	enum Required field. Type of the entry. For charts takes value: `widget`
meta	object \| null Required field. Metadata associated with the entry.
links	object \| null Link information.
annotation	object \| null Annotation information.
type	enum Required field. `metric`
data	object (map<string, string>) Required field. Chart data.

DataLens API: 🚧 [Experimental] Get Editor chart

HTTP requestHTTP request

Body parametersBody parameters

ResponseResponse

PermissionsPermissions

EditorTableNodeEditorTableNode

DataData

EditorGravityChartsNodeEditorGravityChartsNode

EditorMarkdownNodeEditorMarkdownNode

DataData

EditorSelectorNodeEditorSelectorNode

DataData

EditorAdvancedChartNodeEditorAdvancedChartNode

EditorHighchartsNodeEditorHighchartsNode

DataData

EditorYagrNodeEditorYagrNode

EditorMetricNodeEditorMetricNode

DataData

EditorMarkupNodeEditorMarkupNode

EditorYaMapsNodeEditorYaMapsNode

DataData

EditorModuleEditorModule

DataData

EditorLegacyGraphEditorLegacyGraph

EditorLegacyTableEditorLegacyTable

EditorLegacyMapEditorLegacyMap

EditorLegacyManagerEditorLegacyManager

EditorLegacyTextEditorLegacyText

EditorLegacyMetricEditorLegacyMetric

Была ли статья полезна?

HTTP request

Body parameters

Response

Permissions

EditorTableNode

Data

EditorGravityChartsNode

EditorMarkdownNode

Data

EditorSelectorNode

Data

EditorAdvancedChartNode

EditorHighchartsNode

Data

EditorYagrNode

EditorMetricNode

Data

EditorMarkupNode

EditorYaMapsNode

Data

EditorModule

Data

EditorLegacyGraph

EditorLegacyTable

EditorLegacyMap

EditorLegacyManager

EditorLegacyText

EditorLegacyMetric