Post
/api/v1/rooms.changeArchivationState
Archive or unarchive a room. Permissions required:
archive-room: To archive a room.unarchive-room: To unarchive a room.
Changelog
| Version | Description |
|---|---|
| 3.3.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": "iu7jtPAhvEeAS5tNq",
"action": "archive"
}object
rid
string Required
The room Id.
action
string Required
It can either be archive or otherwise unarchived.
Responses
200
OK
Success
{
"success": true
}object
success
boolean
400
Bad Request
Invalid Room
{
"success": false,
"error": "Invalid room [error-invalid-room]",
"errorType": "error-invalid-room",
"details": {
"method": "unarchiveRoom"
}
}object
success
boolean
error
string
errorType
string
details
object
method
string
401
Unauthorized
Authorization Error
{
"status": "error",
"message": "You must be logged in to do this."
}object
status
string
message
string