POST api/v2.0/Question/Post

Submit a new question

Request Information

URI Parameters

None.

Body Parameters

New question to submit

Name	Description	Type	Additional information
Title	The subject/title of the question	string	Required
Content	The body/description of the question	string	Required
ContainerKey	The communityKey that the question should be contained in	globally unique identifier	None.
DocumentKey	The document key of the resource library entry containing files to attach to this question. This field is optional.	globally unique identifier	None.
IsAnonymous	Whether or not you want to post the question as an anonymous user	boolean	None.
TopicTagKeys	If the community that the question is being asked in is a topic community, then pass one or more valid Topic tags to apply to the question. You can get the set of valid tag keys from the Community Model TopicTagGroups property.	Collection of globally unique identifier	None.

Request Formats

application/json, text/json

Sample:

{
  "Title": "sample string 1",
  "Content": "sample string 2",
  "ContainerKey": "74abbcf8-b6f8-4640-843d-a841236f00eb",
  "DocumentKey": "5aa9d2f5-4cc9-4d43-a2e5-5886f2d80967",
  "IsAnonymous": true,
  "TopicTagKeys": [
    "f06d5b1b-30d2-4e06-8e50-c83b508ae459",
    "3bc0f8ab-870e-4908-8bd3-6cd81348ebd3"
  ]
}

application/xml, text/xml

Sample:

<NewQuestionRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Request">
  <_x003C_ContainerKey_x003E_k__BackingField>74abbcf8-b6f8-4640-843d-a841236f00eb</_x003C_ContainerKey_x003E_k__BackingField>
  <_x003C_Content_x003E_k__BackingField>sample string 2</_x003C_Content_x003E_k__BackingField>
  <_x003C_DocumentKey_x003E_k__BackingField>5aa9d2f5-4cc9-4d43-a2e5-5886f2d80967</_x003C_DocumentKey_x003E_k__BackingField>
  <_x003C_IsAnonymous_x003E_k__BackingField>true</_x003C_IsAnonymous_x003E_k__BackingField>
  <_x003C_Title_x003E_k__BackingField>sample string 1</_x003C_Title_x003E_k__BackingField>
  <_x003C_TopicTagKeys_x003E_k__BackingField xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>f06d5b1b-30d2-4e06-8e50-c83b508ae459</d2p1:guid>
    <d2p1:guid>3bc0f8ab-870e-4908-8bd3-6cd81348ebd3</d2p1:guid>
  </_x003C_TopicTagKeys_x003E_k__BackingField>
</NewQuestionRequest>

Response Information

Resource Description

Submitted question

Question

Name	Description	Type	Additional 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": "e1f9d556-859a-4ce2-96ce-2428344818c1",
  "Title": "sample string 2",
  "HasBestAnswer": true,
  "HasReplied": true,
  "BestAnswerOn": "2025-01-15T07:38:54.139903Z",
  "IsThreadClosed": true,
  "ThreadClosedOn": "2025-01-15T07:38:54.139903Z",
  "ThreadClosedBy": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "434822cc-7878-4713-9750-b45a77674d9b",
    "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": "2025-01-15T07:38:54.139903Z",
    "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
    "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": "2025-01-15T07:38:54.139903Z"
  },
  "IsFollowing": true,
  "Content": "sample string 9",
  "PublishedOn": "2025-01-15T07:38:54.139903Z",
  "Community": null,
  "Author": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "434822cc-7878-4713-9750-b45a77674d9b",
    "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": "2025-01-15T07:38:54.139903Z",
    "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
    "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": "2025-01-15T07:38:54.139903Z"
  },
  "Attachments": [
    {
      "DocumentAttachmentKey": "1cf678b3-21a6-4056-a1e6-665367846269",
      "DocumentKey": "c4b5b42b-8544-4026-be89-def3ce23e8e6",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "434822cc-7878-4713-9750-b45a77674d9b",
        "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": "2025-01-15T07:38:54.139903Z",
        "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
        "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": "2025-01-15T07:38:54.139903Z"
      },
      "CreatedOn": "2025-01-15T07:38:54.139903Z",
      "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": "1cf678b3-21a6-4056-a1e6-665367846269",
      "DocumentKey": "c4b5b42b-8544-4026-be89-def3ce23e8e6",
      "FileName": "sample string 3",
      "UploadedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "434822cc-7878-4713-9750-b45a77674d9b",
        "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": "2025-01-15T07:38:54.139903Z",
        "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
        "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": "2025-01-15T07:38:54.139903Z"
      },
      "CreatedOn": "2025-01-15T07:38:54.139903Z",
      "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": "434822cc-7878-4713-9750-b45a77674d9b",
    "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": "2025-01-15T07:38:54.139903Z",
    "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
    "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": "2025-01-15T07:38:54.139903Z"
  },
  "EditedOn": "2025-01-15T07:38:54.139903Z",
  "EditedBy": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "434822cc-7878-4713-9750-b45a77674d9b",
    "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": "2025-01-15T07:38:54.139903Z",
    "UpdatedByContactKey": "ebe3323f-e736-4b8a-93ce-4ea96cbb8a64",
    "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": "2025-01-15T07:38:54.139903Z"
  },
  "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.