Back

GET metrics/{ancestorid}/comments?tz={tz}

Read all comments for a given ancestor ID.

Request Information

URI Parameters

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

Guid ID for departments, individuals, metrics, organizations, projects, or tasks
tz string

Optional parameter to set time zone information.

Body Parameters

None.

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>b7f7271f-5b08-416c-937f-6a0a97219da5</ID>
  <AncestorID>1f63ec9e-4422-488e-82e2-c3f9f0d9b0b7</AncestorID>
  <UserID>3ee41724-47c4-4448-a8db-f2d6e5025e49</UserID>
  <Post>sample string 1</Post>
  <PostDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-10-21T08:54:45.3410019Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </PostDate>
  <SiteID>3ab7c39d-8e03-43fb-a57c-d82d9105892f</SiteID>
  <IndividualFullName>sample string 2</IndividualFullName>
  <IndividualID>7dc02512-52a8-421b-927a-d1e6d39f45c7</IndividualID>
  <UserName>sample string 3</UserName>
</Comment>

application/json, text/json

Sample
{
  "ID": "b7f7271f-5b08-416c-937f-6a0a97219da5",
  "AncestorID": "1f63ec9e-4422-488e-82e2-c3f9f0d9b0b7",
  "UserID": "3ee41724-47c4-4448-a8db-f2d6e5025e49",
  "Post": "sample string 1",
  "PostDate": "2025-10-21T08:54:45.3410019+00:00",
  "SiteID": "3ab7c39d-8e03-43fb-a57c-d82d9105892f",
  "IndividualFullName": "sample string 2",
  "IndividualID": "7dc02512-52a8-421b-927a-d1e6d39f45c7",
  "UserName": "sample string 3"
}