Update comment
put
/ec-comment-svc/rest/v1.0/studies/{studyId}/comments/{commentId}
Updates a particular comment/reply - updates either its content or marks it as resolved.
Request
Path Parameters
-
commentId(required): string(uuid)
The object id associated to the comment.
-
studyId(required): string(uuid)
Study ID. Example: F054C951EB74443C93716CA714AB686E.
Supported Media Types
- */*
Root Schema : schema
Type:
Show Source
object
-
dateCreated: string
(date-time)
The timestamp when the message was posted
-
firstName: string
The first name of the person who made the commentExample:
system
-
fullName: string
The localized full name of the person who made the comment
-
id: string
(uuid)
Object Unique GUID
-
isRead: boolean
Was comment read by the user making the requestExample:
true
-
lastName: string
The last name of the person who made the commentExample:
clinicalOne
-
message: string
The comment made by the userExample:
This is a sample comment
-
objectId: string
(uuid)
The GUID of object the comment belongs to
-
objectType: string
The type of object the comment belongs to
-
objectVersionNumber: number
The object version numberExample:
2
-
operationType: string
The operation type
-
origin: string
Where the comment thread was originally startedExample:
DESIGN
-
parentId: string
(uuid)
The GUID of object the reply to this comment, if applicable
-
replies: array
replies
The list of all replies to this comment
-
softwareVersionNumber: number
The software version numberExample:
2
-
status: string
The status of the comment, such as resolved or unresolvedExample:
UNRESOLVED
-
studyId: string
(uuid)
The GUID of the study where this comment belong to
-
tags: object
CommentTagDto
The email notification metadata for users tagged on the comment
-
userId: string
(uuid)
The GUID of the user posting the comment
-
versionEnd: string
(date-time)
The precise version start date
-
versionStart: string
(date-time)
The version start date
Nested Schema : replies
Type:
array
The list of all replies to this comment
Show Source
-
Array of:
object CommentDto
The list of all replies to this comment
Nested Schema : CommentTagDto
Type:
object
The email notification metadata for users tagged on the comment
Show Source
-
commentUrl: string
The url to reply to the message from the email
-
eventTitle: string
The title of the event on which the object commented on is associated withExample:
Demography Visit
-
mainObjectTitle: string
The title of the main object where the comment is made, such as the form name
-
objectRefName: string
The reference name of the object commented onExample:
TEXT_01
-
objectTitle: string
The title of the object commented onExample:
Race
-
studyTitle: string
The study title
-
subjectNumber: string
the subject associated with object commented onExample:
100-01
-
userIds: array
userIds
list of users to send email notification to
Nested Schema : CommentDto
Type:
object
The list of all replies to this comment
Show Source
-
dateCreated: string
(date-time)
The timestamp when the message was posted
-
firstName: string
The first name of the person who made the commentExample:
system
-
fullName: string
The localized full name of the person who made the comment
-
id: string
(uuid)
Object Unique GUID
-
isRead: boolean
Was comment read by the user making the requestExample:
true
-
lastName: string
The last name of the person who made the commentExample:
clinicalOne
-
message: string
The comment made by the userExample:
This is a sample comment
-
objectId: string
(uuid)
The GUID of object the comment belongs to
-
objectType: string
The type of object the comment belongs to
-
objectVersionNumber: number
The object version numberExample:
2
-
operationType: string
The operation type
-
origin: string
Where the comment thread was originally startedExample:
DESIGN
-
parentId: string
(uuid)
The GUID of object the reply to this comment, if applicable
-
softwareVersionNumber: number
The software version numberExample:
2
-
status: string
The status of the comment, such as resolved or unresolvedExample:
UNRESOLVED
-
studyId: string
(uuid)
The GUID of the study where this comment belong to
-
tags: object
CommentTagDto
The email notification metadata for users tagged on the comment
-
userId: string
(uuid)
The GUID of the user posting the comment
-
versionEnd: string
(date-time)
The precise version start date
-
versionStart: string
(date-time)
The version start date
Nested Schema : userIds
Type:
array
list of users to send email notification to
Show Source
-
Array of:
string(uuid)
list of users to send email notification to
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : CommentDto
Type:
object
The list of all replies to this comment
Show Source
-
dateCreated: string
(date-time)
The timestamp when the message was posted
-
firstName: string
The first name of the person who made the commentExample:
system
-
fullName: string
The localized full name of the person who made the comment
-
id: string
(uuid)
Object Unique GUID
-
isRead: boolean
Was comment read by the user making the requestExample:
true
-
lastName: string
The last name of the person who made the commentExample:
clinicalOne
-
message: string
The comment made by the userExample:
This is a sample comment
-
objectId: string
(uuid)
The GUID of object the comment belongs to
-
objectType: string
The type of object the comment belongs to
-
objectVersionNumber: number
The object version numberExample:
2
-
operationType: string
The operation type
-
origin: string
Where the comment thread was originally startedExample:
DESIGN
-
parentId: string
(uuid)
The GUID of object the reply to this comment, if applicable
-
softwareVersionNumber: number
The software version numberExample:
2
-
status: string
The status of the comment, such as resolved or unresolvedExample:
UNRESOLVED
-
studyId: string
(uuid)
The GUID of the study where this comment belong to
-
tags: object
CommentTagDto
The email notification metadata for users tagged on the comment
-
userId: string
(uuid)
The GUID of the user posting the comment
-
versionEnd: string
(date-time)
The precise version start date
-
versionStart: string
(date-time)
The version start date
Nested Schema : CommentTagDto
Type:
object
The email notification metadata for users tagged on the comment
Show Source
-
commentUrl: string
The url to reply to the message from the email
-
eventTitle: string
The title of the event on which the object commented on is associated withExample:
Demography Visit
-
mainObjectTitle: string
The title of the main object where the comment is made, such as the form name
-
objectRefName: string
The reference name of the object commented onExample:
TEXT_01
-
objectTitle: string
The title of the object commented onExample:
Race
-
studyTitle: string
The study title
-
subjectNumber: string
the subject associated with object commented onExample:
100-01
-
userIds: array
userIds
list of users to send email notification to
Nested Schema : userIds
Type:
array
list of users to send email notification to
Show Source
-
Array of:
string(uuid)
list of users to send email notification to
500 Response
Error
Nested Schema : details
Type:
object