Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.
Written by
View in Markdown

Create HTML page

Creates a new HTML page.

Request

POST

https://api.datalens.tech/rpc/createHtmlPage

Headers

Name

Description

x-dl-api-version

Type: string

API version header.

Const: 2

Example: 2

Body

application/json
{
  "content": "example",
  "annotation": {
    "description": "example"
  },
  "key": "example",
  "workbookId": "example",
  "name": "example"
}
All of 2 types
  • Type: object

    content

    Type: string

    HTML content of the page.

    Max length: 10485760

    Example: example

    annotation
    Type: object

    description

    Type: string

    Description of the entry.

    Example: example

    Annotation of the HTML page.

    Example
    {
  "description": "example"
}
    Example
    {
  "content": "example",
  "annotation": {
    "description": "example"
  }
}

  • Type: EntryLocationIdentifiers

    Example
    {
  "key": "example",
  "workbookId": "example",
  "name": "example"
}

EntryLocationIdentifiers

Name

Description

key

Type: string

Entry key when creating the entry in a folder.

Example: example

name

Type: string

Entry name when creating the entry in a workbook.

Example: example

workbookId

Type: string

ID of the workbook where the entry should be created.

Example: example
Example
{
  "key": "example",
  "workbookId": "example",
  "name": "example"
}

Responses

200 OK

Response

Body

application/json
{
  "entry": {
    "entryId": "example",
    "scope": "artifact",
    "type": "html-page",
    "key": "example",
    "workbookId": "example",
    "collectionId": "example",
    "revId": "example",
    "savedId": "example",
    "publishedId": "example",
    "data": {},
    "meta": {
      "objectId": "example",
      "policyVersion": 0.5
    },
    "annotation": {
      "description": "example"
    },
    "createdBy": "example",
    "createdAt": "example",
    "updatedBy": "example",
    "updatedAt": "example",
    "revUpdatedBy": "example",
    "revUpdatedAt": "example",
    "tenantId": "example",
    "hidden": true,
    "version": 1,
    "public": true,
    "links": {},
    "isFavorite": true,
    "permissions": {
      "execute": true,
      "read": true,
      "edit": true,
      "admin": true
    }
  },
  "warnings": [
    "example"
  ]
}

Name

Description

entry
Type: object

annotation

Type: object | null

Annotation of the HTML page.

Example
{
  "description": "example"
}

collectionId

Type: string | null

ID of the collection containing the HTML page.

Example: example

createdAt

Type: string

Date and time when the HTML page was created.

Example: example

createdBy

Type: string

ID of the user who created the HTML page.

Example: example

data
Type: object

[additional]

Type: unknown

Example: null

Versioned data of the HTML page entry.

Example
{}

entryId

Type: string

Unique identifier of the HTML page.

Example: example

hidden

Type: boolean

Whether the HTML page is hidden.

key

Type: string

Key of the HTML page entry.

Example: example

meta
Type: object

objectId

Type: string

ID of the object containing the HTML content.

Example: example

policyVersion

Type: number

Version of the security policy injected into the HTML content.

Metadata of the HTML page.

Example
{
  "objectId": "example",
  "policyVersion": 0.5
}

public

Type: boolean

Whether the HTML page is public.

publishedId

Type: string | null

ID of the published HTML page revision.

Example: example

revId

Type: string

ID of the current HTML page revision.

Example: example

savedId

Type: string

ID of the saved HTML page revision.

Example: example

scope

Type: string

Scope of the HTML page entry.

Const: artifact

Example: example

tenantId

Type: string

ID of the tenant that owns the HTML page.

Example: example

type

Type: string

Type of the HTML page entry.

Const: html-page

Example: example

updatedAt

Type: string

Date and time when the HTML page was last updated.

Example: example

updatedBy

Type: string

ID of the user who last updated the HTML page.

Example: example

version

Type: number

Schema version of the HTML page.

Const: 1

workbookId

Type: string | null

ID of the workbook containing the HTML page.

Example: example

isFavorite

Type: boolean

Whether the HTML page is a favorite.

links

Type: object | null

Links associated with the HTML page.

Example
{}

permissions
Type: object

admin

Type: boolean

Indicates if there are permissions for admin.

edit

Type: boolean

Indicates if there are permissions to edit.

execute

Type: boolean

Indicates if there are permissions to execute.

read

Type: boolean

Indicates if there are permissions to read.

Permissions for the HTML page.

Example
{
  "execute": true,
  "read": true,
  "edit": true,
  "admin": true
}

revUpdatedAt

Type: string

Date and time when the current revision was last updated.

Example: example

revUpdatedBy

Type: string

ID of the user who last updated the current revision.

Example: example

Created HTML page entry.

Example
{
  "entryId": "example",
  "scope": "artifact",
  "type": "html-page",
  "key": "example",
  "workbookId": "example",
  "collectionId": "example",
  "revId": "example",
  "savedId": "example",
  "publishedId": "example",
  "data": {},
  "meta": {
    "objectId": "example",
    "policyVersion": 0.5
  },
  "annotation": {
    "description": "example"
  },
  "createdBy": "example",
  "createdAt": "example",
  "updatedBy": "example",
  "updatedAt": "example",
  "revUpdatedBy": "example",
  "revUpdatedAt": "example",
  "tenantId": "example",
  "hidden": true,
  "version": 1,
  "public": true,
  "links": {},
  "isFavorite": true,
  "permissions": {
    "execute": true,
    "read": true,
    "edit": true,
    "admin": true
  }
}

warnings

Type: string[]

Warning codes generated while processing the HTML content.

Example
[
  "example"
]
Previous
Overview
Next
Get HTML page