POST api/v2.0/Discussions/Follow?discussionThreadKey={discussionThreadKey}

POST request follows the specified discussion thread - DELETE removes the follow.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
discussionThreadKey

unique identifier for the Item to follow/un-follow

 globally unique identifier

Required

Body Parameters

None.

Response Information

Resource Description

The discussion thread the user followed

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": "3e5f831e-4a3a-4fb2-ad9c-bc1a0d54e3e4",
  "Subject": "sample string 3",
  "LastPostDate": "2026-03-26T21:37:33.0202778Z",
  "LinkToViewThread": "sample string 5",
  "LastPostAuthor": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "0d2e9f2a-4383-4252-a2c1-5beb2de2433f",
    "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": "2026-03-26T21:37:33.0202778Z",
    "UpdatedByContactKey": "78c2ebae-f276-4490-85a9-5acc98e1adc0",
    "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": "2026-03-26T21:37:33.0202778Z"
  },
  "DiscussionKey": "21116299-babc-46ca-9976-8bd567338b04",
  "CommunityName": "sample string 7",
  "CommunityKey": "8e02234d-5ac1-4b39-b156-558fd2f07bc1",
  "IsFollowing": true,
  "UserPermissions": [
    "sample string 1",
    "sample string 2"
  ]
}

application/xml, text/xml

Sample: 
<DiscussionThread xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Discussions">
  <CommunityKey>8e02234d-5ac1-4b39-b156-558fd2f07bc1</CommunityKey>
  <DiscussionThreadKey>3e5f831e-4a3a-4fb2-ad9c-bc1a0d54e3e4</DiscussionThreadKey>
  <IsFollowing>true</IsFollowing>
  <LastPostAuthor xmlns:d2p1="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
    <d2p1:AMSDirectoryOptOut>true</d2p1:AMSDirectoryOptOut>
    <d2p1:AgreedToTermsDateTime>2026-03-26T17:37:33.0202778-04:00</d2p1:AgreedToTermsDateTime>
    <d2p1:CompanyLegacyContactKey>sample string 20</d2p1:CompanyLegacyContactKey>
    <d2p1:CompanyName>sample string 12</d2p1:CompanyName>
    <d2p1:CompanyTitle>sample string 13</d2p1:CompanyTitle>
    <d2p1:ContactKey>0d2e9f2a-4383-4252-a2c1-5beb2de2433f</d2p1:ContactKey>
    <d2p1:ContactStatusCode>sample string 8</d2p1:ContactStatusCode>
    <d2p1:Designation>sample string 15</d2p1:Designation>
    <d2p1:DisplayName>sample string 6</d2p1:DisplayName>
    <d2p1:EmailAddress>sample string 7</d2p1:EmailAddress>
    <d2p1:FirstName>sample string 4</d2p1:FirstName>
    <d2p1:HLContactMeOptOut>true</d2p1:HLContactMeOptOut>
    <d2p1:HLDirectoryOptOut>true</d2p1:HLDirectoryOptOut>
    <d2p1:InformalName>sample string 17</d2p1:InformalName>
    <d2p1:IsCompany>true</d2p1:IsCompany>
    <d2p1:LargePictureUrl>sample string 24</d2p1:LargePictureUrl>
    <d2p1:LastName>sample string 5</d2p1:LastName>
    <d2p1:LegacyContactKey>sample string 16</d2p1:LegacyContactKey>
    <d2p1:LinkToProfile>sample string 1</d2p1:LinkToProfile>
    <d2p1:MiddleName>sample string 18</d2p1:MiddleName>
    <d2p1:PictureUrl>sample string 2</d2p1:PictureUrl>
    <d2p1:PrefixCode>sample string 9</d2p1:PrefixCode>
    <d2p1:SuffixCode>sample string 14</d2p1:SuffixCode>
    <d2p1:UpdatedByContactKey>78c2ebae-f276-4490-85a9-5acc98e1adc0</d2p1:UpdatedByContactKey>
    <d2p1:UpdatedOn>2026-03-26T17:37:33.0202778-04:00</d2p1:UpdatedOn>
  </LastPostAuthor>
  <LastPostDate>2026-03-26T17:37:33.0202778-04:00</LastPostDate>
  <LinkToViewThread>sample string 5</LinkToViewThread>
  <MessageCount>1</MessageCount>
  <Subject>sample string 3</Subject>
  <UserPermissions xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </UserPermissions>
</DiscussionThread>