POST api/v2.0/Question/Recommend?questionKey={questionKey}

Acts as a toggle for recommending a question. A POST request will recommend while DELETE will remove the recommendation. A question recommendation refers to "I have this question too" listed under a question in a Q&A thread.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
questionKey

unique identifier for the Question to recommend/un-recommend

globally unique identifier

Required

Body Parameters

None.

Response Information

Resource Description

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

Question
NameDescriptionTypeAdditional information
QuestionKey

Unique identifier of the question

globally unique identifier

None.

Title

Plaintext Title of the question

string

None.

HasBestAnswer

True if a best answer has been designated for this question. False if no best answer has been designated for this question.

boolean

None.

HasReplied

True if the current user has created an answer to the question.

boolean

None.

BestAnswerOn

DateTime in UTC when best answer for this question was designated. Omitted when no best answer has been designated.

date

None.

IsThreadClosed

True if thread is closed and any subsequent answers submitted are rejected. False if thread is available to receive answers.

boolean

None.

ThreadClosedOn

DateTime in UTC when thread was closed to any further submitted answers. Omitted when thread is open.

date

None.

ThreadClosedBy

DateTime in UTC when this thread was closed to any further submitted answers. Omitted when thread is open.

ContactConcise

None.

IsFollowing

Indicates whether the current user is following the question thread.

boolean

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:
{
  "QuestionKey": "b04de7f6-930a-465f-9daf-282454ff92c8",
  "Title": "sample string 2",
  "HasBestAnswer": true,
  "HasReplied": true,
  "BestAnswerOn": "2024-03-28T09:30:18.3393788Z",
  "IsThreadClosed": true,
  "ThreadClosedOn": "2024-03-28T09:30:18.3393788Z",
  "ThreadClosedBy": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
    "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-28T09:30:18.3393788Z",
    "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
    "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-28T09:30:18.3393788Z"
  },
  "IsFollowing": true,
  "Content": "sample string 9",
  "PublishedOn": "2024-03-28T09:30:18.3393788Z",
  "Community": null,
  "Author": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
    "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-28T09:30:18.3393788Z",
    "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
    "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-28T09:30:18.3393788Z"
  },
  "Attachments": [
    {
      "DocumentAttachmentKey": "85aebff9-d43a-4546-9dee-67c9d4690b90",
      "DocumentKey": "cb971005-5d29-4334-bc50-879e67ed7c46",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
        "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-28T09:30:18.3393788Z",
        "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
        "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-28T09:30:18.3393788Z"
      },
      "CreatedOn": "2024-03-28T09:30:18.3393788Z",
      "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": "85aebff9-d43a-4546-9dee-67c9d4690b90",
      "DocumentKey": "cb971005-5d29-4334-bc50-879e67ed7c46",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
        "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-28T09:30:18.3393788Z",
        "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
        "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-28T09:30:18.3393788Z"
      },
      "CreatedOn": "2024-03-28T09:30:18.3393788Z",
      "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": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
    "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-28T09:30:18.3393788Z",
    "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
    "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-28T09:30:18.3393788Z"
  },
  "EditedOn": "2024-03-28T09:30:18.3393788Z",
  "EditedBy": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "509b54ed-1091-4d6e-b63a-3e4d5c7eede8",
    "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-28T09:30:18.3393788Z",
    "UpdatedByContactKey": "0d47b26c-5c73-4335-bf2b-c6eee40b3d34",
    "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-28T09:30:18.3393788Z"
  },
  "IsModerated": true,
  "RecommendationCount": 14,
  "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.