GET api/v2.0/Discussions/GetRecentThreads?discussionKey={discussionKey}&maxToRetrieve={maxToRetrieve}

Retrieves Discussion Thread details. The Threads are returned in descending order of the Last Approval Date for Posts within each Thread. So, Threads with more recent activity will be returned first in the list.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
discussionKey

Optional. Unique Identifier of a Discussion. If provided, the Thread results will be filtered to only include those that pertain to the specified Discussion.

 globally unique identifier

None.
maxToRetrieve

Maximum Discussion Threads to return. Defaults to 5, if not specified.

 integer

Default value is 5

Body Parameters

None.

Response Information

Resource Description

Collection of DiscussionThread
NameDescriptionTypeAdditional information
MessageCount

Number of messages in the thread.

 integer

None.
DiscussionThreadKey

Unique identifier for the Discussion Thread.

 globally unique identifier

None.
Subject

Subject text for the Discussion Thread.

 string

None.
LastPostDate

UTC DateTime of the Last Post to this Discussion Thread.

 date

None.
LinkToViewThread

URL to the Thread in the Community Site.

 string

None.
LastPostAuthor

Contact Detail for the Author of the Last Discussion Post to this Discussion Thread.

 ContactConcise

None.
DiscussionKey

UniqueIdentifier of the Discussion to which this Thread belongs.

 globally unique identifier

None.
CommunityName

Name of the Community this Discussion Thread belongs to.

 string

None.
CommunityKey

Unique Identifier for the Community this Discussion Thread belongs to.

 globally unique identifier

None.
IsFollowing

True if the user is currently following the item

 boolean

None.
UserPermissions

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

 Collection of string

None.

Response Formats

application/json, text/json

Sample: 
[
  {
    "MessageCount": 1,
    "DiscussionThreadKey": "2559162d-1631-4583-92b7-d1572a7ff6fa",
    "Subject": "sample string 3",
    "LastPostDate": "2024-12-26T13:03:13.1526255Z",
    "LinkToViewThread": "sample string 5",
    "LastPostAuthor": {
      "LinkToProfile": "sample string 1",
      "PictureUrl": "sample string 2",
      "ContactKey": "53008f1f-5c86-4028-b43a-fd369be499b3",
      "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-12-26T13:03:13.1526255Z",
      "UpdatedByContactKey": "86c410b6-de48-465c-8db5-df2c6945844d",
      "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-12-26T13:03:13.1526255Z"
    },
    "DiscussionKey": "e9463061-f9ee-4a03-ae4e-a97bcdeb5a10",
    "CommunityName": "sample string 7",
    "CommunityKey": "23ab68fa-4224-4e0a-aa66-13a2d9324686",
    "IsFollowing": true,
    "UserPermissions": [
      "sample string 1",
      "sample string 2"
    ]
  },
  {
    "MessageCount": 1,
    "DiscussionThreadKey": "2559162d-1631-4583-92b7-d1572a7ff6fa",
    "Subject": "sample string 3",
    "LastPostDate": "2024-12-26T13:03:13.1526255Z",
    "LinkToViewThread": "sample string 5",
    "LastPostAuthor": {
      "LinkToProfile": "sample string 1",
      "PictureUrl": "sample string 2",
      "ContactKey": "53008f1f-5c86-4028-b43a-fd369be499b3",
      "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-12-26T13:03:13.1526255Z",
      "UpdatedByContactKey": "86c410b6-de48-465c-8db5-df2c6945844d",
      "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-12-26T13:03:13.1526255Z"
    },
    "DiscussionKey": "e9463061-f9ee-4a03-ae4e-a97bcdeb5a10",
    "CommunityName": "sample string 7",
    "CommunityKey": "23ab68fa-4224-4e0a-aa66-13a2d9324686",
    "IsFollowing": true,
    "UserPermissions": [
      "sample string 1",
      "sample string 2"
    ]
  }
]

application/xml, text/xml

Sample: 
<ArrayOfDiscussionThread xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Discussions">
  <DiscussionThread>
    <CommunityKey>23ab68fa-4224-4e0a-aa66-13a2d9324686</CommunityKey>
    <DiscussionThreadKey>2559162d-1631-4583-92b7-d1572a7ff6fa</DiscussionThreadKey>
    <IsFollowing>true</IsFollowing>
    <LastPostAuthor xmlns:d3p1="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
      <d3p1:AMSDirectoryOptOut>true</d3p1:AMSDirectoryOptOut>
      <d3p1:AgreedToTermsDateTime>2024-12-26T08:03:13.1526255-05:00</d3p1:AgreedToTermsDateTime>
      <d3p1:CompanyLegacyContactKey>sample string 20</d3p1:CompanyLegacyContactKey>
      <d3p1:CompanyName>sample string 12</d3p1:CompanyName>
      <d3p1:CompanyTitle>sample string 13</d3p1:CompanyTitle>
      <d3p1:ContactKey>53008f1f-5c86-4028-b43a-fd369be499b3</d3p1:ContactKey>
      <d3p1:ContactStatusCode>sample string 8</d3p1:ContactStatusCode>
      <d3p1:Designation>sample string 15</d3p1:Designation>
      <d3p1:DisplayName>sample string 6</d3p1:DisplayName>
      <d3p1:EmailAddress>sample string 7</d3p1:EmailAddress>
      <d3p1:FirstName>sample string 4</d3p1:FirstName>
      <d3p1:HLContactMeOptOut>true</d3p1:HLContactMeOptOut>
      <d3p1:HLDirectoryOptOut>true</d3p1:HLDirectoryOptOut>
      <d3p1:InformalName>sample string 17</d3p1:InformalName>
      <d3p1:IsCompany>true</d3p1:IsCompany>
      <d3p1:LargePictureUrl>sample string 24</d3p1:LargePictureUrl>
      <d3p1:LastName>sample string 5</d3p1:LastName>
      <d3p1:LegacyContactKey>sample string 16</d3p1:LegacyContactKey>
      <d3p1:LinkToProfile>sample string 1</d3p1:LinkToProfile>
      <d3p1:MiddleName>sample string 18</d3p1:MiddleName>
      <d3p1:PictureUrl>sample string 2</d3p1:PictureUrl>
      <d3p1:PrefixCode>sample string 9</d3p1:PrefixCode>
      <d3p1:SuffixCode>sample string 14</d3p1:SuffixCode>
      <d3p1:UpdatedByContactKey>86c410b6-de48-465c-8db5-df2c6945844d</d3p1:UpdatedByContactKey>
      <d3p1:UpdatedOn>2024-12-26T08:03:13.1526255-05:00</d3p1:UpdatedOn>
    </LastPostAuthor>
    <LastPostDate>2024-12-26T08:03:13.1526255-05:00</LastPostDate>
    <LinkToViewThread>sample string 5</LinkToViewThread>
    <MessageCount>1</MessageCount>
    <Subject>sample string 3</Subject>
    <UserPermissions xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </UserPermissions>
  </DiscussionThread>
  <DiscussionThread>
    <CommunityKey>23ab68fa-4224-4e0a-aa66-13a2d9324686</CommunityKey>
    <DiscussionThreadKey>2559162d-1631-4583-92b7-d1572a7ff6fa</DiscussionThreadKey>
    <IsFollowing>true</IsFollowing>
    <LastPostAuthor xmlns:d3p1="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
      <d3p1:AMSDirectoryOptOut>true</d3p1:AMSDirectoryOptOut>
      <d3p1:AgreedToTermsDateTime>2024-12-26T08:03:13.1526255-05:00</d3p1:AgreedToTermsDateTime>
      <d3p1:CompanyLegacyContactKey>sample string 20</d3p1:CompanyLegacyContactKey>
      <d3p1:CompanyName>sample string 12</d3p1:CompanyName>
      <d3p1:CompanyTitle>sample string 13</d3p1:CompanyTitle>
      <d3p1:ContactKey>53008f1f-5c86-4028-b43a-fd369be499b3</d3p1:ContactKey>
      <d3p1:ContactStatusCode>sample string 8</d3p1:ContactStatusCode>
      <d3p1:Designation>sample string 15</d3p1:Designation>
      <d3p1:DisplayName>sample string 6</d3p1:DisplayName>
      <d3p1:EmailAddress>sample string 7</d3p1:EmailAddress>
      <d3p1:FirstName>sample string 4</d3p1:FirstName>
      <d3p1:HLContactMeOptOut>true</d3p1:HLContactMeOptOut>
      <d3p1:HLDirectoryOptOut>true</d3p1:HLDirectoryOptOut>
      <d3p1:InformalName>sample string 17</d3p1:InformalName>
      <d3p1:IsCompany>true</d3p1:IsCompany>
      <d3p1:LargePictureUrl>sample string 24</d3p1:LargePictureUrl>
      <d3p1:LastName>sample string 5</d3p1:LastName>
      <d3p1:LegacyContactKey>sample string 16</d3p1:LegacyContactKey>
      <d3p1:LinkToProfile>sample string 1</d3p1:LinkToProfile>
      <d3p1:MiddleName>sample string 18</d3p1:MiddleName>
      <d3p1:PictureUrl>sample string 2</d3p1:PictureUrl>
      <d3p1:PrefixCode>sample string 9</d3p1:PrefixCode>
      <d3p1:SuffixCode>sample string 14</d3p1:SuffixCode>
      <d3p1:UpdatedByContactKey>86c410b6-de48-465c-8db5-df2c6945844d</d3p1:UpdatedByContactKey>
      <d3p1:UpdatedOn>2024-12-26T08:03:13.1526255-05:00</d3p1:UpdatedOn>
    </LastPostAuthor>
    <LastPostDate>2024-12-26T08:03:13.1526255-05:00</LastPostDate>
    <LinkToViewThread>sample string 5</LinkToViewThread>
    <MessageCount>1</MessageCount>
    <Subject>sample string 3</Subject>
    <UserPermissions xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </UserPermissions>
  </DiscussionThread>
</ArrayOfDiscussionThread>