Update a team

patch

Authorizations

useroauth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

teamIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

Body

application/json

titlestring · min: 1 · max: 64Required

Title of the team

Responses

200

The team has been updated

application/json

objectstring · enumRequired

Type of Object, always equals to "team"

Possible values:

idstringRequired

Unique identifier for the team.

titlestring · min: 1 · max: 64Required

Title of the team

membersintegerRequired

Count of members in this team.

spacesnumberRequired

Count of spaces this team has access to.

createdAtstring · date-timeRequired

Date at which the team was created.

patch/orgs/{organizationId}/teams/{teamId}

HTTPcURLJavaScriptPython

PATCH /v1/orgs/{organizationId}/teams/{teamId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "title": "text"
}

200

The team has been updated

{
  "object": "team",
  "id": "text",
  "title": "text",
  "members": 1,
  "spaces": 1,
  "createdAt": "2026-07-21T20:36:27.520Z",
  "permissions": {
    "admin": true,
    "view": true
  }
}