Bulk update board users and roles
POST /io/board/access
Bulk update board users and roles.
Warning: this endpoint can be destructive to user assignments and user subscriptions. If you reduce a user's role to boardReader
or none
, they will be unassigned from cards on the targeted boards. If you reduce a user's role to none
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 or emails ). 20 users assigned to 20 boards would be considered 400 operations. |