/Dashboards POST

Create a new Home dashboard.

Notice

The behavior of this endpoint has changed in v11. For a description of behavior in v11, refer to POST /<module>. If you continue to use v10 of the API, your REST calls should behave as below. But, it is advisable to upgrade to v11.
Migrating to v11:
Recommended Replacement: POST /Dashboards
The Home module is no longer the default dashboard_module. To specify the Home module, include it in the Request Body.
v11: POST /Dashboards with the following in the Request Body: {"dashboard_module":"Home"}

Request Arguments

Name	Type	Description	Required
<record field>	<record field type>	The name value list of fields to populate.	True

Request

{
    "name": "New Home Dashboard",
    "dashboard_module": "Home",
    "view_name": "",
    "metadata": {
        "components": [{
            "rows": [[{
                "width": 12,
                "view": {
                    "limit": 10,
                    "visibility": "user",
                    "label": "Active Tasks",
                    "type": "active-tasks",
                    "module": null,
                    "template": "tabbed-dashlet"
                }
            }]],
            "width": 12
        }]
    }
}

Response Arguments

Name	Type	Description
<record field>	<record field type>	Returns the fields for the newly created dashboard.

Response

{
  "id": "4ccda6fa-fa02-9c8e-215f-56cf72f98fcb",
  "name": "New Home Dashboard",
  "date_entered": "2016-02-25T13:30:51-08:00",
  "date_modified": "2016-02-25T13:30:51-08:00",
  "modified_user_id": "1",
  "modified_by_name": "Administrator",
  "created_by": "1",
  "created_by_name": "Administrator",
  "description": "",
  "deleted": false,
  "dashboard_module": "Home",
  "view_name": "",
  "metadata": {
    "components": [
      {
        "rows": [
          [
            {
              "width": 12,
              "view": {
                "limit": 10,
                "visibility": "user",
                "label": "Active Tasks",
                "type": "active-tasks",
                "module": null,
                "template": "tabbed-dashlet"
              }
            }
          ]
        ],
        "width": 12
      }
    ]
  },
  "following": "",
  "my_favorite": false,
  "tag": [],
  "assigned_user_id": "1",
  "assigned_user_name": "Administrator",
  "_acl": {
    "fields": {}
  },
  "view": "",
  "_module": "Dashboards"
}

Change Log

Version	Change
v11	Behavior has changed. Please see POST /Dashboards for the designated replacement.
v10	Added `/Dashboards` POST endpoint.