Create a team

put

Authorizations

useroauth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

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

Body

application/json

titlestring · min: 1 · max: 64Required

Title of the team

membersstring[]Optional

A list of organization member identifiers

Responses

201

Team has been created

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.

put/orgs/{organizationId}/teams

HTTPcURLJavaScriptPython

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

{
  "title": "text",
  "members": [
    "text"
  ]
}

201

Team has been created

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