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
Name | Description | Type | Additional 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 DiscussionThreadName | Description | Type | Additional 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
[ { "MessageCount": 1, "DiscussionThreadKey": "dd9a6eba-b8f5-40cf-8e47-0185ec016516", "Subject": "sample string 3", "LastPostDate": "2024-09-08T00:53:44.1818219Z", "LinkToViewThread": "sample string 5", "LastPostAuthor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "c9e30535-48ed-436e-9fad-86030e18ba45", "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-09-08T00:53:44.1818219Z", "UpdatedByContactKey": "9f6780e5-201a-460c-b9f4-2e991240e14e", "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-09-08T00:53:44.1818219Z" }, "DiscussionKey": "37fb1442-67e3-481d-8662-dc3bcc047370", "CommunityName": "sample string 7", "CommunityKey": "ace419d1-bc5b-482b-b801-8025c621e794", "IsFollowing": true, "UserPermissions": [ "sample string 1", "sample string 2" ] }, { "MessageCount": 1, "DiscussionThreadKey": "dd9a6eba-b8f5-40cf-8e47-0185ec016516", "Subject": "sample string 3", "LastPostDate": "2024-09-08T00:53:44.1818219Z", "LinkToViewThread": "sample string 5", "LastPostAuthor": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "c9e30535-48ed-436e-9fad-86030e18ba45", "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-09-08T00:53:44.1818219Z", "UpdatedByContactKey": "9f6780e5-201a-460c-b9f4-2e991240e14e", "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-09-08T00:53:44.1818219Z" }, "DiscussionKey": "37fb1442-67e3-481d-8662-dc3bcc047370", "CommunityName": "sample string 7", "CommunityKey": "ace419d1-bc5b-482b-b801-8025c621e794", "IsFollowing": true, "UserPermissions": [ "sample string 1", "sample string 2" ] } ]
application/xml, text/xml
<ArrayOfDiscussionThread xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Discussions"> <DiscussionThread> <CommunityKey>ace419d1-bc5b-482b-b801-8025c621e794</CommunityKey> <DiscussionThreadKey>dd9a6eba-b8f5-40cf-8e47-0185ec016516</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-09-07T20:53:44.1818219-04: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>c9e30535-48ed-436e-9fad-86030e18ba45</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>9f6780e5-201a-460c-b9f4-2e991240e14e</d3p1:UpdatedByContactKey> <d3p1:UpdatedOn>2024-09-07T20:53:44.1818219-04:00</d3p1:UpdatedOn> </LastPostAuthor> <LastPostDate>2024-09-07T20:53:44.1818219-04: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>ace419d1-bc5b-482b-b801-8025c621e794</CommunityKey> <DiscussionThreadKey>dd9a6eba-b8f5-40cf-8e47-0185ec016516</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-09-07T20:53:44.1818219-04: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>c9e30535-48ed-436e-9fad-86030e18ba45</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>9f6780e5-201a-460c-b9f4-2e991240e14e</d3p1:UpdatedByContactKey> <d3p1:UpdatedOn>2024-09-07T20:53:44.1818219-04:00</d3p1:UpdatedOn> </LastPostAuthor> <LastPostDate>2024-09-07T20:53:44.1818219-04: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>