Set Channel Type

Set a channel as public or private.

HTTP MethodURLRequires Auth

POST

/api/v1/channels.setType

Body Parameters

KeyExample ValueDescription

roomId* or roomName*

ByehQjC44FwMeiLbX or chat-room-name

The channel ID or name. You must enter at least one of the parameters.

type*

c or p

The type of room this channel should be, either c or p.

c is for channel and p is for private.

Example Call

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

or

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -H "Content-type: application/json" \
     https://localhost:3000/api/v1/channels.setType \
     -d '{      
          "roomName": "chat-room-name", 
          "type": "p" }'

Example Response

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

Change Log

VersionDescription

0.49.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.