Skip to main content
POST
Error

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
name
string
必填

Dashboard name.

Maximum string length: 1024
示例:

"New Dashboard"

tiles
object[]
必填

List of tiles/charts to include in the dashboard.

Maximum array length: 500
tags
string[]

Tags for organizing and filtering dashboards.

Maximum array length: 50
Maximum string length: 32
示例:
filters
object[]

Dashboard filter keys to add to the dashboard and apply across all tiles

savedQuery
string | null

Optional default dashboard query to persist on the dashboard.

示例:

"service.name = 'api'"

savedQueryLanguage
enum<string> | null
默认值:lucene

Query language used by savedQuery.

可用选项:
sql,
lucene
示例:

"sql"

savedFilterValues
object[]

Optional default dashboard filter values to persist on the dashboard.

containers
object[]

Optional grouping containers. Each tile may join a container via tile.containerId, and a tab inside it via tile.tabId.

Maximum array length: 50

响应

Validation result. HTTP 200 is always returned for valid and invalid bodies — a non-200 response means the request itself failed (auth, server error, etc.).

valid
boolean
必填

True when the body passes all validation rules.

errors
object[]
必填

Validation errors. Empty when valid is true.

normalized
object | null
必填

The parsed dashboard body with defaults applied (no persistence, so no server-assigned tile IDs). Populated when valid is true, null when valid is false.

最后修改于 2026年7月15日