Threaded Discussion Messagess

Threaded discussion messages are messages posted by an employee about an object of a supported type. Currently, threaded messages are only available for projects in SuiteProjects Pro. For a description of threaded discussion messages in the SuiteProjects Pro UI, see Project Discussions.

A project discussion is a collection of messages about a specific project. There is a 1:1 relationship between project and project discussion.

A message is a unit of writing posted by a user at a given date and time in the project discussion. A message can be an initial communication posted to the project discussion (original message), or a response posted in a thread (reply).

A thread is an original message and a collection of replies to this original message.

An original message is a message posted to the project discussion. An original message can be either an unthreaded message (if there are no replies) or the start of a thread (if there are replies).

A reply is any message added to a thread, functioning as a response to the original message or to other replies within that same thread.

Available methods

POST /threaded-discussions/{id}/messages – See Post an Original Message to a Project Discussion
GET /threaded-discussions/{id}/messages – See Get the List of Original Messages in a Project Discussion
PUT /threaded-discussions/{id}/messages/{messages_id} – See Update a Message in a Project Discussion
DELETE /threaded-discussions/{id}/messages/{messages_id} – See Delete a Message from a Project Discussion
POST /threaded-discussions/{id}/messages/{messages_id}/replies – See Post a Reply in a Project Discussion Message Thread
GET /threaded-discussions/{id}/messages/{messages_id}/replies – See Get the List of Replies in a Project Discussion Thread

ThreadedMessage object properties

A project discussion message is a message posted by an employee about a project.

The ThreadedMessage object has the following properties:

Property	Description	Type	Read-only	Query allowed	Sorting allowed
`content`	The body of the message.	string	—	Yes	—
`countRepliesTotal`	If this is an original message for a message thread, the number of read or unread replies in the thread (if any).	integer($int64)	Yes	Yes	—
`countRepliesUnread`	If this is an original message for a message thread, the number of unread replies in the thread (if any).	integer($int64)	Yes	Yes	—
`created`	The date and time the message was created.	string($date-time)	Yes	Yes	—
`deletedBy`	The internal ID of the employee who deleted the message.	integer($int64)	Yes	Yes	—
`edited`	A 1/0 field indicating if the message was edited.	Boolean	Yes	Yes	—
`id`	The unique internal identifier of the message.	integer($int64)	Yes	Yes	Yes
`isLastReadMessage`	A 1/0 field indicating whether this is the last message in the project discussion, or the last reply in the message thread marked as read for the authenticated user.	Boolean	Yes	Yes	—
`lastReplyDate`	If this is an original message for a message thread, the date and time of the latest reply in the message thread.	string($date-time)	Yes	Yes	—
`recordId`	The internal ID of the record in the table `tableName` associated with the threaded discussion.	integer($int64)	Yes	Yes	—
`replyToId`	If the message is a reply in a message thread, the internal ID of the original message for the thread.	number($float)	Yes	Yes	—
`tableName`	The name of the table including the record associated with the threaded discussion.	string	Yes	Yes	—
`updated`	The date and time the message was last updated or modified.	string($date-time)	Yes	Yes	—
`userId`	The internal ID of the employee associated with the message (the employee who posted the message).	integer($int64)	Yes	Yes	—

Property

Description

Type

Read-only

Query allowed

Sorting allowed

content

The body of the message.

string

—

Yes

—

countRepliesTotal

If this is an original message for a message thread, the number of read or unread replies in the thread (if any).

integer($int64)

Yes

—

countRepliesUnread

If this is an original message for a message thread, the number of unread replies in the thread (if any).

integer($int64)

Yes

—

created

The date and time the message was created.

string($date-time)

Yes

—

deletedBy

The internal ID of the employee who deleted the message.

integer($int64)

Yes

—

edited

A 1/0 field indicating if the message was edited.

Boolean

Yes

—

id

The unique internal identifier of the message.

integer($int64)

Yes

isLastReadMessage

A 1/0 field indicating whether this is the last message in the project discussion, or the last reply in the message thread marked as read for the authenticated user.

Boolean

Yes

—

lastReplyDate

If this is an original message for a message thread, the date and time of the latest reply in the message thread.

string($date-time)

Yes

—

recordId

The internal ID of the record in the table tableName associated with the threaded discussion.

integer($int64)

Yes

—

replyToId

If the message is a reply in a message thread, the internal ID of the original message for the thread.

number($float)

Yes

—

tableName

The name of the table including the record associated with the threaded discussion.

string

Yes

—

updated

The date and time the message was last updated or modified.

string($date-time)

Yes

—

userId

The internal ID of the employee associated with the message (the employee who posted the message).

integer($int64)

Yes

—

Note:

Access to certain object types and object attributes depend on the business logic configured for your SuiteProjects Pro account. It may vary depending on the role and access privileges associated with the access token and with the user who authorized the application.

Required and read-only attributes also depend on the business logic configured for each specific SuiteProjects Pro account. Some fields such as id, created, and updated are system-generated and always read-only.