Skip to main content

Get a dashboard

GEThttps://api.eu1.coralogix.com/mgmt/openapi/5/dashboards/dashboards/v1/{dashboard_id}

Returns the details of the specified dashboard. A caller with team-dashboards:Read receives the dashboard definition and its metadata. A caller without it who holds team-dashboards:ReadAccessPolicy or access-policies:ReadAll receives only the access policy and the lock state.

Requires the following permissions:

  • team-dashboards:Read
  • team-dashboards:ReadAccessPolicy
  • access-policies:ReadAll

Authorizations

Authorizationstringheaderrequired
API key authentication

Request​

Path Parameters

    dashboard_id# stringrequired

    Possible values: >= 21 characters and <= 21 characters, Value must match regular expression ^[\s\S]*$

    The dashboard id.

Response

application/json

This is a response containing the requested dashboard

    accessPolicy#string

    JSON string with the access policy of this dashboard. Present only when the caller holds team-dashboards:ReadAccessPolicy for this dashboard or access-policies:ReadAll.

    Possible values: <= 65536 characters, Value must match regular expression ^[\s\S]*$

    Example: {"version":"2025-01-01","default":{"permissions":{"team-dashboards:Read":"grant","team-dashboards:Update":"deny","team-dashboards:ReadAccessPolicy":"grant","team-dashboards:UpdateAccessPolicy":"deny"}},"rules":[]}
    authorId#string

    The author id.

    Possible values: non-empty and <= 128 characters, Value must match regular expression ^[\s\S]*$

    authorName#string

    The author name.

    Possible values: non-empty and <= 255 characters, Value must match regular expression ^[\s\S]*$

    createdAt#date-time

    Creation timestamp.

    Possible values: >= 20 characters and <= 30 characters

    createdOriginType#TokenOriginType

    Token origin type.

    Possible values: [TOKEN_ORIGIN_TYPE_UNSPECIFIED, TOKEN_ORIGIN_TYPE_USER, TOKEN_ORIGIN_TYPE_API]

    The dashboard definition. Omitted when the caller lacks team-dashboards:Read.

    isLocked#boolean

    The is locked.

    lockerAuthorId#string

    The locker author id.

    Possible values: non-empty and <= 128 characters, Value must match regular expression ^[\s\S]*$

    lockerName#string

    The locker name.

    Possible values: non-empty and <= 255 characters, Value must match regular expression ^[\s\S]*$

    Map of resolved widget references for widgets with references in the dashboard

    updatedAt#date-time

    Last-updated timestamp.

    Possible values: >= 20 characters and <= 30 characters

    updatedOriginType#TokenOriginType

    Token origin type.

    Possible values: [TOKEN_ORIGIN_TYPE_UNSPECIFIED, TOKEN_ORIGIN_TYPE_USER, TOKEN_ORIGIN_TYPE_API]

    updaterAuthorId#string

    The updater author id.

    Possible values: non-empty and <= 128 characters, Value must match regular expression ^[\s\S]*$

    updaterName#string

    The updater name.

    Possible values: non-empty and <= 255 characters, Value must match regular expression ^[\s\S]*$