---
title: "Reindex single record"
method: POST
path: "/knowledgeBase/reindex/record/{recordId}"
tags: ["Knowledge Base"]
---

# Reindex single record

`POST /knowledgeBase/reindex/record/{recordId}`

Trigger reindexing for a specific record.

**Overview:**

Reprocesses the record's content to update search indexes and AI embeddings. Useful after content changes or to fix indexing failures.

**Depth parameter:**

Controls processing depth for complex documents (`-1` for full depth, `0`–`100` for limited).

**Status filters:**

Optional `statusFilters` array limits reindex to records in matching indexing states
(e.g. `FAILED`, `AUTO_INDEX_OFF`).

## Path parameters

- `recordId` string, required

## Request body

- ReindexRecordRequestBody — Optional body for single-record reindex.
  - `depth` integer — Child traversal depth (`0` = record only; higher values include descendants; `100` is used by clients for folder-like reindex).
  - `force` boolean — Force reindex even when the connector considers the record unchanged.
  - `statusFilters` IndexingStatusFilter[] — When set, only records whose indexing status matches one of these values are reindexed (applies to the record and its descendants per `depth`).

## Response `200`

Reindexing triggered successfully

- ReIndexRecordResponseSchema — Response returned by POST /knowledgeBase/reindex/record/{recordId}.
  - `success` true, required
  - `message` string, required
  - `recordId` string, nullable
  - `recordName` string, nullable
  - `connector` string, nullable
  - `eventPublished` boolean, required
  - `userRole` string, nullable
  - `depth` integer, required

## Other responses

- `400` — Invalid request body or parameters
- `401` — Missing, invalid, expired, or revoked authentication
- `403` — OAuth token is missing the required kb:write scope
- `404` — Record not found
- `409` — Conflict — the connector instance for this record is disabled. Enable it from Connector Settings and try again.
- `500` — Internal server error while reindexing the record
- `503` — Connector service unavailable or connection refused

---

[API](https://skmtc.net/pipeshub-ai/apis/pipeshub-api.md) · [All operations](https://skmtc.net/pipeshub-ai/apis/pipeshub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipeshub-ai/pipeshub-api/versions/abd27cfefc73/schema)