Create a Journal Entry
post
/api/event/EventJournals
Creates a new journal entry for a specified event.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- EventID
- JournalEntry
- JournalActor (defaults to the current user if not specified)
- JournalAction (defaults to "Manual journal entry by user" if not specified)
- ShardID (defaults to 1 if not specified, but specify it if you are using database shards)
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
EventID: integer
The ID of the event the new journal entry will be attached to.
-
Events: array
Events
A comma-separated list of event IDs. Any API action included applies to all events.
-
JournalAction: string
The action value to be used when the tool is run. It will default to the name of the tool if it is left blank.Example:
Acknowledge
-
JournalActor: string
The actor value to be used when the tool is run. It will default to the UserID of the user running the tool if it is left blank.Example:
John Doe
-
JournalEntry: string
The text of the journal entry.
Nested Schema : Events
Type:
array
A comma-separated list of event IDs. Any API action included applies to all events.
Show Source
Nested Schema : items
Type:
object
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 journal entry.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : eventEventJournalsRead
Type:
Show Source
object
-
JournalAction: string
The action value to be used when the tool is run. It will default to the name of the tool if it is left blank.Example:
Acknowledge
-
JournalActor: string
The actor value to be used when the tool is run. It will default to the UserID of the user running the tool if it is left blank.Example:
John Doe
-
JournalEntry: string
The text of the journal entry.Example:
Event Acknowledged
-
JournalID: integer
Journal IDExample:
251
-
JournalTimeStamp: string
Timestamp when the journal entry was created.Example:
2022-11-06T11:17:48.000Z
-
JournalUsername: string
Name of the user that created the journal entry.Example:
admin
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.