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

# Reindex record group

`POST /knowledgeBase/reindex/record-group/{recordGroupId}`

Trigger reindexing for all records in a folder or knowledge base.

**Overview:**

Batch reindex operation for entire containers. The `recordGroupId` can be a folder ID or KB ID.

**Status filters:**

Optional `statusFilters` limit which child records are queued (e.g. failed-only or manual-indexing).

## Path parameters

- `recordGroupId` string, required

## Request body

- ReindexRecordGroupRequestBody — Optional body for record-group (folder/KB container) reindex.
  - `depth` integer — Depth of records under the record group to include.
  - `force` boolean — Force reindex for all matched records in the group.
  - `statusFilters` IndexingStatusFilter[] — When set, only records matching these indexing statuses are reindexed.

## Response `200`

Reindexing triggered for all records in group

- ReIndexRecordGroupResponseSchema — Response returned by POST /knowledgeBase/reindex/record-group/{recordGroupId}.
  - `success` true, required
  - `message` string, required
  - `recordGroupId` string, required
  - `depth` integer, required
  - `connector` string, nullable
  - `eventPublished` boolean, 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 group not found
- `409` — Conflict - the connector instance is disabled. Enable it from Connector Settings and try again.
- `500` — Internal server error while reindexing the record group
- `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)