Back

POST comments?tz={tz}

Create a new comment.

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
tz string

Optional parameter to set time zone information.

Body Parameters (Comment)

This object takes all the parameters needed to create a new 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>2f33d090-cc2e-463a-8550-2e5f010a8054</ID>
  <AncestorID>d593e7ae-101c-4e77-875b-2d2f7e75c3c5</AncestorID>
  <Post>sample string 1</Post>
</Comment>

application/json, text/json

Sample
{
  "ID": "2f33d090-cc2e-463a-8550-2e5f010a8054",
  "AncestorID": "d593e7ae-101c-4e77-875b-2d2f7e75c3c5",
  "Post": "sample string 1"
}

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>9579f19b-751d-4444-8ace-f0ef2d7db4e3</ID>
  <AncestorID>b30ec7f9-201d-473d-aa8f-2c4a1a5b576e</AncestorID>
  <UserID>19e9fca2-6c17-464b-9d36-2c5240a52285</UserID>
  <Post>sample string 1</Post>
  <PostDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-08-26T23:47:24.583422Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </PostDate>
  <SiteID>aa2e8eaf-e9df-4ad6-aa43-3b917d5fbfdb</SiteID>
  <IndividualFullName>sample string 2</IndividualFullName>
  <IndividualID>a6cf294a-d511-4efd-bb18-1dd9064933d4</IndividualID>
  <UserName>sample string 3</UserName>
</Comment>

application/json, text/json

Sample
{
  "ID": "9579f19b-751d-4444-8ace-f0ef2d7db4e3",
  "AncestorID": "b30ec7f9-201d-473d-aa8f-2c4a1a5b576e",
  "UserID": "19e9fca2-6c17-464b-9d36-2c5240a52285",
  "Post": "sample string 1",
  "PostDate": "2026-08-26T23:47:24.583422+00:00",
  "SiteID": "aa2e8eaf-e9df-4ad6-aa43-3b917d5fbfdb",
  "IndividualFullName": "sample string 2",
  "IndividualID": "a6cf294a-d511-4efd-bb18-1dd9064933d4",
  "UserName": "sample string 3"
}