Skip to main content
Planview Customer Success Center

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.



Updated 2024-11-05 @ 09:11 AM