Update a Diagram Tool

put

/api/diagram/Tools/{id}

Updates the properties of the diagram tool.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • The height of the View tool when ToolTarget is set to window.
    Example: 80
  • The relative image path for the icon.
    Example: fugue/heart--exclamation.png
  • The diagram tool 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: Device Health
  • The URL path for a View tool.
    Example: dashboard/Device%20Overview?DeviceName=<DeviceName>&FilterType=DeviceName&FilterValue=<DeviceName>&DeviceZoneName=<DeviceZoneName>
  • The ID associated with the ToolPathType for View tools. Allowed Values:
    • 1: Local
    • 2: Internal
    • 3: Hybrid
    • 4: Remote
    Example: 2
  • Allowed Values: [ "window", "currenttab", "newtab" ]
    Where to open the View tool.
    Example: window
  • The width of the View tool when ToolTarget is set to window.
    Example: 80
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 diagram tool.
Show Source
Nested Schema : diagramToolsRead
Type: object
Show Source
  • The height of the View tool when ToolTarget is set to window.
    Example: 80
  • The relative image path for the icon.
    Example: fugue/heart--exclamation.png
  • The unique tool ID.
    Example: 2
  • The tool name.
    Example: Device Health
  • The URL path for a View tool.
    Example: dashboard/Device%20Overview?DeviceName=<DeviceName>&FilterType=DeviceName&FilterValue=<DeviceName>&DeviceZoneName=<DeviceZoneName>
  • How the View tool runs with the associated diagram widget. Allowed values:
    • Local
    • Internal
    • Hybrid
    • Remote
    Example: Internal
  • The ID associated with the ToolPathType for View tools. Allowed Values:
    • 1: Local
    • 2: Internal
    • 3: Hybrid
    • 4: Remote
    Example: 2
  • Allowed Values: [ "window", "currenttab", "newtab" ]
    Where to open the View tool.
    Example: window
  • The tool type ID. Allowed Values:
    • 1: View. The menu tool executes in the URL path.
    • 2: SQL. The menu tool executes in SQL statements.
    Example: 1
  • The tool type name associated with the specified ToolTypeID.
    Example: View
  • The width of the View tool when ToolTarget is set to window.
    Example: 80

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