Get the specified message.
get
/social/api/v1/messages/{messageID}
Request
Supported Media Types
- application/json
Path Parameters
-
messageID: integer(int64)
The message ID. The object's unique identifier from a long integer representation.
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : XV1MessageInfo
Type:
object
V1 Message Information DTO.
Show Source
-
altitude(optional):
number(double)
The object's altitude.
-
collectionURL(optional):
string(url)
A URL to this object's containing collection.
-
comments(optional):
array comments
The comments on this message.
-
conversationURL(optional):
string(url)
A URL to this object's containing conversation.
-
createdByID(optional):
An object's unique identifier from a long integer representation.
-
createdByURL(optional):
string(url)
A URL to the user that created this object.
-
createdByUserDisplayName(optional):
string
The display name of the user that created this object.
-
createdByUserName(optional):
string
The name of the user that created this object.
-
createdDate(optional):
string(date)
The date this object was created.
-
createdDateInISO8601Format(optional):
string
The date this object was created, in ISO 8601 format.
-
displayName(optional):
string
The display name of this object.
-
documentURL(optional):
string(url)
A URL to any associated document for this message.
-
externalID(optional):
string
The external ID for this message.
-
folderURL(optional):
string(url)
A URL to any associated folder for this message.
-
followupsURL(optional):
string(url)
A URL to followups on this message. Can be null.
-
formattedLocale(optional):
string
The locale, if this chat message was dynamically formatted to the specified locale.
-
id(optional):
An object's unique identifier from a long integer representation.
-
isRemoved(optional):
boolean
True if this message has been removed.
-
isSystem(optional):
boolean
True when the message text was generated by the system.
-
latitude(optional):
number(double)
The object's latitude.
-
likesURL(optional):
string(url)
A URL to likes on this message. Can be null.
-
longitude(optional):
number(double)
The object's longitude.
-
moderationState(optional):
object XV1MessageModerationState
-
modifiedByID(optional):
An object's unique identifier from a long integer representation.
-
modifiedByURL(optional):
string(url)
A URL to the user that last modified this object.
-
modifiedByUserDisplayName(optional):
string
The display name of the user that last modified this object.
-
modifiedByUserName(optional):
string
The name of the user that last modified this object.
-
modifiedDate(optional):
string(date)
The date this object was last modified.
-
modifiedDateInISO8601Format(optional):
string
The date this object was last modified, in ISO 8601 format.
-
name(optional):
string
The name of this object.
-
nComments(optional):
integer(int32)
The number of comments or replies to this message.
-
objectType(optional):
string
The type of this object.
-
ordinal(optional):
integer(int32)
The ordinal for this message. Message ordinals are numbers for messages that are unique within a conversation and can be used with read and unread ranges.
-
parentID(optional):
An object's unique identifier from a long integer representation.
-
parentURL(optional):
string(url)
A URL to the parent corresponding to {@code parentID}. Can be null.
-
plainText(optional):
string
The plain-text version of this message.
-
removedByID(optional):
An object's unique identifier from a long integer representation.
-
removedByURL(optional):
string(url)
A URL to the user that last removed this object.
-
removedByUserDisplayName(optional):
string
The display name of the user that last removed this object.
-
removedByUserName(optional):
string
The name of the user that last removed this object.
-
removedDate(optional):
string(date)
The date this object was removed.
-
removedDateInISO8601Format(optional):
string
The date this object was removed, in ISO 8601 format.
-
richText(optional):
string
The rich-text version of this message.
-
socialObjectURL(optional):
string(url)
A URL to this object's containing collaboration object.
-
starsURL(optional):
string(url)
A URL to stars on this message. Can be null.
-
type(optional):
object XV1MessageType
-
url(optional):
string(url)
A URL to this object.
-
version(optional):
integer(int32)
The version number of this message.
Nested Schema : comments
Type:
array
The comments on this message.
Show Source
-
Array of:
object XV1MessageInfo
V1 Message Information DTO.
Nested Schema : XV1MessageModerationState
Type:
Show Source
object
-
field(optional):
string
Allowed Values:
[ "APPROVED", "DRAFT", "REJECTED", "REPLACED" ]
V1 Moderation state of messages in a conversation.
Nested Schema : XV1MessageType
Type:
Show Source
object
-
field(optional):
string
Allowed Values:
[ "SYSTEM_ANNOTATION_CLOSED", "SYSTEM_ANNOTATION_OPENED", "SYSTEM_ARTIFACT_COPIED", "SYSTEM_ARTIFACT_CREATED", "SYSTEM_ARTIFACT_NAME_CHANGED", "SYSTEM_ARTIFACT_STATE_CHANGED", "SYSTEM_CONVERSATION_ATTRIBUTES_CHANGED", "SYSTEM_CONVERSATION_DISCOVERABLE_CHANGED", "SYSTEM_CONVERSATION_FORKED_NEXT", "SYSTEM_CONVERSATION_FORKED_PREVIOUS", "SYSTEM_CONVERSATION_MEMBERSHIP_CHANGED", "SYSTEM_CONVERSATION_NAME_CHANGED", "SYSTEM_CONVERSATION_STATE_CLOSED_CHAINED", "SYSTEM_CONVERSATION_STATE_CLOSED_DISABLED", "SYSTEM_CONVERSATION_STATE_CLOSED_DROPPED", "SYSTEM_CONVERSATION_STATE_CLOSED_RESOLVED", "SYSTEM_CONVERSATION_STATE_OPEN_ACTIVE", "SYSTEM_CONVERSATION_TYPE_FIELDS_CHANGED", "SYSTEM_GENERIC", "SYSTEM_RTC_CONFERENCE", "SYSTEM_RTC_CONFERENCE_RECORDING_AVAILABLE", "SYSTEM_UPLOAD_GROUP", "SYSTEM_VERSION_ADDED", "SYSTEM_WIDGET", "SYSTEM_WIDGET_CREATED", "SYSTEM_WIDGET_REMOVED", "USER_ANNOTATION", "USER_ANNOTATION_GROUP", "USER_CHAT", "WEBHOOK_CHAT" ]
V1 Message Types.