List Discussion Threads

Returns discussion board threads filtered by group, inbox, query, and tag.

GET /api/public/community/board/threads

List Discussion Threads

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/public/community/board/threads \
  --header 'Authorization: Basic <encoded-value>'

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

groupId · number · required

Filter threads to a specific discussion group.

inbox · string

Inbox filter (e.g. null for all, or specific inbox type).

query · string

Keyword search filter.

tag · string

Filter by tag name.

_shape · string

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)

Examples

Fetch threads in a group

GET /api/public/community/board/threads?groupId=1&inbox=&query=&tag=
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

const response = await httpClient.get(endpoints.community.board.list(1))