v1

latestOpenAPI 3.0.32026-07-14314472448.6 KB
dashboards

Create / Update dashboard

Creates a new dashboard or updates an existing dashboard. Note: This endpoint is not intended for creating folders, use POST /api/folders for that.

Use: /apis/dashboard.grafana.app/v1/namespaces/{ns}/dashboards

post/dashboards/db

Request body

UpdatedAtstring date-time
dashboardJson
folderIdinteger

Deprecated: use FolderUID instead

folderUidstring
isFolderboolean
messagestring
overwriteboolean
userIdinteger

Response

(empty)

folderUidstring

FolderUID The unique identifier (uid) of the folder the dashboard belongs to.

idinteger required

ID The unique identifier (id) of the created/updated dashboard.

statusstring required

Status status of the response.

titlestring required

Slug The slug of the dashboard.

uidstring required

UID The unique identifier (uid) of the created/updated dashboard.

urlstring required

URL The relative URL for accessing the created/updated dashboard.

versioninteger required

Version The version of the dashboard.

Example response

{
  "id": 1,
  "status": "success",
  "title": "my-dashboard",
  "uid": "nHz3SXiiz",
  "url": "/d/nHz3SXiiz/my-dashboard",
  "version": 2
}