Space teams
Integrate team-based permissions for better collaboration in a space.
Assign entire teams to your spaces and streamline the process of granting or revoking access at scale, without dealing with individual user roles.
The unique id of the space
The unique ID of the Team
The team was not found in the space
The team has been removed from the space
Team does not have access to space
DELETE /v1/spaces/{spaceId}/permissions/teams/{teamId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
The unique id of the space
The unique ID of the Team
The role of a member in an organization, null for guests
"The role of a member in an organization. "admin": Can administrate the content: create, delete spaces, ... "create": Can create content. "review": Can review content. "edit": Can edit the content (live or change requests). "comment": Can access the content and its discussions. "read": Can access the content, but cannot update it in any way.
Team permission was updated
No team found with the given ID
PATCH /v1/spaces/{spaceId}/permissions/teams/{teamId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"role": "admin"
}No content
The unique id of the space
Identifier of the page results to fetch.
The number of results per page
Listing of teams who have been added to a space.
No space was found with the given Id
GET /v1/spaces/{spaceId}/permissions/teams HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"next": {
"page": "text"
},
"count": 1,
"items": [
{
"permission": "admin",
"team": {
"object": "team",
"id": "text",
"title": "text",
"members": 1,
"spaces": 1,
"createdAt": "2025-08-06T04:43:47.090Z",
"permissions": {
"admin": true,
"view": true
}
}
}
]
}Was this helpful?