Manage team member roles

POST

/teams/:teamId/bulk-members

Adds or removes member roles in groups, teams, organizations, as well as individual users’ roles.

Note:

If you remove a role from a group or team, then all members lose the that role’s permissions.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

teamIdintegerRequired

The team's ID.

Request

This endpoint expects an object.

addobjectOptional

Information about the bulk add operation.

removeobjectOptional

Information about the bulk remove operation.

Response

Successful Response

resultlist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

$	curl -X POST https://api.getpostman.com/teams/123/bulk-members \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"add": {
>	"users": {
>	"12345678": [
>	"TEAM_MANAGER"
>	]
>	},
>	"groups": {
>	"1234": [
>	"TEAM_DEVELOPER"
>	]
>	}
>	}
>	}'

1	{
2	"result": [
3	{
4	"entityType": "user",
5	"entityId": 12345678,
6	"role": "TEAM_MANAGER",
7	"previousRole": null,
8	"status": "Accepted"
9	},
10	{
11	"entityType": "group",
12	"entityId": 1234,
13	"role": "TEAM_DEVELOPER",
14	"previousRole": null,
15	"status": "Accepted"
16	}
17	]
18	}

Authentication

Path parameters

Headers

Request

Response

Errors