Ask or search…
K
Comment on page

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
owner
string
The unique identifier of a member of the organization. Only teams they can manage will be returned.
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, and their roles, 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"
],
"memberships": {
"additionalProp1": {
"role": "owner"
},
"additionalProp2": {
"role": "owner"
},
"additionalProp3": {
"role": "owner"
}
},
"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 or update a team membership

Add or updates member in 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
Body
Example
Schema
{
"role": "owner"
}
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 7mo ago