Channel Set Read Only

Sets whether the channel is read only or not.

URL Requires Auth HTTP Method
/api/v1/channels.setReadOnly yes POST


Argument Example Required Description
roomId ByehQjC44FwMeiLbX Required The channel’s id
readOnly true Required Boolean of whether the room is read only or not.

Example Call

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -H "Content-type: application/json" \
     http://localhost:3000/api/v1/channels.setReadOnly \
     -d '{ "roomId": "ByehQjC44FwMeiLbX", "readOnly": true }'

Example Result

    "channel": {
        "_id": "ByehQjC44FwMeiLbX",
        "name": "testing0",
        "t": "c",
        "msgs": 0,
        "u": {
            "_id": "aiPqNoGkjpNDiRx6d",
            "username": "goose160"
        "ts": "2017-01-05T18:02:50.754Z",
        "ro": true,
        "sysMes": true,
        "_updatedAt": "2017-01-05T19:02:24.429Z",
        "usernames": [
        "joinCodeRequired": true,
        "muted": []
    "success": true

Change Log

Version Description
0.49.0 Added