Back

PUT comments/{id}?tz={tz}

Update a Comment.

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
id globally unique identifier Required

Guid ID of the comment to be updated.
tz string

Optional parameter to set time zone information.

Body Parameters (Comment)

This object takes all the parameters needed to update a comment.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the given comment.
AncestorID globally unique identifier Required on Create

Ancestor of the given comment.
Post string Required

Contents of the given comment.
UserID globally unique identifier ReadOnly

ID of the user that posted the given comment.
PostDate date ReadOnly

Date the given comment was created.
SiteID globally unique identifier ReadOnly

ID of the site for the given comment.
IndividualFullName string ReadOnly

Full name of the individual that created the given comment.
IndividualID globally unique identifier ReadOnly

ID of the individual that created the given comment.
UserName string ReadOnly

User name of the individual that created the given comment.

Request Formats

application/xml, text/xml

Sample
<Comment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>b314af99-b54a-4595-b2e3-c87ce9d6427a</ID>
  <AncestorID>fc30cbde-7b7a-45db-94e0-3c7ee8071a3b</AncestorID>
  <UserID>1c3cdb7d-c2fe-4317-a92c-c3d2364300c5</UserID>
  <Post>sample string 1</Post>
  <PostDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-10-01T11:29:56.9013462Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </PostDate>
  <SiteID>f566f6ac-704c-4345-abf8-4e1722bb84c0</SiteID>
  <IndividualFullName>sample string 2</IndividualFullName>
  <IndividualID>b63f82da-5ba6-43a4-8441-ef020edb4ed2</IndividualID>
  <UserName>sample string 3</UserName>
</Comment>

application/json, text/json

Sample
{
  "ID": "b314af99-b54a-4595-b2e3-c87ce9d6427a",
  "AncestorID": "fc30cbde-7b7a-45db-94e0-3c7ee8071a3b",
  "UserID": "1c3cdb7d-c2fe-4317-a92c-c3d2364300c5",
  "Post": "sample string 1",
  "PostDate": "2025-10-01T11:29:56.9013462+00:00",
  "SiteID": "f566f6ac-704c-4345-abf8-4e1722bb84c0",
  "IndividualFullName": "sample string 2",
  "IndividualID": "b63f82da-5ba6-43a4-8441-ef020edb4ed2",
  "UserName": "sample string 3"
}

Response Information

Resource Description (Comment)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the given comment.
AncestorID globally unique identifier Required on Create

Ancestor of the given comment.
Post string Required

Contents of the given comment.
UserID globally unique identifier ReadOnly

ID of the user that posted the given comment.
PostDate date ReadOnly

Date the given comment was created.
SiteID globally unique identifier ReadOnly

ID of the site for the given comment.
IndividualFullName string ReadOnly

Full name of the individual that created the given comment.
IndividualID globally unique identifier ReadOnly

ID of the individual that created the given comment.
UserName string ReadOnly

User name of the individual that created the given comment.

Response Formats

application/xml, text/xml

Sample
<Comment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>ddb32dab-9421-40d4-bf95-462d26e738c6</ID>
  <AncestorID>20a3f8cd-a5c3-48a1-9289-cfdd0f8a12bf</AncestorID>
  <UserID>db8cf2b4-892f-4884-aa0d-c273b78b7c32</UserID>
  <Post>sample string 1</Post>
  <PostDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-10-01T11:29:56.9776555Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </PostDate>
  <SiteID>0a6a57c9-bd77-4055-85d9-e96de1dc6197</SiteID>
  <IndividualFullName>sample string 2</IndividualFullName>
  <IndividualID>c8d5d0f8-3cd9-4bb2-a9ae-3725dc0f15cc</IndividualID>
  <UserName>sample string 3</UserName>
</Comment>

application/json, text/json

Sample
{
  "ID": "ddb32dab-9421-40d4-bf95-462d26e738c6",
  "AncestorID": "20a3f8cd-a5c3-48a1-9289-cfdd0f8a12bf",
  "UserID": "db8cf2b4-892f-4884-aa0d-c273b78b7c32",
  "Post": "sample string 1",
  "PostDate": "2025-10-01T11:29:56.9776555+00:00",
  "SiteID": "0a6a57c9-bd77-4055-85d9-e96de1dc6197",
  "IndividualFullName": "sample string 2",
  "IndividualID": "c8d5d0f8-3cd9-4bb2-a9ae-3725dc0f15cc",
  "UserName": "sample string 3"
}