Bulk update board members and roles
POST /io/board/access
Bulk update board members and roles.
Warning: this endpoint can be destructive to user assignments and user subscriptions. If you reduce a user's role to boardReader
they will be unassigned from cards on the targeted boards. If you remove a user's access to a board they will be both unassigned and lose any of their subscriptions to changes on cards, lanes, and boards.
Example Requests
Update by email address
{ "boardIds": [ "10113285944" ], "emails": [ "someguy@myco.com", "bob@leankit.com" ], "boardRole": "boardReader" }
Update by user id
{ "boardIds": [ "10113285944", "10113245934" ], "userIds": [ "2305934", "1984303", "2530034" ], "boardRole": "boardUser" }
Update by team id
{ "boardIds": [ "10113285944", "10113245934" ], "teamIds": [ "5676029323", "9812398490", "8991021123" ], "boardRole": "boardUser" }
Example Response
204 No Content
Notable Error Responses
Status Code | Error Message | Reason |
---|---|---|
422 Unprocessable Entity |
varies | You will receive this error if the input is in the wrong format, the ids or emails are not valid, or if you exceed 500 operations for this request. Operations are calculated as board ids × users (either userIds, emails or teamIds ). 20 users or teams assigned to 20 boards would be considered 400 operations. |