Post
/api/v1/groups.addLeader
Assign the leader role to a user in a private channel. Learn more about roles from the Roles in Rocket.Chat document.
Permission required: set-leader
Changelog
| Version | Description |
|---|---|
| 0.58.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
{
"roomId": "ByehQjC44FwMeiLbX",
"userId": "oCHkav5Zf6vmpu2W2"
}object
roomId
string Required
The groups's id
userId
string Required
The user's id
Responses
200
OK
Success
{
"success": true
}object
success
boolean
400
Bad Request
User is already a leader
{
"success": false,
"error": "User is already a leader [error-user-already-leader]",
"errorType": "error-user-already-leader"
}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