> Dashboard object

The following objects are directly related to the dashboard API.

Dashboard

The dashboard object has the following properties:

Property Type Description
dashboardid string (readonly) ID of the dashboard.
name
(required)
string Name of the dashboard.
userid string Dashboard owner user ID.
private integer Type of dashboard sharing.

Possible values:
0 - public dashboard;
1 - (default) private dashboard.

Note that for some methods (update, delete) the required/optional parameter combination is different.

Dashboard widget

The dashboard widget object has the following properties:

Property Type Description
widgetid string (readonly) ID of the dashboard widget.
type
(required)
string Type of the dashboard widget.

Possible values:
actionlog - Action log;
clock - Clock;
dataover - Data overview;
discovery - Discovery status;
favgraphs - Favorite graphs;
favmaps - Favorite maps;
favscreens - Favorite screens;
graph - Graph (classic);
graphprototype - Graph prototype;
hostavail - Host availability;
map - Map;
navtree - Map Navigation Tree;
plaintext - Plain text;
problemhosts - Problem hosts;
problems - Problems;
problemsbysv - Problems by severity;
svggraph - Graph;
systeminfo - System information;
trigover - Trigger overview;
url - URL;
web - Web monitoring;
name string Custom widget name.
x integer A horizontal position from the left side of the dashboard.

Valid values range from 0 to 23.
y integer A vertical position from the top of the dashboard.

Valid values range from 0 to 62.
width integer The widget width.

Valid values range from 1 to 24.
height integer The widget height.

Valid values range from 2 to 32.
view_mode integer The widget view mode.

Possible values:
0 - (default) default widget view;
1 - with hidden header;
fields array Array of the dashboard widget field objects.

Dashboard widget field

The dashboard widget field object has the following properties:

Property Type Description
type
(required)
integer Type of the widget field.

Possible values:
0 - Integer;
1 - String;
2 - Host group;
3 - Host;
4 - Item;
5 - Item prototype;
6 - Graph;
7 - Graph prototype;
8 - Map.
name string Widget field name.
value
(required)
mixed Widget field value depending of type.

Dashboard user group

List of dashboard permissions based on user groups. It has the following properties:

Property Type Description
usrgrpid
(required)
string User group ID.
permission
(required)
integer Type of permission level.

Possible values:
2 - read only;
3 - read-write.

Dashboard user

List of dashboard permissions based on users. It has the following properties:

Property Type Description
userid
(required)
string User ID.
permission
(required)
integer Type of permission level.

Possible values:
2 - read only;
3 - read-write.