Create Dashboard

Creates a new dashboard

POST /api/v2/dashboards

Error

simpleTimeSeriesDashboard

A valid request URL is required to generate request examples

200

{
  "data": {
    "id": "65f5e4a3b9e77c001a567890",
    "name": "API Monitoring Dashboard",
    "tiles": [
      {
        "id": "65f5e4a3b9e77c001a901234",
        "name": "API Request Volume",
        "x": 0,
        "y": 0,
        "w": 6,
        "h": 3,
        "config": {
          "displayType": "line",
          "sourceId": "65f5e4a3b9e77c001a111111",
          "select": [
            {
              "aggFn": "count",
              "where": "service:api"
            }
          ]
        }
      }
    ],
    "tags": [
      "api",
      "monitoring"
    ],
    "filters": [
      {
        "id": "65f5e4a3b9e77c001a301004",
        "type": "QUERY_EXPRESSION",
        "name": "Environment",
        "expression": "environment",
        "sourceId": "65f5e4a3b9e77c001a111111"
      }
    ]
  }
}

{
  "message": "Could not find the following source IDs: 68fa86308aa879b977aa6af6"
}

{
  "message": "Unauthorized access. API key is missing or invalid."
}

{
  "message": "Dashboard validation failed: name is required"
}

Autorizações

Authorization · string · header · obrigatório

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

Corpo

application/json

name · string · obrigatório

Dashboard name.

Maximum string length: 1024

Exemplo:

"New Dashboard"

tiles · object[] · obrigatório

List of tiles/charts to include in the dashboard.

Maximum array length: 500

Show child attributes

tags · string[]

Tags for organizing and filtering dashboards.

Maximum array length: 50

Maximum string length: 32

Exemplo:

["development"]

filters · object[]

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

Show child attributes

savedQuery · string | null

Optional default dashboard query to persist on the dashboard.

Exemplo:

"service.name = 'api'"

savedQueryLanguage · enum<string> | null · padrão: lucene

Query language used by savedQuery.

Opções disponíveis: sql, lucene

Exemplo:

"sql"

savedFilterValues · object[]

Optional default dashboard filter values to persist on the dashboard.

Show child attributes

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

Show child attributes

Resposta

200

application/json

Successfully created dashboard

data · object

The dashboard object.

Show child attributes