Set Default Channel
    • Dark
      Light
    • PDF

    Set Default Channel

    • Dark
      Light
    • PDF

    Article summary

    Post
    /api/v1/channels.setDefault

    Set whether the channel is a default channel or not.

    Changelog

    VersionDescription
    0.66.0Added
    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
    {
      "roomId": "ByehQjC44FwMeiLbX",
      "default": true
    }
    object
    roomId
    string Required

    The channel ID.

    default
    boolean Required

    Boolean of whether the room is default or not.

    Responses
    200

    OK

    Example
    {
      "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": [
          "goose160",
          "graywolf336"
        ],
        "joinCodeRequired": true,
        "muted": [],
        "default": true
      },
      "success": true
    }
    Expand All
    object
    channel
    object
    _id
    string
    name
    string
    t
    string
    msgs
    integer
    u
    object
    _id
    string
    username
    string
    ts
    string
    ro
    boolean
    sysMes
    boolean
    _updatedAt
    string
    usernames
    Array of string
    string
    joinCodeRequired
    boolean
    muted
    Array of object
    object
    default
    boolean
    success
    boolean
    401

    Unauthorized

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

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.