POST api/v2.0/Answer/Recommend?answerKey={answerKey}

Acts as a toggle for recommending an answer. A POST request will recommend while DELETE will remove the recommendation. An answer recommendation refers to the answer being "Helpful" in a Q and A thread.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
answerKey

unique identifier for the Answer to recommend/un-recommend

globally unique identifier

Required

Body Parameters

None.

Response Information

Resource Description

The answer for which the requester’s recommendation was added or removed

Answer
NameDescriptionTypeAdditional information
AnswerKey

Unique identifier of the answer.

globally unique identifier

None.

ParentKey

Unique identifier of the answer's parent question.

globally unique identifier

None.

IsBestAnswer

True if this answer has been designated as best answer for the root question. False if this answer has not been designated as best answer for the root question.

boolean

None.

BestAnswerOn

DateTime in UTC when this answer had been designated as best answer for the root question. Omitted when this answer has not been designated as best answer.

date

None.

Content

HTML Body of the item

string

None.

PublishedOn

DateTime in UTC when the item was published

date

None.

Community

Community to which the item was published

Community

None.

Author

Author to which the item should be attributed

ContactConcise

None.

Attachments

Attachments included with this item.

Collection of DocumentAttachment

None.

IsAnonymous

True if author attribution is to indicate item was submitted anonymously, False if the author attribution indicates who authored the item. Omitted when item is attributed to its author.

boolean

None.

Creator

When item is posted anonymously, indicates the actual author of the item. Omitted when item is attributed to its author.

ContactConcise

None.

EditedOn

DateTime in UTC when the item was last edited. Omitted if item has not been edited.

date

None.

EditedBy

Indicates contact that last edited this item. Omitted if item has not been edited.

ContactConcise

None.

IsModerated

Indicates whether the item is currently moderated. Omitted when the item is not in moderation.

boolean

None.

RecommendationCount

Number of contacts who have recommended this item.

integer

None.

HasRecommended

If the current contact has recommended this item

boolean

None.

Tags

All of the tags indexed for the item. This includes user tags and admin based tags.

Collection of ItemTagResponse

None.

UserPermissions

Permissions for actions the current user can take on the item.

Collection of string

None.

Response Formats

application/json, text/json

Sample:
{
  "AnswerKey": "b4bcb706-c3ce-49cf-86af-a66eedfa3202",
  "ParentKey": "74375d15-562e-4466-90e1-b20b5acd447a",
  "IsBestAnswer": true,
  "BestAnswerOn": "2024-03-28T04:56:12.0292542Z",
  "Content": "sample string 5",
  "PublishedOn": "2024-03-28T04:56:12.0292542Z",
  "Community": null,
  "Author": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "6b7c6fbb-e79c-4e3e-9756-b3a1ba166a89",
    "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-03-28T04:56:12.0292542Z",
    "UpdatedByContactKey": "c3704ef6-d7f1-4da4-a9aa-d2815889bb15",
    "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-03-28T04:56:12.0292542Z"
  },
  "Attachments": [
    {
      "DocumentAttachmentKey": "89379153-e3d6-4ed1-9e4b-4b046fc5365f",
      "DocumentKey": "dcac3001-6166-4e8f-9e86-6f26ce02f0c7",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "6b7c6fbb-e79c-4e3e-9756-b3a1ba166a89",
        "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-03-28T04:56:12.0292542Z",
        "UpdatedByContactKey": "c3704ef6-d7f1-4da4-a9aa-d2815889bb15",
        "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-03-28T04:56:12.0292542Z"
      },
      "CreatedOn": "2024-03-28T04:56:12.0292542Z",
      "FileExtension": "sample string 5",
      "FileSizeInBytes": 1,
      "Width": 1,
      "Height": 1,
      "DurationSeconds": 1,
      "DownloadUrl": "sample string 6",
      "IconUrl": "sample string 7",
      "Status": "sample string 8"
    },
    {
      "DocumentAttachmentKey": "89379153-e3d6-4ed1-9e4b-4b046fc5365f",
      "DocumentKey": "dcac3001-6166-4e8f-9e86-6f26ce02f0c7",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "6b7c6fbb-e79c-4e3e-9756-b3a1ba166a89",
        "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-03-28T04:56:12.0292542Z",
        "UpdatedByContactKey": "c3704ef6-d7f1-4da4-a9aa-d2815889bb15",
        "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-03-28T04:56:12.0292542Z"
      },
      "CreatedOn": "2024-03-28T04:56:12.0292542Z",
      "FileExtension": "sample string 5",
      "FileSizeInBytes": 1,
      "Width": 1,
      "Height": 1,
      "DurationSeconds": 1,
      "DownloadUrl": "sample string 6",
      "IconUrl": "sample string 7",
      "Status": "sample string 8"
    }
  ],
  "IsAnonymous": true,
  "Creator": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "6b7c6fbb-e79c-4e3e-9756-b3a1ba166a89",
    "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-03-28T04:56:12.0292542Z",
    "UpdatedByContactKey": "c3704ef6-d7f1-4da4-a9aa-d2815889bb15",
    "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-03-28T04:56:12.0292542Z"
  },
  "EditedOn": "2024-03-28T04:56:12.0292542Z",
  "EditedBy": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "6b7c6fbb-e79c-4e3e-9756-b3a1ba166a89",
    "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-03-28T04:56:12.0292542Z",
    "UpdatedByContactKey": "c3704ef6-d7f1-4da4-a9aa-d2815889bb15",
    "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-03-28T04:56:12.0292542Z"
  },
  "IsModerated": true,
  "RecommendationCount": 10,
  "HasRecommended": true,
  "Tags": [
    {
      "Tag": "sample string 1",
      "TagType": "sample string 2"
    },
    {
      "Tag": "sample string 1",
      "TagType": "sample string 2"
    }
  ],
  "UserPermissions": [
    "sample string 1",
    "sample string 2"
  ]
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.