ドキュメントを再インデックス

選択した各ドキュメントについて、現在のファイルからインデックスを再構築するインデックスタスクをキューに追加します。これらのタスクをまとめて追跡するための一括タスク ID を返します。

all: true と documentIds のどちらか一方だけを指定する必要があります。

ファイルは再アップロードされません。各タスクは compilation_job.id を使って インデックスタスクを取得 で、リクエスト全体は 一括タスクを取得 で追跡します。

再インデックスの流れについては、再インデックスとインデックス処理の追跡 を参照してください。

POST /knowledge-fs/spaces/{knowledge_base_id}/documents/reindex

cURL

all

curl --request POST \
  --url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/documents/reindex \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "all": true
}'

202

success

{
  "bulk_job_id": "5a1c2e3d-7b8f-4a9c-8d1e-2f3a4b5c6d7e",
  "items": [
    {
      "asset": {
        "created_at": "2026-09-03T10:02:11Z",
        "filename": "handbook.pdf",
        "id": "6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b",
        "knowledge_space_id": "9b2e5b7a-3c1d-4e2f-8a9b-1c2d3e4f5a6b",
        "metadata": {},
        "mime_type": "application/pdf",
        "object_key": "1a7c9e40-2b3d-4f56-8a90-b1c2d3e4f506/spaces/9b2e5b7a-3c1d-4e2f-8a9b-1c2d3e4f5a6b/documents/6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b/handbook.pdf",
        "parser_status": "parsed",
        "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
        "size_bytes": 482113,
        "source_id": null,
        "updated_at": null,
        "version": 1
      },
      "code": null,
      "compilation_job": {
        "id": "e4a1f0b2-7c3d-4e5f-9a1b-2c3d4e5f6a7b",
        "stage": "queued"
      },
      "document_id": null,
      "error": null,
      "status": "queued",
      "status_url": "/knowledge-spaces/9b2e5b7a-3c1d-4e2f-8a9b-1c2d3e4f5a6b/documents/3d2f1c0b-9a8e-4d7c-b6a5-4f3e2d1c0b9a/processing-tasks/e4a1f0b2-7c3d-4e5f-9a1b-2c3d4e5f6a7b"
    },
    {
      "asset": null,
      "code": null,
      "compilation_job": null,
      "document_id": "8f14e45f-ceea-467a-9575-62c9a2d3e6b1",
      "error": null,
      "status": "not_found",
      "status_url": null
    }
  ],
  "total": 2
}

Authorizations

Authorization · string · header · required

すべてのリクエストは、Authorization: Bearer {API_KEY} ヘッダーに指定した API キーで認証します。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します（Dify API クイックスタート）。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーがない、または無効な場合は HTTP 401（unauthorized）が返ります。

Headers

Idempotency-Key · string

毎回の呼び出しでキーを送信してください。キーがあれば、呼び出しを安全に再試行できます。前後に空白を含まない、8〜255 文字の印字可能な ASCII 文字を使用してください。キーの形式が正しくない場合は 400 が返ります。

同じキーと同じボディを再送信すると、新しいインデックスタスクは開始されず、元の一括タスクが返されます。異なるボディ、別の API キー、別のナレッジベース、または別の操作で同じキーを再利用すると 409 が返ります。

Required string length: 8 - 255

Path Parameters

knowledge_base_id · string<uuid> · required

ナレッジベース ID です。ナレッジベースの API アクセス ダイアログに表示されるサービス API エンドポイントの最後のセグメント（…/knowledge-fs/spaces/<knowledge base ID>）です。アドレスバーでは /datasets/new/ の後のセグメントです。

Body

application/json

nullable と記されたオプションフィールドでは、null は省略と同じ扱いになります。

正規化後のリクエストは、UTF-8 で 1,048,576 バイト以内に収める必要があります。リクエストサイズの制限 を参照してください。

すべてのドキュメント

選択したドキュメント

all: true または空でない documentIds 配列のどちらかを送信します。両方は送信できません。documentIds を送る場合、all は省略するか、false または null にできます。all: true を送る場合、documentIds は省略するか null にできます。空の配列は拒否されます。

all · enum<boolean> · required

true にすると、API キーで読み取れるすべてのドキュメントファイルを再インデックスします。対象が上限（デフォルトは 100）を超える場合は 400 が返り、何も再インデックスされません。

Available options: true

documentIds · string<uuid>[] | null

再インデックスするドキュメントです。ドキュメント ID（ドキュメント一覧を取得 から取得）またはドキュメントファイル ID（ドキュメントファイル一覧を取得 から取得）で指定します。デプロイ環境によっては、より低い上限が設定されている場合があります。重複した ID は 1 つにまとめられるため、total が送信した数より小さくなることがあります。各 ID を 1 回ずつ送信すれば、items はリクエストと同じ順序で並びます。

Required array length: 1 - 100 elements

Response

202

application/json

インデックスタスクがキューに追加されました。

bulk_job_id · string

一括タスク ID です。一括タスクを取得 でポーリングします。

items · object[]

送信した重複のない ID ごとに 1 エントリが、リクエストの順序で並びます。all が true の場合は、その後に選択された各ファイルにつき 1 エントリが続きます。同じドキュメントファイルに解決される ID は、1 つのエントリを共有します。

Show child attributes

total · integer

items のエントリ数です。