Subdomains

Manage and configure organization-specific subdomains for your docs.

Provide a branded subdomain for each organization to create a consistent user experience. This API supports subdomain creation, DNS checks, and more.

The Subdomain object

Attributes

objectstring · enumRequiredPossible values:

subdomainstring · min: 3 · max: 32Required

The GitBook subdomain, for example "my-company" in "my-company.gitbook.io"

Pattern: ^[a-z0-9][a-z0-9-]{1,30}[a-z0-9]$

targetone ofRequired

isActivebooleanRequired

The Subdomain object

{
  "object": "subdomain",
  "subdomain": "text",
  "target": {
    "type": "organization",
    "organization": "text"
  },
  "isActive": true
}

Get a subdomain

get

Authorizations

user

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

subdomainstring · min: 3 · max: 32Required

The subdomain, for example "my-company" in "my-company.gitbook.io"

Pattern: ^[a-z0-9][a-z0-9-]{1,30}[a-z0-9]$

Responses

200

OK

application/json

get

/subdomains/{subdomain}

HTTPcURLJavaScriptPython

GET /v1/subdomains/{subdomain} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "object": "subdomain",
  "subdomain": "text",
  "target": {
    "type": "organization",
    "organization": "text"
  },
  "isActive": true
}