Post
/api/v1/teams.updateMember
Updates a team member's roles.
Permission required: edit-team-member
Changelog
| Version | Description |
|---|---|
| 9.0.0 | Assigning roles now requires the matching permission: set-owner, set-moderator or set-leader for those roles, and access-permissions for any other role except member. |
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
{
"teamId": "63f3efc4b000b6b6d86704b2",
"member": {
"userId": "rYhzFRd2QZjNwAAXX",
"roles": [
"owner",
"leader"
]
}
}object
teamId
string Required
Enter the team ID. Alternatively, enter the teamName parameter and provide the team's name as the value.
member
object Required
The users (IDs and roles) to add or update in the team.
userId
string
Enter the user ID.
roles
Array
You also need the permission for each role you add or remove: set-owner for owner, set-moderator for moderator, and set-leader for leader. Any other role except member requires access-permissions, and the admin role also requires assign-admin-role. If you don't have them, the request fails with a 403 error.
Responses
200
OK
Success
{
"success": true
}object
success
boolean
400
Bad Request
Invalid Params
{
"success": false,
"error": "must have required property 'member'\n must have required property 'teamName'\n must match exactly one schema in oneOf",
"errorType": "error-invalid-params"
}Invalid Team Id
{
"success": false,
"error": "team-does-not-exist"
}object
success
boolean
error
string
errorType
string
401
Unauthorized
Authorization Error
{
"success": false,
"error": "You must be logged in to do this."
}object
success
boolean
error
string
403
Forbidden
Permission Error
{
"success": false,
"error": "forbidden"
}object
success
boolean
error
string