Links

Teams

A team in GitBook is the entity of a group that members of an organization belong to.

GET teams in an organization

get
https://api.gitbook.com/v1
/orgs/{organizationId}/teams
List organization teams

Lists teams for the specified organization.

Parameters
Path
organizationId*
string
The unique id of the organization
Query
page
string
Identifier of the page results to fetch.
limit
number
The number of results per page
title
string
If provided, only teams whose name contains the given parameter will be returned. Case insensitive.
Responses
200: OK
OK
default
Unexpected Error

PUT a team in an organization

put
https://api.gitbook.com/v1
/orgs/{organizationId}/teams
Create organization team

Creates a team in the specified organization.

Parameters
Path
organizationId*
string
The unique id of the organization
Body
Example
Schema
{
"title": "string",
"members": [
"string"
]
}
Responses
201: Created
Team has been created
default
Unexpected Error

GET a specific team in an organization

get
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}
Get specified organization team

Gets a specific team in an organization.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
Responses
200: OK
OK
default
Unexpected Error

PATCH a specific team in an organization

patch
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}
Update specified organization team

Updates a specific team in an organization.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
Body
Example
Schema
{
"title": "string"
}
Responses
200: OK
The team has been updated
default
Unexpected Error

DELETE a specific team in an organization

delete
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}
Delete a team in an organization

Deletes a specific team in an organization

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
Responses
204: No Content
The team was deleted from the organization.
default
Unexpected Error

GET team members in an organization

get
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}/members
List team members

Lists members for the specified organization team.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
Query
page
string
Identifier of the page results to fetch.
limit
number
The number of results per page
Responses
200: OK
OK
default
Unexpected Error

PUT team members in an organization

put
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}/members
Updates members of an organization team

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.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
Body
Example
Schema
{
"add": [
"string"
],
"remove": [
"string"
]
}
Responses
204: No Content
Members have been updated
default
Unexpected Error

PUT a specific team member in an organization

put
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}/members/{userId}
Add member to a team

Adds member into the specified organization team.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
userId*
string
The unique ID of the User
Responses
204: No Content
Member has been added to the team
default
Unexpected Error

DELETE a specific team member in an organization

delete
https://api.gitbook.com/v1
/orgs/{organizationId}/teams/{teamId}/members/{userId}
Delete members from a team

Deletes member from the specified organization team.

Parameters
Path
organizationId*
string
The unique id of the organization
teamId*
string
The unique ID of the Team
userId*
string
The unique ID of the User
Responses
204: No Content
Member has been deleted from the team
default
Unexpected Error
Last modified 1mo ago