Import content into a space from a website

post

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

sourceone ofRequired

or

enhancebooleanOptional

Enhance the imported content with AI

Default: true

Responses

201

Import run created successfully.

application/json

idstringRequired

Unique ID of the import

startedAtstring · date-timeOptional

Date when the import has started

completedAtstring · date-timeOptional

Filled when the imported is in status "completed"

statusstring · enumRequired

Status of the import

Possible values:

reasonstringOptional

Reason for the import failure when status is failed.

400

Bad Request

application/json

404

Not Found

application/json

post/org/{organizationId}/imports

HTTPcURLJavaScriptPython

POST /v1/org/{organizationId}/imports HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 135

{
  "source": {
    "type": "website",
    "url": "https://example.com"
  },
  "target": {
    "space": "text",
    "changeRequest": "text",
    "page": "text"
  },
  "enhance": true
}

{
  "id": "text",
  "startedAt": "2026-07-21T20:33:40.050Z",
  "completedAt": "2026-07-21T20:33:40.050Z",
  "status": "pending",
  "reason": "text",
  "pages": [
    {
      "id": "text",
      "sourceURL": "text",
      "type": "page",
      "status": "complete"
    }
  ]
}