---
title: "Delete record"
method: DELETE
path: "/knowledgeBase/record/{recordId}"
tags: ["Knowledge Base"]
---

# Delete record

`DELETE /knowledgeBase/record/{recordId}`

Permanently delete a record from the knowledge base.

**Required permission:**

WRITER or higher

**What gets deleted:**

- Record metadata
- Associated storage file
- Indexed content and embeddings

**Warning:** This action is irreversible.

## Path parameters

- `recordId` string, required

## Response `200`

Record deleted successfully

- DeleteRecordResponseSchema — Response returned by DELETE /knowledgeBase/record/{recordId}.
  - `success` true, required
  - `message` string, required
  - `recordId` string, required
  - `connector` string, nullable
  - `timestamp` integer, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Missing, invalid, expired, or revoked authentication
- `403` — OAuth token is missing the required kb:delete scope
- `404` — Record not found
- `500` — Internal server error while deleting 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)