Skip to content

Get dashboards

GET /api/v1/dashboards/{dashboardId}: request fields and declared response contract.

GET/api/v1/dashboards/{dashboardId}

Authorization
Permissiondashboard.view
Workspace scoperequired
Scope targetresource

Parameters

Path parameters
FieldTypeRequiredNullableDefault
dashboardIdstringrequirednon-null—

Query parameters: none.

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataobjectrequirednon-null—
data.idstringrequirednon-null—
data.companyIdstringrequirednon-null—
data.workspaceIdstringrequirednon-null—
data.namestringrequirednon-null—
data.descriptionstringoptionalnullable—
data.renderer"widget-grid" | "custom-html"requirednon-null—
data.queriesarrayrequirednon-null—
data.definitionunknownrequirednon-null—
data.filtersobjectrequirednon-null—
data.filters.filtersarrayoptionalnon-null—
data.filters.dateRangestringoptionalnon-null—
data.boundDimensionsobjectrequirednon-null—
data.freeDimensionsarrayrequirednon-null—
data.groupingsobjectoptionalnullable—
data.systembooleanrequirednon-null—
data.colorstringoptionalnullable—
data.iconstringoptionalnullable—
data.createdBystringrequirednon-null—
data.createdAtunknownrequirednon-null—
data.updatedAtunknownrequirednon-null—
data.revisionobjectrequirednon-null—
data.revision.updatedAtstringrequirednon-null—
data.revision.renderDigeststringrequirednon-null—
data.interactionAuthoringobjectrequirednon-null—
data.interactionAuthoring.capabilitiesobjectrequirednon-null—
data.interactionAuthoring.planClassesobjectrequirednon-null—

Declared failures

Declared failures
NOT_FOUND404 — not retryable
VALIDATION_ERROR400 — not retryable

Readback

This method returns the current state it read.

  • dashboards.get

Request example

Schematic only. Replace placeholders with real values and include all required nested fields.

GET /api/v1/dashboards/{dashboardId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>