0

Updates members of a team

by
Published Oct 17, 2025

Updates members of an organization team, either adding or removing them. If a the same user is included as both an add and a remove, they will be removed from the team.

Script gitbook Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Gitbook = {
3
  token: string;
4
};
5
/**
6
 * Updates members of a team
7
 * Updates members of an organization team, either adding or removing them. If a the same user is included as both an add and a remove, they will be removed from the team.
8

9
 */
10
export async function main(
11
  auth: Gitbook,
12
  organizationId: string,
13
  teamId: string,
14
  body: { add?: string[]; memberships?: {}; remove?: string[] },
15
) {
16
  const url = new URL(
17
    `https://api.gitbook.com/v1/orgs/${organizationId}/teams/${teamId}/members`,
18
  );
19

20
  const response = await fetch(url, {
21
    method: "PUT",
22
    headers: {
23
      "Content-Type": "application/json",
24
      Authorization: "Bearer " + auth.token,
25
    },
26
    body: JSON.stringify(body),
27
  });
28
  if (!response.ok) {
29
    const text = await response.text();
30
    throw new Error(`${response.status} ${text}`);
31
  }
32
  return await response.text();
33
}
34