Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex DataLens
  • DataLens neuroanalyst
  • DataLens Gallery
    • How to use the Public API
      • Overview
      • createCollection
      • deleteCollection
      • deleteCollections
      • getCollectionBreadcrumbs
      • getCollection
      • getCollectionContent
      • getRootCollectionPermissions
      • moveCollection
      • moveCollections
      • updateCollection
      • getConnection
      • createConnection
      • updateConnection
      • deleteConnection
      • getDashboard
      • createDashboard
      • updateDashboard
      • deleteDashboard
      • getDataset
      • createDataset
      • updateDataset
      • deleteDataset
      • validateDataset
      • getEntriesRelations
      • getEntries
      • getQLChart
      • deleteQLChart
      • updateQLChart
      • createQLChart
      • getWizardChart
      • deleteWizardChart
      • updateWizardChart
      • createWizardChart
      • createWorkbook
      • deleteWorkbook
      • deleteWorkbooks
      • getWorkbook
      • getWorkbooksList
      • moveWorkbook
      • moveWorkbooks
      • updateWorkbook
      • getWorkbookEntries
      • getEditorChart
      • deleteEditorChart
      • createEditorChart
      • updateEditorChart
      • createEmbed
      • listEmbeds
      • deleteEmbed
      • updateEmbed
      • getEntriesPermissions
      • createEmbeddingSecret
      • listEmbeddingSecrets
      • deleteEmbeddingSecret
      • getEmbeddingSecret
      • getAuditEntriesUpdates
      • updateCollectionAccessBindings
      • createFolder
      • listDirectory
      • updateWorkbookAccessBindings
  • Audit Trails events

In this article:

  • HTTP request
  • Body parameters
  • Settings
  • Response
  • Settings
  1. DataLens Public API
  2. DataLens API
  3. createEmbed

DataLens API: Create embed

Written by
Yandex Cloud
Updated at March 16, 2026
  • HTTP request
  • Body parameters
  • Settings
  • Response
  • Settings

Creates the specified embedding.

HTTP requestHTTP request

POST https://api.datalens.tech/rpc/createEmbed

Body parametersBody parameters

Request schema: application/json

{
  "title": "string",
  "embeddingSecretId": "string",
  "entryId": "string",
  "depsIds": [
    "string"
  ],
  "unsignedParams": [
    "string"
  ],
  "privateParams": [
    "string"
  ],
  "publicParamsMode": "boolean",
  "settings": {
    "enableExport": "boolean"
  }
}

Field

Description

title

string

Required field. Name of the embedding.

embeddingSecretId

string

Required field. ID of the key for embedding used for authentication.

entryId

string

Required field. ID of the entry to be privately embedded.

depsIds[]

string

Required field. Array of dependency entry IDs.

unsignedParams[]

string

Required field. Array of unsigned parameters to be provided in the embedding link.

privateParams[]

string

Required field. Array of signed parameters that are provided as part of the token.

publicParamsMode

boolean

Required field. Whether default parameters mode is enabled.

settings

Settings

Required field. Embedding settings.

SettingsSettings

Field

Description

enableExport

boolean

Whether data export is enabled for the embedding.

ResponseResponse

HTTP Code: 200

Response

Response schema: application/json

{
  "embedId": "string",
  "title": "string",
  "embeddingSecretId": "string",
  "entryId": "string",
  "depsIds": [
    "string"
  ],
  "unsignedParams": [
    "string"
  ],
  "privateParams": [
    "string"
  ],
  "createdBy": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "updatedBy": "string",
  "publicParamsMode": "boolean",
  "settings": {
    "enableExport": "boolean"
  }
}

Field

Description

embedId

string

Required field. Unique identifier of the embedding.

title

string

Required field. Name of the embedding.

embeddingSecretId

string

Required field. ID of the key for embedding used for authentication.

entryId

string

Required field. ID of the entry being privately embedded.

depsIds[]

string

Required field. Array of dependency entry IDs.

unsignedParams[]

string

Required field. Array of unsigned parameters to be provided in the embedding link.

privateParams[]

string

Required field. Array of signed parameters that are provided as part of the token.

createdBy

string

Required field. ID of the user who created the embedding.

createdAt

string

Required field. Timestamp when the embedding was created.

updatedAt

string

Required field. Timestamp when the embedding was last updated.

updatedBy

string

Required field. ID of the user who was the last to update the embedding.

publicParamsMode

boolean

Required field. Whether default parameters mode is enabled.

settings

Settings

Required field. Embedding settings.

SettingsSettings

Field

Description

enableExport

boolean

Whether data export is enabled for the embedding.

Was the article helpful?

Previous
updateEditorChart
Next
listEmbeds
© 2026 Direct Cursus Technology L.L.C.