Jump to

• Request
• Response

Get around chats after the specified message.

get

/social/api/v1/messages/{messageID}/around

Request

Supported Media Types

• application/json

Path Parameters

• messageID: integer(int64)
  The message ID. The object's unique identifier from a long integer representation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation.

Body ()

Root Schema : XV1MessageListInfo

Type: object

V1 Message List Information DTO.

Show Source

• hasMore(optional): boolean
  If true, there are more items to be returned.
• items(optional): array items
  The messages being returned. Note that messages are returned starting from the tail of the conversation (newest first).
• nextURL(optional): string(url)
  Next page URL for the list. Null if this is the last page.
• previousURL(optional): string(url)
  Previous page URL for the list. Null if this is the first page.
• total(optional): integer(int32)
  If specified, this is the total number of available items. Null if the total is unknown.

{
    "description":"V1 Message List Information DTO.",
    "properties":{
        "items":{
            "description":"The messages being returned. Note that messages are returned starting from the tail of the conversation (newest first).",
            "type":"array",
            "items":{
                "$ref":"#/definitions/XV1MessageInfo"
            }
        },
        "hasMore":{
            "description":"If true, there are more items to be returned.",
            "type":"boolean"
        },
        "nextURL":{
            "description":"Next page URL for the list. Null if this is the last page.",
            "type":"string",
            "format":"url"
        },
        "previousURL":{
            "description":"Previous page URL for the list. Null if this is the first page.",
            "type":"string",
            "format":"url"
        },
        "total":{
            "description":"If specified, this is the total number of available items. Null if the total is unknown.",
            "type":"integer",
            "format":"int32"
        }
    }
}

Nested Schema : items

Type: array

The messages being returned. Note that messages are returned starting from the tail of the conversation (newest first).

Show Source

• Array of: object XV1MessageInfo
  V1 Message Information DTO.

{
    "description":"The messages being returned. Note that messages are returned starting from the tail of the conversation (newest first).",
    "type":"array",
    "items":{
        "$ref":"#/definitions/XV1MessageInfo"
    }
}

Nested 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.

{
    "description":"V1 Message Information DTO.",
    "properties":{
        "comments":{
            "description":"The comments on this message.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/XV1MessageInfo"
            }
        },
        "documentURL":{
            "description":"A URL to any associated document for this message.",
            "type":"string",
            "format":"url"
        },
        "externalID":{
            "description":"The external ID for this message.",
            "type":"string"
        },
        "folderURL":{
            "description":"A URL to any associated folder for this message.",
            "type":"string",
            "format":"url"
        },
        "followupsURL":{
            "description":"A URL to followups on this message. Can be null.",
            "type":"string",
            "format":"url"
        },
        "formattedLocale":{
            "description":"The locale, if this chat message was dynamically formatted to the  specified locale.",
            "type":"string"
        },
        "isSystem":{
            "description":"True when the message text was generated by the system.",
            "type":"boolean"
        },
        "likesURL":{
            "description":"A URL to likes on this message. Can be null.",
            "type":"string",
            "format":"url"
        },
        "moderationState":{
            "$ref":"#/definitions/XV1MessageModerationState"
        },
        "nComments":{
            "description":"The number of comments or replies to this message.",
            "type":"integer",
            "format":"int32"
        },
        "ordinal":{
            "description":"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.",
            "type":"integer",
            "format":"int32"
        },
        "parentID":{
            "$ref":"#/definitions/XObjectID"
        },
        "parentURL":{
            "description":"A URL to the parent corresponding to {@code parentID}. Can be null.",
            "type":"string",
            "format":"url"
        },
        "plainText":{
            "description":"The plain-text version of this message.",
            "type":"string"
        },
        "richText":{
            "description":"The rich-text version of this message.",
            "type":"string"
        },
        "starsURL":{
            "description":"A URL to stars on this message. Can be null.",
            "type":"string",
            "format":"url"
        },
        "type":{
            "$ref":"#/definitions/XV1MessageType"
        },
        "version":{
            "description":"The version number of this message.",
            "type":"integer",
            "format":"int32"
        },
        "altitude":{
            "description":"The object's altitude.",
            "type":"number",
            "format":"double"
        },
        "collectionURL":{
            "description":"A URL to this object's containing collection.",
            "type":"string",
            "format":"url"
        },
        "conversationURL":{
            "description":"A URL to this object's containing conversation.",
            "type":"string",
            "format":"url"
        },
        "createdByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "createdByURL":{
            "description":"A URL to the user that created this object.",
            "type":"string",
            "format":"url"
        },
        "createdByUserDisplayName":{
            "description":"The display name of the user that created this object.",
            "type":"string"
        },
        "createdByUserName":{
            "description":"The name of the user that created this object.",
            "type":"string"
        },
        "createdDate":{
            "description":"The date this object was created.",
            "type":"string",
            "format":"date"
        },
        "createdDateInISO8601Format":{
            "description":"The date this object was created, in ISO 8601 format.",
            "type":"string"
        },
        "displayName":{
            "description":"The display name of this object.",
            "type":"string"
        },
        "id":{
            "$ref":"#/definitions/XObjectID"
        },
        "isRemoved":{
            "description":"True if this message has been removed.",
            "type":"boolean"
        },
        "latitude":{
            "description":"The object's latitude.",
            "type":"number",
            "format":"double"
        },
        "longitude":{
            "description":"The object's longitude.",
            "type":"number",
            "format":"double"
        },
        "modifiedByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "modifiedByURL":{
            "description":"A URL to the user that last modified this object.",
            "type":"string",
            "format":"url"
        },
        "modifiedByUserDisplayName":{
            "description":"The display name of the user that last modified this object.",
            "type":"string"
        },
        "modifiedByUserName":{
            "description":"The name of the user that last modified this object.",
            "type":"string"
        },
        "modifiedDate":{
            "description":"The date this object was last modified.",
            "type":"string",
            "format":"date"
        },
        "modifiedDateInISO8601Format":{
            "description":"The date this object was last modified, in ISO 8601 format.",
            "type":"string"
        },
        "name":{
            "description":"The name of this object.",
            "type":"string"
        },
        "objectType":{
            "description":"The type of this object.",
            "type":"string"
        },
        "removedByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "removedByURL":{
            "description":"A URL to the user that last removed this object.",
            "type":"string",
            "format":"url"
        },
        "removedByUserDisplayName":{
            "description":"The display name of the user that last removed this object.",
            "type":"string"
        },
        "removedByUserName":{
            "description":"The name of the user that last removed this object.",
            "type":"string"
        },
        "removedDate":{
            "description":"The date this object was removed.",
            "type":"string",
            "format":"date"
        },
        "removedDateInISO8601Format":{
            "description":"The date this object was removed, in ISO 8601 format.",
            "type":"string"
        },
        "socialObjectURL":{
            "description":"A URL to this object's containing collaboration object.",
            "type":"string",
            "format":"url"
        },
        "url":{
            "description":"A URL to this object.",
            "type":"string",
            "format":"url"
        }
    }
}

Nested Schema : comments

Type: array

The comments on this message.

Show Source

• Array of: object XV1MessageInfo
  V1 Message Information DTO.

{
    "description":"The comments on this message.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/XV1MessageInfo"
    }
}

Nested Schema : XV1MessageModerationState

Type: object

Show Source

• field(optional): string
  Allowed Values: [ "APPROVED", "DRAFT", "REJECTED", "REPLACED" ]

  V1 Moderation state of messages in a conversation.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Moderation state of messages in a conversation.",
            "enum":[
                "APPROVED",
                "DRAFT",
                "REJECTED",
                "REPLACED"
            ]
        }
    }
}

Nested Schema : XV1MessageType

Type: object

Show Source

• 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.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Message Types.",
            "enum":[
                "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"
            ]
        }
    }
}

Back to Top