Jump to

• Request
• Response

Create new followups on the specified message.

post

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

Request

Supported Media Types

• application/json

Path Parameters

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

Body ()

The request body defines the details of the request.

Root Schema : XV1MessageFollowupCreateInfo

Type: object

V1 Message Followup Create Information.

Show Source

• assignee: string
  The followup assignee. Required.
• followupType: object XV1FollowupType

{
    "description":"V1 Message Followup Create Information.",
    "properties":{
        "assignee":{
            "description":"The followup assignee. Required.",
            "type":"string"
        },
        "followupType":{
            "$ref":"#/definitions/XV1FollowupType"
        }
    }
}

Nested Schema : XV1FollowupType

Type: object

Show Source

• field: string
  Allowed Values: [ "FOR_YOUR_INFORMATION", "PLEASE_REPLY", "PLEASE_REPLY_URGENT" ]

  V1 Followup Types.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Followup Types.",
            "enum":[
                "FOR_YOUR_INFORMATION",
                "PLEASE_REPLY",
                "PLEASE_REPLY_URGENT"
            ]
        }
    }
}

Response

Supported Media Types

• application/json

200 Response

Successful operation.

Body ()

V1 Message Followup Information DTO.

Root Schema : XV1MessageFollowupInfo

Type: object

V1 Message Followup Information DTO.

Show Source

• altitude: number(double)
  The object's altitude.
• assigneeDisplayName: string
  The display name of the user this followup is assigned to.
• assigneeID:
  An object's unique identifier from a long integer representation.
• assigneeName: string
  The name of the user this followup is assigned to.
• assigneeURL: string
  A URL to the user this followup is assigned to.
• assignerDisplayName: string
  The display name of the user who assigned this followup.
• assignerID:
  An object's unique identifier from a long integer representation.
• assignerName: string
  The name of the user who assigned this followup.
• assignerURL: string(url)
  A URL to the user who assigned this followup.
• collectionURL: string(url)
  A URL to this object's containing collection.
• conversationURL: string(url)
  A URL to this object's containing conversation.
• createdByID:
  An object's unique identifier from a long integer representation.
• createdByURL: string(url)
  A URL to the user that created this object.
• createdByUserDisplayName: string
  The display name of the user that created this object.
• createdByUserName: string
  The name of the user that created this object.
• createdDate: string(date)
  The date this object was created.
• createdDateInISO8601Format: string
  The date this object was created, in ISO 8601 format.
• displayName: string
  The display name of this object.
• followupType: object XV1FollowupType
• id:
  An object's unique identifier from a long integer representation.
• isOpen: boolean
  Whether this followup is open or closed.
• isRead: boolean
  Whether this followup is read.
• isRemoved: boolean
  True if this message has been removed.
• isReply: boolean
  Whether this followup has been replied to.
• latitude: number(double)
  The object's latitude.
• longitude: number(double)
  The object's longitude.
• messageURL: string(url)
  A URL to the message this followup is set on.
• modifiedByID:
  An object's unique identifier from a long integer representation.
• modifiedByURL: string(url)
  A URL to the user that last modified this object.
• modifiedByUserDisplayName: string
  The display name of the user that last modified this object.
• modifiedByUserName: string
  The name of the user that last modified this object.
• modifiedDate: string(date)
  The date this object was last modified.
• modifiedDateInISO8601Format: string
  The date this object was last modified, in ISO 8601 format.
• name: string
  The name of this object.
• objectType: string
  The type of this object.
• openDate: string(date)
  When the open/close state last changed.
• openDateInISO8601Format: string
  When the open/close state last changed, in ISO 8601 format.
• openURL: string(url)
  A URL to the user who last changed the open/close state.
• readDate: string(date)
  When the read state last changed.
• readDateInISO8601Format: string
  When the read state last changed, in ISO 8601 format.
• removedByID:
  An object's unique identifier from a long integer representation.
• removedByURL: string(url)
  A URL to the user that last removed this object.
• removedByUserDisplayName: string
  The display name of the user that last removed this object.
• removedByUserName: string
  The name of the user that last removed this object.
• removedDate: string(date)
  The date this object was removed.
• removedDateInISO8601Format: string
  The date this object was removed, in ISO 8601 format.
• replyDate: string(date)
  When the last reply happened.
• replyDateInISO8601Format: string
  When the last reply happened, in ISO 8601 format.
• replyURL: string(url)
  A URL to any reply message.
• socialObjectURL: string(url)
  A URL to this object's containing collaboration object.
• url: string(url)
  A URL to this object.

{
    "description":"V1 Message Followup Information DTO.",
    "properties":{
        "assigneeDisplayName":{
            "description":"The display name of the user this followup is assigned to.",
            "type":"string"
        },
        "assigneeID":{
            "$ref":"#/definitions/XObjectID"
        },
        "assigneeName":{
            "description":"The name of the user this followup is assigned to.",
            "type":"string"
        },
        "assigneeURL":{
            "description":"A URL to the user this followup is assigned to.",
            "type":"string"
        },
        "assignerDisplayName":{
            "description":"The display name of the user who assigned this followup.",
            "type":"string"
        },
        "assignerID":{
            "$ref":"#/definitions/XObjectID"
        },
        "assignerName":{
            "description":"The name of the user who assigned this followup.",
            "type":"string"
        },
        "assignerURL":{
            "description":"A URL to the user who assigned this followup.",
            "type":"string",
            "format":"url"
        },
        "followupType":{
            "$ref":"#/definitions/XV1FollowupType"
        },
        "isOpen":{
            "description":"Whether this followup is open or closed.",
            "type":"boolean"
        },
        "isRead":{
            "description":"Whether this followup is read.",
            "type":"boolean"
        },
        "isReply":{
            "description":"Whether this followup has been replied to.",
            "type":"boolean"
        },
        "messageURL":{
            "description":"A URL to the message this followup is set on.",
            "type":"string",
            "format":"url"
        },
        "openDate":{
            "description":"When the open/close state last changed.",
            "type":"string",
            "format":"date"
        },
        "openDateInISO8601Format":{
            "description":"When the open/close state last changed, in ISO 8601 format.",
            "type":"string"
        },
        "openURL":{
            "description":"A URL to the user who last changed the open/close state.",
            "type":"string",
            "format":"url"
        },
        "readDate":{
            "description":"When the read state last changed.",
            "type":"string",
            "format":"date"
        },
        "readDateInISO8601Format":{
            "description":"When the read state last changed, in ISO 8601 format.",
            "type":"string"
        },
        "replyDate":{
            "description":"When the last reply happened.",
            "type":"string",
            "format":"date"
        },
        "replyDateInISO8601Format":{
            "description":"When the last reply happened, in ISO 8601 format.",
            "type":"string"
        },
        "replyURL":{
            "description":"A URL to any reply message.",
            "type":"string",
            "format":"url"
        },
        "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 : XV1FollowupType

Type: object

Show Source

• field: string
  Allowed Values: [ "FOR_YOUR_INFORMATION", "PLEASE_REPLY", "PLEASE_REPLY_URGENT" ]

  V1 Followup Types.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Followup Types.",
            "enum":[
                "FOR_YOUR_INFORMATION",
                "PLEASE_REPLY",
                "PLEASE_REPLY_URGENT"
            ]
        }
    }
}