POST api/v2.0/ResourceLibrary/AddComment?documentKey={documentKey}
Add a new Comment to a Document.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
documentKey |
Key of the Document being commented on. |
globally unique identifier |
Required |
Body Parameters
CommentRequestName | Description | Type | Additional information |
---|---|---|---|
CommentBody | string |
None. |
Request Formats
application/json, text/json
Sample:
{ "CommentBody": "sample string 1" }
application/xml, text/xml
Sample:
<CommentRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Request"> <CommentBody>sample string 1</CommentBody> </CommentRequest>
Response Information
Resource Description
True if successful.
CommentName | Description | Type | Additional information |
---|---|---|---|
CommentKey |
The unique identifier for the comment |
globally unique identifier |
None. |
CommentBody |
The text body of the comment |
string |
None. |
CommentAuthor |
Metadata pertaining to the user who created the comment |
ContactConcise |
None. |
IsOfficial |
A single comment for an item can be marked as the official comment, and is generally displayed as the top comment/pinned. |
boolean |
None. |
ItemKey |
The unique identifier for the comment's parent content item |
globally unique identifier |
None. |
CreatedOn |
The date that the comment was created |
date |
None. |
UpdatedOn |
The date that the comment was last updated |
date |
None. |
Response Formats
application/json, text/json
Sample:
{ "CommentKey": "64fdd640-982b-4ee1-85e9-36499b5f8adf", "CommentBody": "sample string 2", "CommentAuthor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "c2fd19f8-b7b9-4cef-801b-f75445101630", "FirstName": "sample string 4", "LastName": "sample string 5", "DisplayName": "sample string 6", "EmailAddress": "sample string 7", "ContactStatusCode": "sample string 8", "PrefixCode": "sample string 9", "UpdatedOn": "2024-11-02T17:23:56.5964118Z", "UpdatedByContactKey": "a9a40638-a4a5-41c9-b501-0e2399fd8950", "CompanyName": "sample string 12", "CompanyTitle": "sample string 13", "SuffixCode": "sample string 14", "Designation": "sample string 15", "LegacyContactKey": "sample string 16", "InformalName": "sample string 17", "MiddleName": "sample string 18", "IsCompany": true, "CompanyLegacyContactKey": "sample string 20", "AMSDirectoryOptOut": true, "HLDirectoryOptOut": true, "HLContactMeOptOut": true, "LargePictureUrl": "sample string 24", "AgreedToTermsDateTime": "2024-11-02T17:23:56.5964118Z" }, "IsOfficial": true, "ItemKey": "e6f081e1-081a-4868-8818-62199d6b3863", "CreatedOn": "2024-11-02T17:23:56.5964118Z", "UpdatedOn": "2024-11-02T17:23:56.5964118Z" }
application/xml, text/xml
Sample:
<Comment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise"> <CommentAuthor> <AMSDirectoryOptOut>true</AMSDirectoryOptOut> <AgreedToTermsDateTime>2024-11-02T13:23:56.5964118-04:00</AgreedToTermsDateTime> <CompanyLegacyContactKey>sample string 20</CompanyLegacyContactKey> <CompanyName>sample string 12</CompanyName> <CompanyTitle>sample string 13</CompanyTitle> <ContactKey>c2fd19f8-b7b9-4cef-801b-f75445101630</ContactKey> <ContactStatusCode>sample string 8</ContactStatusCode> <Designation>sample string 15</Designation> <DisplayName>sample string 6</DisplayName> <EmailAddress>sample string 7</EmailAddress> <FirstName>sample string 4</FirstName> <HLContactMeOptOut>true</HLContactMeOptOut> <HLDirectoryOptOut>true</HLDirectoryOptOut> <InformalName>sample string 17</InformalName> <IsCompany>true</IsCompany> <LargePictureUrl>sample string 24</LargePictureUrl> <LastName>sample string 5</LastName> <LegacyContactKey>sample string 16</LegacyContactKey> <LinkToProfile>sample string 1</LinkToProfile> <MiddleName>sample string 18</MiddleName> <PictureUrl>sample string 2</PictureUrl> <PrefixCode>sample string 9</PrefixCode> <SuffixCode>sample string 14</SuffixCode> <UpdatedByContactKey>a9a40638-a4a5-41c9-b501-0e2399fd8950</UpdatedByContactKey> <UpdatedOn>2024-11-02T13:23:56.5964118-04:00</UpdatedOn> </CommentAuthor> <CommentBody>sample string 2</CommentBody> <CommentKey>64fdd640-982b-4ee1-85e9-36499b5f8adf</CommentKey> <CreatedOn>2024-11-02T13:23:56.5964118-04:00</CreatedOn> <IsOfficial>true</IsOfficial> <ItemKey>e6f081e1-081a-4868-8818-62199d6b3863</ItemKey> <UpdatedOn>2024-11-02T13:23:56.5964118-04:00</UpdatedOn> </Comment>