Update a Diagram Tool
put
/api/diagram/Tools/{id}
Updates the properties of the diagram tool.
Request
Path Parameters
-
id(required): integer
The diagram tool ID specified for individual CRUD operations.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
Height: integer
The height of the View tool when ToolTarget is set to window.Example:
80
-
Icon: string
The relative image path for the icon.Example:
fugue/heart--exclamation.png
-
ToolName: string
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
-
ToolPath: string
The URL path for a View tool.Example:
dashboard/Device%20Overview?DeviceName=<DeviceName>&FilterType=DeviceName&FilterValue=<DeviceName>&DeviceZoneName=<DeviceZoneName>
-
ToolPathTypeID: integer
The ID associated with the ToolPathType for View tools. Allowed Values:
- 1: Local
- 2: Internal
- 3: Hybrid
- 4: Remote
Example:2
-
ToolTarget: string
Allowed Values:
[ "window", "currenttab", "newtab" ]
Where to open the View tool.Example:window
-
Width: integer
The width of the View tool when ToolTarget is set to window.Example:
80
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 : type
Type:
Show Source
object
-
data: array
data
The properties of the updated diagram tool.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : diagramToolsRead
Type:
Show Source
object
-
Height: integer
The height of the View tool when ToolTarget is set to window.Example:
80
-
Icon: string
The relative image path for the icon.Example:
fugue/heart--exclamation.png
-
ToolID: integer
The unique tool ID.Example:
2
-
ToolName: string
The tool name.Example:
Device Health
-
ToolPath: string
The URL path for a View tool.Example:
dashboard/Device%20Overview?DeviceName=<DeviceName>&FilterType=DeviceName&FilterValue=<DeviceName>&DeviceZoneName=<DeviceZoneName>
-
ToolPathType: string
How the View tool runs with the associated diagram widget. Allowed values:
- Local
- Internal
- Hybrid
- Remote
Example:Internal
-
ToolPathTypeID: integer
The ID associated with the ToolPathType for View tools. Allowed Values:
- 1: Local
- 2: Internal
- 3: Hybrid
- 4: Remote
Example:2
-
ToolTarget: string
Allowed Values:
[ "window", "currenttab", "newtab" ]
Where to open the View tool.Example:window
-
ToolTypeID: integer
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
-
ToolTypeName: string
The tool type name associated with the specified ToolTypeID.Example:
View
-
Width: integer
The width of the View tool when ToolTarget is set to window.Example:
80
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.