Jump to

• Request
• Response
• Examples

Update the specified conversation.

put

/social/api/v1/conversations/{conversationID}

Request

Supported Media Types

• application/json

Path Parameters

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

Body ()

The request body defines the details of the request.

Root Schema : XV1ConversationUpdateInfo

Type: object

V1 Conversation Update Information.

Show Source

• impersonateUser: string
  User to impersonate.
• updater: object XConversationUpdater
  Updater for conversations.

{
    "description":"V1 Conversation Update Information.",
    "properties":{
        "impersonateUser":{
            "description":"User to impersonate.",
            "type":"string"
        },
        "updater":{
            "$ref":"#/definitions/XConversationUpdater"
        }
    }
}

Nested Schema : XConversationUpdater

Type: object

Updater for conversations.

Show Source

• ALTITUDE: string
  Double for the altitude.
• DATE_FORMAT_LOCALE: string
  The date-format locale.
• DISALLOW_GUESTS: string
  Boolean for disallow guests status.
• EXTENDED_ACCESS_CONTROL: string
  Boolean for use extended access control status.
• fMap: string
  The contained Map of Strings to Values.
• LANGUAGE_LOCALE: string
  The spoken language locale.
• LATITUDE: string
  Double for the latitude.
• LATITUDE_MAX: number(double)
  Maximum possible latitude.
• LATITUDE_MIN: number(double)
  Minimum possible latitude.
• LONGITUDE: string
  Double for the longitude.
• LONGITUDE_MAX: number(double)
  Maximum possible longitude.
• LONGITUDE_MIN: number(double)
  Minimum possible longitude.
• MEMBERS_LOCKED: string
  Boolean for members locked status.
• OUTCOME: string
  Integer for the outcome. (0-100)
• RETENTION_EXTENDED: string
  Boolean for whether this conversation uses the extended retention policy.
• SHORT_NAME: string
  String for the short name.
• TIME_ZONE: string
  The time zone.

{
    "description":"Updater for conversations.",
    "properties":{
        "ALTITUDE":{
            "description":"Double for the altitude.",
            "type":"string"
        },
        "DISALLOW_GUESTS":{
            "description":"Boolean for disallow guests status.",
            "type":"string"
        },
        "EXTENDED_ACCESS_CONTROL":{
            "description":"Boolean for use extended access control status.",
            "type":"string"
        },
        "LATITUDE":{
            "description":"Double for the latitude.",
            "type":"string"
        },
        "LATITUDE_MAX":{
            "description":"Maximum possible latitude.",
            "type":"number",
            "format":"double"
        },
        "LATITUDE_MIN":{
            "description":"Minimum possible latitude.",
            "type":"number",
            "format":"double"
        },
        "LONGITUDE":{
            "description":"Double for the longitude.",
            "type":"string"
        },
        "LONGITUDE_MAX":{
            "description":"Maximum possible longitude.",
            "type":"number",
            "format":"double"
        },
        "LONGITUDE_MIN":{
            "description":"Minimum possible longitude.",
            "type":"number",
            "format":"double"
        },
        "MEMBERS_LOCKED":{
            "description":"Boolean for members locked status.",
            "type":"string"
        },
        "OUTCOME":{
            "description":"Integer for the outcome. (0-100)",
            "type":"string"
        },
        "SHORT_NAME":{
            "description":"String for the short name.",
            "type":"string"
        },
        "DATE_FORMAT_LOCALE":{
            "description":"The date-format locale.",
            "type":"string"
        },
        "LANGUAGE_LOCALE":{
            "description":"The spoken language locale.",
            "type":"string"
        },
        "RETENTION_EXTENDED":{
            "description":"Boolean for whether this conversation uses the extended retention policy.",
            "type":"string"
        },
        "TIME_ZONE":{
            "description":"The time zone.",
            "type":"string"
        },
        "fMap":{
            "description":"The contained Map of Strings to Values.",
            "type":"string"
        }
    }
}

Response

Supported Media Types

• application/json

200 Response

Successful operation.

Body ()

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

{
    "description":"V1 Conversation Information DTO.",
    "properties":{
        "allMembershipsURL":{
            "description":"A URL to the hierarchical memberships of this conversation.",
            "type":"string",
            "format":"url"
        },
        "archiveURL":{
            "description":"A URL to the archive of this conversation.",
            "type":"string",
            "format":"url"
        },
        "dateFormatLocale":{
            "description":"The locale of the appropriate date format for this conversation.",
            "type":"string",
            "format":"locale"
        },
        "discoverableID":{
            "$ref":"#/definitions/XObjectID"
        },
        "externalID":{
            "description":"The primary external ID of this conversation.",
            "type":"string"
        },
        "folderID":{
            "$ref":"#/definitions/XObjectID"
        },
        "folderURL":{
            "description":"A URL to the root folder of this conversation.",
            "type":"string",
            "format":"url"
        },
        "gadgetsURL":{
            "description":"A URL to the gadgets of this conversation.",
            "type":"string",
            "format":"url"
        },
        "hasMembersLocked":{
            "description":"True if the membership of this conversation is locked.",
            "type":"boolean"
        },
        "hierarchicalMembersInfo":{
            "$ref":"#/definitions/XV1HierarchicalMembersInfo"
        },
        "isDisallowGuests":{
            "description":"True if this conversation does not allow guest users.",
            "type":"boolean"
        },
        "isDisallowOutsiders":{
            "description":"True if this conversation does not allow outsider users.",
            "type":"boolean"
        },
        "isDiscoverable":{
            "description":"True if this conversation is discoverable (public).",
            "type":"boolean"
        },
        "isExtendedAccessControl":{
            "description":"True if this conversation uses extended access control.",
            "type":"boolean"
        },
        "isMuted":{
            "description":"True if this conversation is muted for the current user.",
            "type":"boolean"
        },
        "isNew":{
            "description":"True if this conversation has not been entered by the current user.",
            "type":"boolean"
        },
        "isScoped":{
            "description":"True if the membership of this conversation is scoped by another conversation.",
            "type":"boolean"
        },
        "isScoping":{
            "description":"True if this is a scoping conversation.",
            "type":"boolean"
        },
        "isScopingSame":{
            "description":"True if this conversation is scoped to have the same membership as another conversation.",
            "type":"boolean"
        },
        "languageLocale":{
            "description":"The language locale for this conversation.",
            "type":"string",
            "format":"locale"
        },
        "likesURL":{
            "description":"A URL to the likes of this conversation.",
            "type":"string",
            "format":"url"
        },
        "membershipsURL":{
            "description":"A URL to the memberships of this conversation.",
            "type":"string",
            "format":"url"
        },
        "membersURL":{
            "description":"A URL to the members of this conversation.",
            "type":"string",
            "format":"url"
        },
        "messagesURL":{
            "description":"A URL to the messages in this conversation.",
            "type":"string",
            "format":"url"
        },
        "nChats":{
            "description":"The number of chats in this conversation. (total chats less deleted chats.)",
            "type":"integer",
            "format":"int32"
        },
        "nFollowups":{
            "description":"The number of followups in the conversation.",
            "type":"integer",
            "format":"int32"
        },
        "nMarkableChats":{
            "description":"The number of chats that could be marked read. (Total markable less deleted markable. Does not depend on the current user.)",
            "type":"integer",
            "format":"int32"
        },
        "nOutsiders":{
            "description":"Count of the outside users.",
            "type":"integer",
            "format":"int32"
        },
        "nUnread":{
            "description":"The number of chats that the current user can mark read.",
            "type":"integer",
            "format":"int32"
        },
        "propertiesURL":{
            "description":"A URL to the properties of this conversation.",
            "type":"string",
            "format":"url"
        },
        "role":{
            "description":"The current user's role in this conversation.",
            "type":"string"
        },
        "secondaryExternalIDs":{
            "description":"The secondary external IDs for this conversation.",
            "type":"array",
            "items":{
                "description":"The secondary external IDs for this conversation.",
                "type":"string"
            }
        },
        "securityContextID":{
            "description":"The ID of the service that dictates the security for this Conversation object.",
            "type":"string"
        },
        "starsURL":{
            "description":"A URL to the stars of this conversation.",
            "type":"string",
            "format":"url"
        },
        "state":{
            "$ref":"#/definitions/XV1ConversationState"
        },
        "timeZone":{
            "description":"The time zone for this conversation.",
            "type":"string",
            "format":"timezone"
        },
        "userPropertiesURL":{
            "description":"A URL to the user properties of this conversation.",
            "type":"string",
            "format":"url"
        },
        "wallPostControl":{
            "$ref":"#/definitions/XV1WallPostControlEnum"
        },
        "originalPictureURL":{
            "description":"The original picture URL.",
            "type":"string",
            "format":"url"
        },
        "profilePictureURL":{
            "description":"The profile picture URL (150 px by 150 px).",
            "type":"string",
            "format":"url"
        },
        "scaledPictureURL":{
            "description":"The scaled picture URL (44 px by 44 px).",
            "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 : 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.

{
    "description":"V1 Hierarchical Members Information DTO.",
    "properties":{
        "createdFolderIDs":{
            "$ref":"#/definitions/XV1FolderIDListInfo"
        },
        "ignoredMembers":{
            "$ref":"#/definitions/XV1IgnoredMemberListInfo"
        },
        "ignoredUsers":{
            "$ref":"#/definitions/XV1IgnoredUserListInfo"
        },
        "operationType":{
            "$ref":"#/definitions/XV1HierarchicalMembersOperationType"
        },
        "removedFolderIDs":{
            "$ref":"#/definitions/XV1FolderIDListInfo"
        }
    }
}

Nested Schema : secondaryExternalIDs

Type: array

The secondary external IDs for this conversation.

Show Source

• [0]: string
  The secondary external IDs for this conversation.

{
    "description":"The secondary external IDs for this conversation.",
    "type":"array",
    "items":{
        "description":"The secondary external IDs for this conversation.",
        "type":"string"
    }
}

Nested Schema : XV1ConversationState

Type: object

Show Source

• field: string
  Allowed Values: [ "CLOSED_CHAINED", "CLOSED_DISABLED", "CLOSED_DROPPED", "CLOSED_RESOLVED", "OPEN_ACTIVE" ]

  V1 Conversation States.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Conversation States.",
            "enum":[
                "CLOSED_CHAINED",
                "CLOSED_DISABLED",
                "CLOSED_DROPPED",
                "CLOSED_RESOLVED",
                "OPEN_ACTIVE"
            ]
        }
    }
}

Nested Schema : XV1WallPostControlEnum

Type: object

Show Source

• field: string
  Allowed Values: [ "ANYONE_CAN_POST", "OWNER_ONLY_POSTS", "OWNER_TOP_LEVEL" ]

  V1 Wall Posting Control Enum.

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Wall Posting Control Enum.",
            "enum":[
                "ANYONE_CAN_POST",
                "OWNER_ONLY_POSTS",
                "OWNER_TOP_LEVEL"
            ]
        }
    }
}

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.

{
    "description":"List of folder IDs.",
    "properties":{
        "ids":{
            "description":"List of folder IDs.",
            "type":"array",
            "items":{
                "description":"List of folder IDs.",
                "type":"string"
            }
        },
        "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 : 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.

{
    "description":"List of ignored members.",
    "properties":{
        "groups":{
            "description":"List of users.",
            "type":"array",
            "items":{
                "description":"List of users.",
                "type":"string"
            }
        },
        "users":{
            "description":"List of users.",
            "type":"array",
            "items":{
                "description":"List of users.",
                "type":"string"
            }
        },
        "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 : 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.

{
    "description":"List of ignored users.",
    "properties":{
        "users":{
            "description":"List of users.",
            "type":"array",
            "items":{
                "description":"List of users.",
                "type":"string"
            }
        },
        "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 : XV1HierarchicalMembersOperationType

Type: object

Show Source

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

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Collaboration API Operation Types on Hierarchical Members.",
            "enum":[
                "ASSOCIATE_CONVERSATION",
                "CREATE_CONVERSATION",
                "MOVE_FILE",
                "MOVE_FOLDER",
                "MOVE_MEMBERS",
                "REMOVE_MEMBERS",
                "REMOVE_MEMBERS_OBJECT",
                "SHARE_FOLDER"
            ]
        }
    }
}

Nested Schema : ids

Type: array

List of folder IDs.

Show Source

• [0]: string
  List of folder IDs.

{
    "description":"List of folder IDs.",
    "type":"array",
    "items":{
        "description":"List of folder IDs.",
        "type":"string"
    }
}

Nested Schema : groups

Type: array

List of users.

Show Source

• [0]: string
  List of users.

{
    "description":"List of users.",
    "type":"array",
    "items":{
        "description":"List of users.",
        "type":"string"
    }
}

Nested Schema : users

Type: array

List of users.

Show Source

• [0]: string
  List of users.

{
    "description":"List of users.",
    "type":"array",
    "items":{
        "description":"List of users.",
        "type":"string"
    }
}

Nested Schema : users

Type: array

List of users.

Show Source

• [0]: string
  List of users.

{
    "description":"List of users.",
    "type":"array",
    "items":{
        "description":"List of users.",
        "type":"string"
    }
}

Examples

The following example shows how to update the specified conversation by submitting a PUT request on the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X PUT -c mycookies.jar -b mycookies.jar -H 'X-Waggle-RandomID:b97554e5a31e50a734899ee4f79218bd' -H 'Content-Type: application/json' https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006 -d '{ "updater" : {"State":"OPEN_ACTIVE", "Altitude":"15"}}'

Example of Request Body

The following shows an example of the request document in JSON format.

{
  "updater" : {"State":"OPEN_ACTIVE", "Altitude":"15"}
}

Example of Response Body

The following shows an example of the response JSON document.

"[e-mail]",
  "createdByUserDisplayName" : "[e-mail]",
  "createdByURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/people/11001",
  "createdDate" : 1455325485929,
  "modifiedByID" : "11001",
  "modifiedByUserName" : "[e-mail]",
  "modifiedByUserDisplayName" : "[e-mail]",
  "modifiedByURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/people/11001",
  "modifiedDate" : 1455326386743,
  "isRemoved" : false,
  "url" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006",
  "externalID" : "ext00055",
  "secondaryExternalIDs" : ["ext00055"],
  "isScoping" : false,
  "isScopingSame" : false,
  "isScoped" : false,
  "state" : "OPEN_ACTIVE",
  "isDiscoverable" : false,
  "wallPostControl" : "ANYONE_CAN_POST",
  "hasMembersLocked" : false,
  "isDisallowGuests" : false,
  "isDisallowOutsiders" : false,
  "nOutsiders" : 0,
  "isExtendedAccessControl" : false,
  "folderID" : "22011",
  "role" : "HOST",
  "isMuted" : false,
  "isNew" : true,
  "nChats" : 2,
  "nMarkableChats" : 1,
  "nUnread" : 0,
  "nFollowups" : 0,
  "membersURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/members",
  "membershipsURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/memberships",
  "messagesURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/messages",
  "propertiesURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/properties",
  "userPropertiesURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/userProperties",
  "starsURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/stars",
  "likesURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/likes",
  "gadgetsURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/gadgets",
  "archiveURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/conversations/22006/archive",
  "folderURL" : "https://socialnetwork06065-ustraveler15926.socialnetwork.dc1.c9dev1.example.com/osn/social/api/v1/folders/22011"
}