Create an Event Display
post
/api/event/Displays
Creates a new event display.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- DisplayName
- OwnerUserID
- OwnerUserGroupID
- DisableConversions
- DisplayColumns
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DisableConversions: integer
Toggles whether to disable conversions when viewing events with this displayExample:
0
-
DisplayColumns: object
DisplayColumns
Object of Columns and Orders
-
DisplayName: string
The name for the event display.
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:Default
-
OwnerUserGroupID:
OwnerUserGroupID
The ID of the user group owner.
-
OwnerUserID: integer
The ID of the user that owns the event display. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.Example:
0
-
Viewers: array
Viewers
List of user groups that can view
Nested Schema : DisplayColumns
Type:
object
Object of Columns and Orders
Show Source
-
Columns: array
Columns
Lists of all the fields available within the Events database.
-
Order: string
SQL sort by clause specifying which fields are sorted in which direction.Example:
[Public to All Users and Groups]
Nested Schema : OwnerUserGroupID
The ID of the user group owner.
Match One Schema
Show Source
Example:
0
Nested Schema : Columns
Type:
array
Lists of all the fields available within the Events database.
Show Source
Nested Schema : eventDisplayReadColumn
Type:
Show Source
object
-
ColumnAlign: string
Column content alignment, ex. Left, Center or RightExample:
Left
-
ColumnField: boolean
Field name in the Events tableExample:
false
-
ColumnName: string
Custom name specified for the FieldExample:
EventID
-
ColumnType: string
Type in which content is renderedExample:
Number
-
ColumnWidth: number
Column width when the event list is displayedExample:
100
-
Editable: boolean
Checkbox to indicate the field can be edited in the expanded event in the event list.Example:
true
-
Filterable: boolean
Checkbox to indicate the field can be filtered when filtering the event list.Example:
true
-
Sortable: boolean
Checkbox to indicate the field can be sorted when sorting the event list.Example:
true
-
Visible: boolean
Checkbox to indicate the field will be visible when the event list is displayed.Example:
false
Nested Schema : items
Type:
Show Source
object
-
UserGroupID: integer
The user group ID.
-
UserGroupName: string
The user group name.
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added 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 new event display.
-
total: integer
The total number of results regardless of pagingExample:
1
Nested Schema : eventDisplayRead
Type:
Show Source
object
-
DisableConversions: integer
Toggles whether to disable conversions when viewing events with this displayExample:
0
-
DisplayColumns: object
DisplayColumns
Object of Columns and Orders
-
DisplayColumnsGrid: string
A list of columns visible in the displayExample:
Device <br>Event Type <br>Event Text <br>Count <br>First Occurred <br>Last Occurred
-
DisplayID: integer
Display ID specified for individual CRUD operationsExample:
1
-
DisplayName: string
The name of displayExample:
Default
-
Owner: string
Defines the user that owns the display.Example:
[Public to All Users and Groups]
-
OwnerUserGroupID:
OwnerUserGroupID
The ID of the user group owner.
-
OwnerUserID: integer
The ID of the user that owns the event display. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.Example:
0
-
Viewers: array
Viewers
List of user groups that can view
Nested Schema : DisplayColumns
Type:
object
Object of Columns and Orders
Show Source
-
Columns: array
Columns
Lists of all the fields available within the Events database.
-
Order: string
SQL sort by clause specifying which fields are sorted in which direction.Example:
[Public to All Users and Groups]
Nested Schema : OwnerUserGroupID
The ID of the user group owner.
Match One Schema
Show Source
Example:
0
Nested Schema : Columns
Type:
array
Lists of all the fields available within the Events database.
Show Source
Nested Schema : eventDisplayReadColumn
Type:
Show Source
object
-
ColumnAlign: string
Column content alignment, ex. Left, Center or RightExample:
Left
-
ColumnField: boolean
Field name in the Events tableExample:
false
-
ColumnName: string
Custom name specified for the FieldExample:
EventID
-
ColumnType: string
Type in which content is renderedExample:
Number
-
ColumnWidth: number
Column width when the event list is displayedExample:
100
-
Editable: boolean
Checkbox to indicate the field can be edited in the expanded event in the event list.Example:
true
-
Filterable: boolean
Checkbox to indicate the field can be filtered when filtering the event list.Example:
true
-
Sortable: boolean
Checkbox to indicate the field can be sorted when sorting the event list.Example:
true
-
Visible: boolean
Checkbox to indicate the field will be visible when the event list is displayed.Example:
false
Nested Schema : items
Type:
Show Source
object
-
UserGroupID: integer
The user group ID.
-
UserGroupName: string
The user group name.
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.