POST api/v2.0/Discussions/SubmitDiscussionPost

Submit a new DiscussionPost to a Discussion.

Request Information

URI Parameters

None.

Body Parameters

Set of properties describing the Discussion to Post to, the Subject, and the Body of the DiscussionPost.

PostDiscussionMessageRequest
NameDescriptionTypeAdditional information
DiscussionKey

Unique Key of the Discussion to Post to. A discussion and community have a one to one relationship, so either this or the CommunityKey must be provided when posting a discussion message. Both are not needed.

 globally unique identifier

None.
CommunityKey

Unique Key of the Community to Post to. A discussion and community have a one to one relationship, so either this or the DiscussionKey must be provided when posting a discussion message. Both are not needed.

 globally unique identifier

None.
DocumentKey

Unique Key of Document to attach to the Discussion Post. This field is optional.

 globally unique identifier

None.
TopicTagKeys

List of unique keys of Topic tags to apply to Post. Topic tag keys only apply when posting to a topic community and are omitted when posting to a non-topic community. If required, the keys must be valid topic tag keys of the community that you are posting to, and can be found in the Community model for the community that you are posting to.

 Collection of globally unique identifier

None.
Subject

Subject of the Discussion Post.

 string

Required

Max length: 255
Body

Body of the Discussion Post.

 string

Required

Request Formats

application/json, text/json

Sample: 
{
  "DiscussionKey": "86b482a2-587c-49dc-a709-a473147beba0",
  "CommunityKey": "b9bba655-ed17-459f-8f22-5cb39c9e5cc3",
  "DocumentKey": "995f713d-457b-47ee-9cf7-4a183bf8485a",
  "TopicTagKeys": [
    "2e9c41ae-25df-4cc4-9319-b3fc9ed12567",
    "2397afc6-8ba2-4a41-9bba-a016dca3d824"
  ],
  "Subject": "sample string 1",
  "Body": "sample string 2"
}

application/xml, text/xml

Sample: 
<PostDiscussionMessageRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Request">
  <Body>sample string 2</Body>
  <CommunityKey>b9bba655-ed17-459f-8f22-5cb39c9e5cc3</CommunityKey>
  <DiscussionKey>86b482a2-587c-49dc-a709-a473147beba0</DiscussionKey>
  <DocumentKey>995f713d-457b-47ee-9cf7-4a183bf8485a</DocumentKey>
  <Subject>sample string 1</Subject>
  <TopicTagKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>2e9c41ae-25df-4cc4-9319-b3fc9ed12567</d2p1:guid>
    <d2p1:guid>2397afc6-8ba2-4a41-9bba-a016dca3d824</d2p1:guid>
  </TopicTagKeys>
</PostDiscussionMessageRequest>

Response Information

Resource Description

True if successful, False if not.

Collection of boolean

Response Formats

application/json, text/json

Sample: 
[
  true,
  true
]

application/xml, text/xml

Sample: 
<ArrayOfboolean xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
  <boolean>true</boolean>
  <boolean>true</boolean>
</ArrayOfboolean>