Cancel an import run

post

Authorizations

user

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

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

importRunIdstringRequired

The unique id of the import run

Responses

201

Import run canceled 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/{importRunId}/cancel

HTTPcURLJavaScriptPython

POST /v1/org/{organizationId}/imports/{importRunId}/cancel HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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