Get a Diagram Tool by ID
get
/api/diagram/Tools/{id}
Gets the diagram tool that matches the specified ID.
Request
Path Parameters
-
id(required): integer
The diagram tool ID specified for individual CRUD operations.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulGetOperation
The response body for a successful get operation.
-
object
type
Nested Schema : SuccessfulGetOperation
Type:
object
The response body for a successful get operation.
Show Source
-
message: string
The response message.Example:
Loaded 1 entries
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
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.