Save Room Settings

Post
/api/v1/rooms.saveRoomSettings

Permission required: edit-room

Changelog

Version Description
3.13.0 Added
Header parameters
X-Auth-Token
stringRequired

The authToken of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-Id
stringRequired

The userId of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ
Body parameters
Example
{
  "rid": "JZ8Y2dLfYhsg323Rf",
  "roomName": "Test-Save-Room",
  "roomDescription": "This is a test room."
}
Expand All
object
rid
string Required

The room ID.

roomName
string

The name of the room.

roomDescription
string

The description of the room.

roomAvatar
string

The base64 image.

featured
boolean

Whether the room is featured or not.

roomTopic
string

The topic of the room.

roomAnnouncement
string

The announcement of the room.

roomCustomFields
object

An object of the custom fields of the room.

roomType
string

The type of the room. It could be c for public rooms or p for private rooms.

readOnly
boolean

Whether the room is read-only or not.

reactWhenReadOnly
boolean

Whether users can react when the room is read-only.

systemMessages
Array of string

The system messages that the room supports.

string
default
boolean

Whether the room is the default room or not.

joinCode
string

The join code of the room.

streamingOptions
object

The streaming options of the room.

retentionEnabled
boolean

Whether retention is enabled for the room or not.

retentionMaxAge
string

The maximum age (in days) of messages to be retained in the room.

retentionExcludePinned
boolean

Whether to exclude pinned messages from retention or not.

retentionFilesOnly
boolean

Whether to retain only files in the room or not.

retentionIgnoreThreads
boolean

Whether to ignore threads when retaining messages or not.

retentionOverrideGlobal
boolean

Whether to override the global retention settings for the room or not.

encrypted
boolean

Whether the room is encrypted or not.

favorite
object

The favorite settings of the room. Whether the room is marked as favorite and whether it is set as the default room.

sidepanel
object

List the team's channels or discussions to be displayed in the sidepanel.

items
Array of string

The options are discussions and channels.

string
Example["discussions", "channels"]
Responses
200

OK

Success
{
  "rid": "JZ8Y2dLfYhsg323Rf",
  "success": true
}
object
rid
string
success
boolean
400

Bad Request

roomId or roomName is required
{
  "success": false,
  "error": "The required \"roomId\" or \"roomName\" param provided does not match any group [error-room-not-found]",
  "errorType": "error-room-not-found"
}
object
success
boolean
error
string
errorType
string
401

Unauthorized

Authorization Error
{
  "status": "error",
  "message": "You must be logged in to do this."
}
object
status
string
message
string