Demote Owner

Demotes room owner to a participant in the chat room.

Demotes room owner.

POSTyourpodURL.symphony.com/pod/v1/room/{id}/membership/demoteOwner

Path parameters

id*string

Room streamId

Header parameters

Body

application/json

idinteger (int64)

Example: 7215545058313

Response

200400401403500

OK

Body

application/json

formatenum

Example: "TEXT"

TEXTXML

messagestring

Example: "Success"

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/room/{id}/membership/demoteOwner', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403500

{
  "format": "TEXT",
  "message": "Success"
}

📘 Room ID

The room ID can be located in the Symphony web or desktop client by clicking on the timestamp of any message in the conversation. This will open the Message Status module overlay, and the Conversation ID can be found in the overlay footer.

The room ID in the UI is in Standard Base64 encoding. When the room ID needs to be used in a URL, it should be in URLSafe Base64 encoding. To obtain the URLSafe Base64 room ID, replace forward slashes with underscores, replace pluses with minuses, and ignore any trailing equal signs.

Note: visit Overview for an overview of streams.

🚧 Required Permissions

Room members can only be demoted to participants by:

• Owners of the room

• Service Users with the User Provisioning role (members or not members of the room)

See Bot Permissions for a list of roles and associated privileges.

At any time, a room must have at least one owner; therefore, it is not possible to demote the last owner of a room.