Create the one-on-one conversation for the specified users. This method will create the one-on-one conversation if it does not already exist. Currently property update information is not being consumed by the API to update any property.
post
/social/api/v1/people/{firstPersonID}/chats/{secondPersonID}
Request
Supported Media Types
- application/json
Path Parameters
-
firstPersonID: integer(int64)
The ID of the first user in the one-on-one conversation. The ordering of the first and second person IDs does not matter. The object's unique identifier from a long integer representation.
-
secondPersonID: integer(int64)
The ID of the second user in the one-on-one conversation. The ordering of the first and second person IDs does not matter. The object's unique identifier from a long integer representation.
The request body defines the details of the request.
Root Schema : XV1PeoplePropertyUpdateInfo
Type:
object
V1 People Property Update Information.
Show Source
-
value:
string
The property value.
Response
Supported Media Types
- application/json
200 Response
Successful operation.
V1 Conversation Information DTO.
Root Schema : XV1ConversationInfo
Type:
object
V1 Conversation Information DTO.
Show Source
-
allMembershipsURL:
string(url)
A URL to the hierarchical memberships of this conversation.
-
altitude:
number(double)
The object's altitude.
-
archiveURL:
string(url)
A URL to the archive of this conversation.
-
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.
-
dateFormatLocale:
string(locale)
The locale of the appropriate date format for this conversation.
-
discoverableID:
An object's unique identifier from a long integer representation.
-
displayName:
string
The display name of this object.
-
externalID:
string
The primary external ID of this conversation.
-
folderID:
An object's unique identifier from a long integer representation.
-
folderURL:
string(url)
A URL to the root folder of this conversation.
-
gadgetsURL:
string(url)
A URL to the gadgets of this conversation.
-
hasMembersLocked:
boolean
True if the membership of this conversation is locked.
-
hierarchicalMembersInfo:
object XV1HierarchicalMembersInfo
V1 Hierarchical Members Information DTO.
-
id:
An object's unique identifier from a long integer representation.
-
isDisallowGuests:
boolean
True if this conversation does not allow guest users.
-
isDisallowOutsiders:
boolean
True if this conversation does not allow outsider users.
-
isDiscoverable:
boolean
True if this conversation is discoverable (public).
-
isExtendedAccessControl:
boolean
True if this conversation uses extended access control.
-
isMuted:
boolean
True if this conversation is muted for the current user.
-
isNew:
boolean
True if this conversation has not been entered by the current user.
-
isRemoved:
boolean
True if this message has been removed.
-
isScoped:
boolean
True if the membership of this conversation is scoped by another conversation.
-
isScoping:
boolean
True if this is a scoping conversation.
-
isScopingSame:
boolean
True if this conversation is scoped to have the same membership as another conversation.
-
languageLocale:
string(locale)
The language locale for this conversation.
-
latitude:
number(double)
The object's latitude.
-
likesURL:
string(url)
A URL to the likes of this conversation.
-
longitude:
number(double)
The object's longitude.
-
membershipsURL:
string(url)
A URL to the memberships of this conversation.
-
membersURL:
string(url)
A URL to the members of this conversation.
-
messagesURL:
string(url)
A URL to the messages in this conversation.
-
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.
-
nChats:
integer(int32)
The number of chats in this conversation. (total chats less deleted chats.)
-
nFollowups:
integer(int32)
The number of followups in the conversation.
-
nMarkableChats:
integer(int32)
The number of chats that could be marked read. (Total markable less deleted markable. Does not depend on the current user.)
-
nOutsiders:
integer(int32)
Count of the outside users.
-
nUnread:
integer(int32)
The number of chats that the current user can mark read.
-
objectType:
string
The type of this object.
-
originalPictureURL:
string(url)
The original picture URL.
-
profilePictureURL:
string(url)
The profile picture URL (150 px by 150 px).
-
propertiesURL:
string(url)
A URL to the properties of this conversation.
-
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.
-
role:
string
The current user's role in this conversation.
-
scaledPictureURL:
string(url)
The scaled picture URL (44 px by 44 px).
-
secondaryExternalIDs:
array secondaryExternalIDs
The secondary external IDs for this conversation.
-
securityContextID:
string
The ID of the service that dictates the security for this Conversation object.
-
socialObjectURL:
string(url)
A URL to this object's containing collaboration object.
-
starsURL:
string(url)
A URL to the stars of this conversation.
-
state:
object XV1ConversationState
-
timeZone:
string(timezone)
The time zone for this conversation.
-
url:
string(url)
A URL to this object.
-
userPropertiesURL:
string(url)
A URL to the user properties of this conversation.
-
wallPostControl:
object XV1WallPostControlEnum
Nested Schema : XV1HierarchicalMembersInfo
Type:
object
V1 Hierarchical Members Information DTO.
Show Source
-
createdFolderIDs:
object XV1FolderIDListInfo
List of folder IDs.
-
ignoredMembers:
object XV1IgnoredMemberListInfo
List of ignored members.
-
ignoredUsers:
object XV1IgnoredUserListInfo
List of ignored users.
-
operationType:
object XV1HierarchicalMembersOperationType
-
removedFolderIDs:
object XV1FolderIDListInfo
List of folder IDs.
Nested Schema : secondaryExternalIDs
Type:
array
The secondary external IDs for this conversation.
Show Source
-
[0]:
string
The secondary external IDs for this conversation.
Nested Schema : XV1ConversationState
Type:
Show Source
object
-
field:
string
Allowed Values:
[ "CLOSED_CHAINED", "CLOSED_DISABLED", "CLOSED_DROPPED", "CLOSED_RESOLVED", "OPEN_ACTIVE" ]
V1 Conversation States.
Nested Schema : XV1WallPostControlEnum
Type:
Show Source
object
-
field:
string
Allowed Values:
[ "ANYONE_CAN_POST", "OWNER_ONLY_POSTS", "OWNER_TOP_LEVEL" ]
V1 Wall Posting Control Enum.
Nested Schema : XV1FolderIDListInfo
Type:
object
List of folder IDs.
Show Source
-
hasMore:
boolean
If true, there are more items to be returned.
-
ids:
array ids
List of folder IDs.
-
nextURL:
string(url)
Next page URL for the list. Null if this is the last page.
-
previousURL:
string(url)
Previous page URL for the list. Null if this is the first page.
-
total:
integer(int32)
If specified, this is the total number of available items. Null if the total is unknown.
Nested Schema : XV1IgnoredMemberListInfo
Type:
object
List of ignored members.
Show Source
-
groups:
array groups
List of users.
-
hasMore:
boolean
If true, there are more items to be returned.
-
nextURL:
string(url)
Next page URL for the list. Null if this is the last page.
-
previousURL:
string(url)
Previous page URL for the list. Null if this is the first page.
-
total:
integer(int32)
If specified, this is the total number of available items. Null if the total is unknown.
-
users:
array users
List of users.
Nested Schema : XV1IgnoredUserListInfo
Type:
object
List of ignored users.
Show Source
-
hasMore:
boolean
If true, there are more items to be returned.
-
nextURL:
string(url)
Next page URL for the list. Null if this is the last page.
-
previousURL:
string(url)
Previous page URL for the list. Null if this is the first page.
-
total:
integer(int32)
If specified, this is the total number of available items. Null if the total is unknown.
-
users:
array users
List of users.
Nested Schema : XV1HierarchicalMembersOperationType
Type:
Show Source
object
-
field:
string
Allowed Values:
[ "ASSOCIATE_CONVERSATION", "CREATE_CONVERSATION", "MOVE_FILE", "MOVE_FOLDER", "MOVE_MEMBERS", "REMOVE_MEMBERS", "REMOVE_MEMBERS_OBJECT", "SHARE_FOLDER" ]
V1 Collaboration API Operation Types on Hierarchical Members.