Skip to main content

Add a Note Comment

Add a comment to the dialogue.

Query String Parameters

NameTypeDescriptionRequired
ActionStringCommentSaveRequired
EntityIdIntThis is the Id of the entity you’d like to associate the comment with. This must match the entity type. For example, if you select entity type 1, then the entity id must be a Note Id.Required
EntityTypeIntSet the entity type of the item you want to attach the comment to. Not all entity types can associate a comment. Current valid types are:

1 = Note
2 = Asset Defect
Required
NoteCommentStringAdds text passed as a "Comment", on the entity.Required
CreationDateDateTimeDate time the dialogue was captured - defaults to current timeOptional
UserIdsIntUsed to add users and only works where Mentions is set to True.Optional
PreviousMentionsBoolDefaults to false - if set to true it will add the previous notes mentions.Optional
MentionsBoolDefaults to false. If set to true, it will add the previous mentions (if true) and the UserIds (if populated)Optional
ReactionStringName of reaction to add to the dialogue Optional

Response Codes

CodeMessageInformation
0Response DataSee 'Response' example tab
2Missing or Empty parameter - NoteCommentMandatory parameter was not supplied
2Missing or Invalid parameter - EntityTypeInteger value is invalid or was not specified (when required)
2Invalid parameter - EntityTypeUnrecognized constant value - please verify the supported values
2Missing or Invalid parameter - EntityIdInteger value is invalid or was not specified (when required)
2Invalid parameter - EntityIdUnrecognized constant value - please verify the supported values
2EntityId does not exist in JobWatchThere is no record with this Id
2Invalid Parameter CreationDateTimeDate value is invalid or was not specified (when required)
2There are no users set up in JobWatchNo data returned or set-up in BigChange
2Invalid parameter - ReactionUnrecognized constant value - please verify the supported values

Example

Request URL

?action=CommentSave&NoteComment=Another note comment&EntityType=1&EntityId=24878975