Update a Dashboard

put

/api/dashboard/Dashboards/{id}

Updates the properties of the dashboard that matches the specified ID.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • The dashboard name.
    To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.
    Example: Basic Services Dashboard
  • Whether the header should be shown when the dashboard is rendered (1) or not (0).
    Example: 0
  • The maximum number of columns the dashboard will render before wrapping additional panels onto the next row.
    Example: 4
  • The owner user group ID.
    Example: 0
  • The ID of the user that owns the dashboard. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.
    Example: 0
  • A JSON string of parameters relating to the panel.
    Example: [{"PartTypeID":"6","width":100,"DashboardName":"Basic Services Dashboard","InitialExpansion":"0","InitialExpansionDynamic":"1","InitialView":"Summary","InitialViewDynamic":"1","LinkTarget":"NewWindow","LinkTargetDynamic":"1","PanelName":"Test","PartTypeID":"6","RefreshRate":"","RootID":"root","RootIDDynamic":"1","ShowToolbar":"1","SummaryInitialExpansion":"all","SummaryInitialExpansionDynamic":"1","SummaryNodeSize":"Normal","SummaryNodeSizeDynamic":"1","SummaryTreeType":"LeftToRight","SummaryTreeTypeDynamic":"1","TimeRangeDynamic":"1","TimeRange":"now-24h..now..","Width":"1","recordID":"DashboardsDashboard","width":"1","AutoHeight":1}]
  • The number of seconds between automatically refreshing the content of panels on the dashboard. Use null to prevent the dashboard from auto refreshing.
    Example: oracle.doceng.json.BetterJsonNull@740fefc6
  • Viewers
    The list of user groups that can view the dashboard.
Nested Schema : Viewers
Type: array
The list of user groups that can view the dashboard.
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Successful operation
Body ()
Root Schema : schema
Match All
Show Source
Nested Schema : SuccessfulUpdateOperation
Type: object
The response body for a successful update operation.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : data
Type: array
The properties of the updated dashboard.
Show Source
Nested Schema : dashboardDashboardsRead
Type: object
Show Source
  • The dashboard ID.
    Example: 12
  • The dashboard name.
    Example: Basic Services Dashboard
  • Dashboard Type ID
    Example: 1
  • The dashboard type name.
    Example: Basic
  • Whether the header should be shown when the dashboard is rendered (1) or not (0).
    Example: 0
  • The maximum number of columns the dashboard will render before wrapping additional panels onto the next row.
    Example: 4
  • The name of the owner.
    Example: [Public to All Users and Groups]
  • The owner user group ID.
    Example: 0
  • The ID of the user that owns the dashboard. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.
    Example: 0
  • A JSON string of parameters relating to the panel.
    Example: [{"PartTypeID":"6","width":100,"DashboardName":"Basic Services Dashboard","InitialExpansion":"0","InitialExpansionDynamic":"1","InitialView":"Summary","InitialViewDynamic":"1","LinkTarget":"NewWindow","LinkTargetDynamic":"1","PanelName":"Test","PartTypeID":"6","RefreshRate":"","RootID":"root","RootIDDynamic":"1","ShowToolbar":"1","SummaryInitialExpansion":"all","SummaryInitialExpansionDynamic":"1","SummaryNodeSize":"Normal","SummaryNodeSizeDynamic":"1","SummaryTreeType":"LeftToRight","SummaryTreeTypeDynamic":"1","TimeRangeDynamic":"1","TimeRange":"now-24h..now..","Width":"1","recordID":"DashboardsDashboard","width":"1","AutoHeight":1}]
  • The number of seconds between automatically refreshing the content of panels on the dashboard. Use null to prevent the dashboard from auto refreshing.
    Example: oracle.doceng.json.BetterJsonNull@740fefc6
  • Viewers
    The list of user groups that can view the dashboard.
Nested Schema : Viewers
Type: array
The list of user groups that can view the dashboard.
Show Source
Nested Schema : items
Type: object
Show Source

Default Response

Failed operation
Body ()
Root Schema : schema
Type: object
Show Source
Nested Schema : errors
Type: array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
Nested Schema : items
Type: object
An error.
Back to Top