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
}