Move or Copy Dashboards to a Different Group
put
/api/dashboard/DashboardGroups/updateDashboards
Moves or copies dashboards to a different group. To move, specify a source group in SourceDashboardGroupID. To copy, do not specify a source group. This endpoint only applies to dashboards already in a dashboard group.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
Dashboards(required): array
Dashboards
The list of dashboard IDs.
-
id(required): integer
The destination dashboard group ID.Example:
28
-
SourceDashboardGroupID: integer
The source dashboard group ID. To move dashboards, specify an ID. To copy dashboards, do not use this parameter.
Nested Schema : Dashboards
Type:
array
The list of dashboard IDs.
Show Source
Example:
[
{
"DashboardID":"27",
"DashboardName":"Adhoc Metric Dashboard"
},
{
"DashboardID":"28",
"DashboardName":"Adhoc Event Dashboard"
},
{
"DashboardID":"39",
"DashboardName":"Adhoc View Config Dashboard"
},
{
"DashboardID":"29",
"DashboardName":"Adhoc Graph Dashboard"
}
]
Nested Schema : items
Type:
Show Source
object
-
DashboardID: integer
The dashboard ID.
-
DashboardName: string
The dashboard name.
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulUpdateOperation
The response body for a successful update operation.
-
object
type
Nested Schema : SuccessfulUpdateOperation
Type:
object
The response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : dashboardDashboardGroupsReadByID
Type:
Show Source
object
-
DashboardGroupID: integer
The dashboard group ID.Example:
1
-
DashboardGroupName: string
The dashboard group name.Example:
Adhoc
-
Dashboards: array
Dashboards
The list of dashboard IDs.
-
ParentDashboardGroupID: integer
The parent dashboard group ID.Example:
1
Nested Schema : Dashboards
Type:
array
The list of dashboard IDs.
Show Source
Example:
[
{
"DashboardID":"27",
"DashboardName":"Adhoc Metric Dashboard"
},
{
"DashboardID":"28",
"DashboardName":"Adhoc Event Dashboard"
},
{
"DashboardID":"39",
"DashboardName":"Adhoc View Config Dashboard"
},
{
"DashboardID":"29",
"DashboardName":"Adhoc Graph Dashboard"
}
]
Nested Schema : items
Type:
Show Source
object
-
DashboardID: integer
The dashboard ID.
-
DashboardName: string
The dashboard name.
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.