# Update dashboard

Updates (renames) the specified dashboard.

Endpoint: PUT /sights/{sightId}
Version: 2.0.0
Security: APIToken, OAuth2

## Header parameters:

  - `Authorization` (string)
    API Access Token used to authenticate requests to Smartsheet APIs.

  - `smartsheet-integration-source` (string)
    Uses the following metadata to distinguish between human-initiated API requests and third-party service-initiated calls by AI Connectors or ITSM:

- Integration source type
- Organization name
- Integration source name 

Format:


TYPE,OrgName,SourceName


Examples: 

AI,SampleOrg,My-AI-Connector-v2

SCRIPT,SampleOrg2,Accounting-updater-script

APPLICATION,SampleOrg3,SheetUpdater
    Example: "AI,SampleOrg,My-AI-Connector-v2"

  - `Content-Type` (string)
    Required for POST and PUT requests. Defines the structure for the request body.

## Path parameters:

  - `sightId` (string, required)
    ID of the dashboard (sight) being accessed.

## Query parameters:

  - `numericDates` (boolean)
    You can optionally choose to receive and send dates/times in numeric format, as milliseconds since the UNIX epoch (midnight on January 1, 1970 in UTC time), using the query string parameter numericDates with a value of true. This query parameter works for any API request.

## Request fields (application/json):

  - `name` (string)
    Dashboard name.

## Response 200 fields (application/json):

  - `failedItems` (array,null)
    Array of BulkItemFailure objects which represents the items that failed to be added or updated. See [Bulk operations > Partial success](/api/smartsheet/guides/advanced-topics/scalability-options) for more information. Applicable only for bulk operations that support partial success.

  - `failedItems.rowId` (number,null)
    The ID of the row that failed. Applicable only to bulk row operations.

  - `failedItems.error` (object)
    The error caused by the failed item.

  - `failedItems.error.refId` (string)
    The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.

  - `failedItems.error.errorCode` (number)
    Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).

  - `failedItems.error.message` (string)
    Descriptive error message.

  - `failedItems.index` (number)
    The index of the failed item in the bulk request array.

  - `message` (string)
    Message that indicates the outcome of the request. (One of SUCCESS or PARTIAL_SUCCESS.)
    Enum: "PARTIAL_SUCCESS", "SUCCESS"

  - `resultCode` (number)
    * '0' Success
* '3' Partial Success of Bulk Operation
    Enum: 0, 3

  - `result` (object)

  - `result.backgroundColor` (string)
    The hex color, for instance #E6F5FE.

  - `result.defaultWidgetBackgroundColor` (string)
    The hex color of the background color for all widgets except for title widgets on the dashboard, for instance #E6F5FEF4 or #E6F5FE.

  - `result.columnCount` (number)
    Number of columns that the dashboard contains.

  - `result.source` (object)

  - `result.source.id` (number)
    The ID of the dashboard, report, sheet, or template from which the enclosing dashboard, report, sheet, or template was created.

  - `result.source.type` (string)
    report, sheet, sight (aka dashboard), or template.

  - `result.widgets` (array)

  - `result.widgets.id` (number)
    Widget ID.

  - `result.widgets.type` (string)
    Type of widget.
    Enum: "CHART", "GRIDGANTT", "IMAGE", "METRIC", "RICHTEXT", "SHEETSUMMARY", "SHORTCUT", "SHORTCUTICON", "SHORTCUTLIST", "TITLE", "WEBCONTENT"

  - `result.widgets.contents` (any)
    The type of widget content depends on the value of widget.type.

  - `result.widgets.height` (number)
    Number of rows that the widget occupies on the dashboard.

  - `result.widgets.showTitle` (boolean)
    True indicates that the client should display the widget title. This is independent of the title string which may be null or empty.

  - `result.widgets.showTitleIcon` (boolean)
    True indicates that the client should display the sheet icon in the widget title.

  - `result.widgets.title` (string)
    Title of the widget.

  - `result.widgets.titleFormat` (string)
    Title format descriptor (see [Cell formatting](/api/smartsheet/guides/advanced-topics/cell-formatting)).
    Example: ",,1,,,,,,,3,,,,,,1,"

  - `result.widgets.titleFont` (string)
    List of supported fonts in Dashboards
    Enum: "Arial", "Courier", "Georgia", "Gill Sans", "Helvetica", "Luminari", "Monaco", "Tahoma", "Times New Roman", "Verdana"

  - `result.widgets.version` (number)
    Widget version number.

  - `result.widgets.viewMode` (number)
    Indicates the content layout. Must use a query parameter of level=2 to see this information.

  * 1 - centered
  * 2 - left aligned
    Enum: 1, 2

  - `result.widgets.width` (number)
    Number of columns that the widget occupies on the dashboard.

  - `result.widgets.xPosition` (number)
    X-coordinate of widget's position on the dashboard.

  - `result.widgets.yPosition` (number)
    Y-coordinate of widget's position on the dashboard.

  - `result.workspace` (object)
    A reference to the dashboard's workspace, if the dashboard is in a workspace; otherwise an empty value.
    Example: {"id":1234567890,"name":"Some Workspace"}

  - `result.workspace.id` (number)
    Workspace ID.
    Example: 1234567890

  - `result.workspace.name` (string)
    Workspace name.
    Example: "Some Workspace"

  - `result.createdAt` (any)

  - `result.modifiedAt` (any)

  - `result.id` (number)
    Dashboard ID.

  - `result.accessLevel` (string)
    Enum: "ADMIN", "COMMENTER", "EDITOR", "EDITOR_SHARE", "OWNER", "VIEWER"

  - `result.permalink` (string)
    URL that represents a direct link to the dashboard in Smartsheet.

  - `result.name` (string)
    Dashboard name.

## Response default fields (application/json):

  - `refId` (string)
    The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.

  - `errorCode` (number)
    Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).

  - `message` (string)
    Descriptive error message.