Apply a content template to populate a space with initial pages

Populates a space with pages and structure from a specified template, bootstrapping it with a standard documentation layout. Use this to initialise a new space rather than creating pages manually. Optionally apply the template to a specific change request instead of main content by providing the changeRequestId field.

Available in MCP

post

Authorizations

useroauth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

spaceIdstringRequired

A unique entity identifier

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

Body

application/json

idstringRequired

The ID of the template to use for the space

changeRequestIdstringOptional

The ID of the change request to apply the template to. If not provided, the template is applied to the main content.

Responses

201

Template applied to space.

No content

post/spaces/{spaceId}/content/template

HTTPcURLJavaScriptPython

POST /v1/spaces/{spaceId}/content/template HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "id": "text",
  "params": {
    "contentRefs": {
      "ANY_ADDITIONAL_PROPERTY": {
        "kind": "file",
        "file": "text",
        "space": "text"
      }
    }
  },
  "changeRequestId": "text"
}

201

Template applied to space.

No content