Community
List Discussion Threads
Returns discussion board threads filtered by group, inbox, query, and tag.
GET
List Discussion Threads
Returns a list of discussion board threads for the community feature. Supports filtering by group, inbox type, keyword search, and tag.Authentication
Requires a valid customer bearer token.Query Parameters
Filter threads to a specific discussion group.
Inbox filter (e.g.
null for all, or specific inbox type).Keyword search filter.
Filter by tag name.
Comma-separated list of field paths to include in the response. When provided, only the
specified fields are returned — useful for reducing payload size. Supports nested paths
using dot notation. Example:
_shape=Records.Subject,Records.LastMessageUtc,Records.MessageCount.Response
Returns a paginated list of thread summary objects.Thread Summary Fields
Identity
| Field | Type | Description |
|---|---|---|
Id | number | Unique numeric identifier for the thread |
UniqueId | string | Globally unique identifier |
ThreadUniqueId | string | Thread-specific unique identifier |
Content
| Field | Type | Description |
|---|---|---|
Subject | string | Thread subject / title |
Message | string | Original post content |
Tags | string[] | Array of tag strings |
Private | boolean | Whether the thread is private |
Author
| Field | Type | Description |
|---|---|---|
UserId | number | Author user identifier |
CoworkerId | number | Author coworker identifier |
FullName | string | Author full name |
ShortFullName | string | Abbreviated name (first + initial) |
Group & Location
| Field | Type | Description |
|---|---|---|
GroupId | number | Discussion group identifier |
GroupName | string | Discussion group display name |
BusinessId | number | Location identifier |
BusinessName | string | Location display name |
BusinessWebAddress | string | Location subdomain identifier |
Activity
| Field | Type | Description |
|---|---|---|
MessageCount | number | Total number of replies |
LikeCount | number | Total number of likes |
LastMessage | string | null | Last reply date (business-local) |
LastMessageUtc | string | null | Last reply date (UTC) |
LastMessageText | string | Last reply message text |
LastMessageUserFullName | string | Name of last reply author |
LastMessageCoworkerId | number | null | Coworker id of last reply author |
LastMessageId | number | null | Id of the last reply message |
Participation
| Field | Type | Description |
|---|---|---|
Participants | string[] | Array of participant identifiers |
FullNames | string[] | Array of participant full names |
Likes | string[] | Array of users who liked the thread |
FileIDs | string[] | Array of attached file identifiers |
FileNames | string[] | Array of attached file names |
User State
| Field | Type | Description |
|---|---|---|
MutedForUser | boolean | Whether muted by the current user |
FollowedByUser | boolean | Whether followed by the current user |
LikedByUser | boolean | Whether liked by the current user |
Timestamps
| Field | Type | Description |
|---|---|---|
PostedOn | string | Date posted (business-local time) |
PostedOnUtc | string | Date posted (UTC) |
CreatedOn | string | Date created (business-local time) |
UpdatedOn | string | null | Date last updated (business-local time) |
CreatedOnUtc | string | Date created (UTC) |
UpdatedOnUtc | string | null | Date last updated (UTC) |